wilddog

library2.5.17jsnpmunverified

Wilddog Realtime SDK is a real-time data synchronization library for web and mobile applications, similar to Firebase Realtime Database. Version 2.5.17 is the latest stable release, with infrequent updates. It provides real-time WebSocket-based communication, offline support, and data security rules. Compared to Firebase, it offers localized service for the Chinese market. The library includes TypeScript type definitions for better developer experience.

database

npm install wilddog

package ↗

INSTALL

IMPORT

SIG · WILDDOG

wilddog

databasejavascriptv2.5.17

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.

wilddog

✓ import wilddog from 'wilddog'

✗ const wilddog = require('wilddog')

The library exports a default object. ESM import is preferred; CJS require also works but may lack TypeScript types in some environments.

auth

✓ import wilddog from 'wilddog'; wilddog.auth()

✗ import { auth } from 'wilddog'

auth is a method on the default export, not a named export.

database

✓ import wilddog from 'wilddog'; const database = wilddog.database()

✗ import { database } from 'wilddog'

database() is a function on the default export.

Initializes the Wilddog app, connects to the realtime database, listens for value events, and pushes new data.

import wilddog from 'wilddog'; const config = { syncURL: 'https://your-app.wilddogio.com', authDomain: 'your-app.wilddog.com' }; wilddog.initializeApp(config); const ref = wilddog.database().ref('messages'); ref.on('value', (snapshot) => { console.log('Data:', snapshot.val()); }); ref.push({ user: 'alice', message: 'Hello from Wilddog!' });

Debug

Known issues

gotchaWilddog SDK uses wilddogio.com as default database URL, but recent updates may require custom domains. Always check the latest documentation.

fix

Use the correct syncURL from your Wilddog console (usually ends with .wilddogio.com).

affects: >=2.5

gotchaCalling wilddog.initializeApp() multiple times will cause the app to overwrite previously initialized instances. Only call once per app.

fix

Check if app is already initialized before calling initializeApp, or use wilddog.app() to get the existing instance.

affects: >=2.0

deprecatedSome older methods like wilddog.auth().signInWithEmailAndPassword are deprecated in favor of newer auth methods. Check current docs.

fix

Use the recommended auth methods from the latest Wilddog authentication guide.

affects: 2.5.x

gotchaThe SDK does not support tree-shaking; importing the entire library increases bundle size. No individual module imports available.

fix

Accept full import or consider using alternative solutions if bundle size is critical.

affects: >=1.0

Errors

Common errors & fixes

Error: Wilddog: Must initialize app with a valid config.

initializeApp was not called before using Wilddog services.

fix

Call wilddog.initializeApp(config) with a valid configuration object.

Error: Reference.push failed: First argument must be an object.

Attempted to push non-object data (e.g., string, number).

fix

Wrap primitive data in an object: ref.push({ value: data })

Error: permission_denied at /messages: Client doesn't have permission to access the desired data.

Security rules on the database reject the operation.

fix

Update database security rules to allow read/write from the client, or authenticate properly.

TypeError: wildgod.database is not a function

Typo in package name: installed 'wildgod' instead of 'wilddog'.

fix

npm uninstall wildgod && npm install wilddog

Upgrade

Version history

2.5.17latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

38 hits · last 30 days

node

OpenAI (training)

Resources

packagewilddog ↗