v2.0

Announcing Spice.js v2.0! 🎉

The v2.0 release adds full support for Spice OSS and now connects to localhost by default instead of the Spice Cloud service.

Follow the Spice OSS quickstart to install and run the spice runtime locally, and query data using the Spice.js SDK:

import { SpiceClient } from '@spiceai/spice';

const main = async () => {
  const spiceClient = new SpiceClient();

  const table = await spiceClient.query(
    'SELECT trip_distance, total_amount FROM taxi_trips ORDER BY trip_distance DESC LIMIT 10;'
  );

  console.table(table.toArray());
};

main();

Read the docs to learn more.

Breaking Changes

• Asset Prices is now deprecated and the Prices() method and types were removed. Asset prices data can continue to be fetched using HTTP clients directly from the Spice cloud service.
• The SDK now connects to localhost by default (API Key is now optional).

What's Changed

• Fix samples in README.md by @sgrebnov in #145
• Remove deprecated Asset Prices API support by @lukekim in #149
• Bump apache-arrow from 14.0.2 to 15.0.2 by @dependabot in #143
• Bump ts-jest from 29.1.1 to 29.1.2 by @dependabot in #131
• Refactor SpiceClient to support connection to local spice runtime by @ewgenius in #151
• Version 2.0.0 by @ewgenius in #152
• Fix missing default params by @ewgenius in #153
• Update dependencies by @ewgenius in #154

Full Changelog: v1.0.2...v2.0.0

Release v1.0.2

What's Changed

• Don't retry if RESOURCE_EXHAUSTED or CANCELLED error received by @sgrebnov in #124

Full Changelog: v1.0.1...v1.0.2

Release v1.0.1

Starting from v1.0.1 the SDK implements 3 retry attempts when using Apache Arrow Flight API. This could be configured or disabled using setMaxRetries:

const spiceClient = new SpiceClient('API_KEY');
spiceClient.setMaxRetries(5); // Setting to 0 will disable retries

What's Changed

• Add app level retry logic for flight requests by @sgrebnov in #120
• Bump dependencies by @sgrebnov in #122
• Version 1.0.1 by @sgrebnov in #123

New Contributors

• @sgrebnov made their first contribution in #120

Full Changelog: v1.0.0...v1.0.1

v1.0.0

Announcing spice.js v1.0.0! 🎉

Spice.ai is now generally available! Read the announcement blog post to see how Spice helps developers to build high-performance, highly-available, data and AI-driven applications.

spice.js is the easiest way to query data in Javascript/Typescript from Spice.ai over a high-performance Apache Arrow connection.

Get started in 3 steps:

1. Sign up for a free API key at Spice.ai
2. Download spice.js with npm install @spiceai/spice
3. Import spice.js, create a client and start querying Spice's built-in live-updating web3 data:

import { SpiceClient } from '@spiceai/spice';
const spiceClient = new SpiceClient('API_KEY');
const table = await spiceClient.query(
  'SELECT number, "timestamp", gas_used FROM eth.recent_blocks LIMIT 10'
);
console.table(table.toArray());

Explore over 100+ built-in, real-time web3 datasets available in Spice.ai!

Have questions or feedback? Contact us

What's Changed

• Basic v1 price functions by @Jeadie in #91
• Make client accept URLs for flight and HTTP endpoints by @Jeadie in #93
• Get spice.js ready for v1 by @Jeadie in #94
• New URLs for v1 prices by @Jeadie in #96
• spice.xyz -> spice.ai by @Jeadie in #101
• Bump jest and @types/jest by @dependabot in #87
• Jack/dependabot by @Jeadie in #102
• Release v1 by @Jeadie in #100

New Contributors

• @Jeadie made their first contribution in #91

Full Changelog: v0.5.1...v1.0.0

v0.5.1

Spice.xyz Node.js SDK v0.5.1

What's Changed

• fix: handle proto loading in next.js app router by @ewgenius in #86

  spice client was failing to load proto files, when used in next.js app router because of relative path in __dirname

• Bump @grpc/grpc-js from 1.8.14 to 1.8.21 by @dependabot in #85

• Bump protobufjs from 7.2.3 to 7.2.4 by @dependabot in #81

• Bump typescript from 5.0.4 to 5.1.6 by @dependabot in #80

• Bump semver from 5.7.1 to 5.7.2 by @dependabot in #82

Full Changelog: v0.5.0...v0.5.1

v0.5.0

For full documentation see docs.spice.xyz.

What's Changed

• Add Node.js 20 to test matrix by @lukekim in #72
• Upgrade to Node.js 18 LTS as minimum supported version by @lukekim in #73
• Bump apache-arrow from 11.0.0 to 12.0.1 by @dependabot in #66
• Use https keep-alive agent by @lukekim in #74
• Bump rimraf from 4.4.1 to 5.0.1 by @dependabot in #63

Full Changelog: v0.4.0...v0.5.0

v0.4.0

What's Changed

• Bump @grpc/proto-loader from 0.7.6 to 0.7.7 by @dependabot in #58
• Add new function and tests for getMultiplePrices() by @Sevenannn in #71

New Contributors

• @Sevenannn made their first contribution in #71

Full Changelog: v0.3.3...v0.4.0

v0.3.3

Spice.xyz Node.js SDK v0.3.3

For full documentation see docs.spice.xyz.

What's Changed

• Fix: remove extra slashes in api endpoint @ewgenius in #69

Full Changelog: v0.3.2...v0.3.3

v0.3.2

Spice.xyz Node.js SDK v0.3.2

This release uses node-fetch to be compatible with Node 16 and upgrades gprc dependencies.

For full documentation see docs.spice.xyz.

What's Changed

• Add Node 16 to build matrix by @lukekim in #53
• Bump @grpc/grpc-js from 1.8.12 to 1.8.14 by @dependabot in #51
• Upgrade dependencies and rev version to 0.3.2 by @lukekim in #55

Full Changelog: v0.3.1...v0.3.2

v0.3.1

Spice.xyz Node.js SDK v0.3.1

This release reverts the change to require Node.js 18+ back to Node.js 16.

For full documentation see docs.spice.xyz.

What's Changed

• Revert upgrade to Node 18 (Node 16 min requirement) by @lukekim in #37
• Upgrade typescript, jest, ws, and rimraf. by @lukekim in #43

Full Changelog: v0.3.0...v0.3.1