snowtransfer

library0.17.7jsnpmunverified

Minimalistic REST client for the Discord API (v0.17.7). Focused solely on HTTP endpoints with no gateway or cache assumptions. Supports Bot and Bearer tokens, full API coverage. Requires Node >=22.0.0. Active development, weekly releases. Differentiator: microservice-friendly, no other components needed.

messaging

npm install snowtransfer

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SNOWTRANSFER

snowtransfer

messagingjavascriptv0.17.7

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SnowTransfer

✓ import { SnowTransfer } from 'snowtransfer'

✗ const SnowTransfer = require('snowtransfer')

Package ships TypeScript types; ESM imports recommended. Default export is not available, must use named import.

SnowTransfer (CommonJS)

✓ const { SnowTransfer } = require('snowtransfer')

✗ const snowtransfer = require('snowtransfer')

CommonJS destructuring required. Direct require returns an object with SnowTransfer property.

DiscordAPIError

✓ import { DiscordAPIError } from 'snowtransfer'

✗ const DiscordAPIError = require('snowtransfer').DiscordAPIError

Named export for error handling. Available in both ESM and CJS.

Shows basic usage with ESM import, environment variable for token, and creating a channel message.

import { SnowTransfer } from 'snowtransfer'; const client = new SnowTransfer(process.env.DISCORD_BOT_TOKEN ?? ''); async function sendMessage(channelId: string, content: string) { try { const message = await client.channel.createMessage(channelId, content); console.log('Message sent:', message.id); } catch (err) { console.error('Failed to send message:', err); } } sendMessage('123456789012345678', 'Hello from SnowTransfer!');

Debug

Known issues

breakingNode.js version requirement >=22.0.0. Older versions will fail with syntax errors or missing APIs.

fix

Upgrade Node.js to version 22 or higher.

affects: <0.1.0

breakingMinimum Node.js version changed from 14 to 22 in a recent major release.

fix

Use Node.js 22+ or pin to an older version (0.16.x) if using older Node.

affects: >=0.17.0

deprecatedThe default export SnowTransfer was removed in v0.17. Use named export { SnowTransfer }.

fix

Change import/require to use named export: import { SnowTransfer } from 'snowtransfer'

affects: >=0.17.0

gotchaBearer tokens have very limited access compared to Bot tokens. Most endpoints require Bot token.

fix

Use a Bot token for full API coverage.

affects: >=0.1.0

gotchaThe library does not handle rate limiting automatically. You must respect rate limits yourself.

fix

Implement your own rate limiting or use a wrapper that adds it.

affects: >=0.1.0

Errors

Common errors & fixes

TypeError: SnowTransfer is not a constructor

Importing default export instead of named export after v0.17.

fix

Use `import { SnowTransfer } from 'snowtransfer'` (named import).

Error [ERR_REQUIRE_ESM]: require() of ES Module not supported

Modern versions of snowtransfer are ESM-only and cannot be required directly in CommonJS.

fix

Use dynamic import: `const { SnowTransfer } = await import('snowtransfer')`

DiscordAPIError: 401: Unauthorized

Invalid or missing bot token, or using Bearer token for bot-only endpoint.

fix

Ensure token is correct and is a Bot token (prefixed with 'Bot').

SyntaxError: Unexpected token '??='

Node.js version older than 22, which doesn't support nullish coalescing assignment.

fix

Upgrade Node.js to version 22 or higher.

Upgrade

Version history

0.17.7latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

23 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/DasWolke/SnowTransfer ↗

packagesnowtransfer ↗

homepagehttps://github.com/DasWolke/SnowTransfer#readme ↗