Migrating To The hepgg Package

The standalone id, sms, logger, and hepgg-secrets packages are retired. Install the unified hepgg package and change one import per module.

Migrating To The hepgg Package#

The separately published client packages are retired. Everything now lives in one modular, fully typed package: hepgg. Install it once and import each module from its subpath. The export shapes are the same, so most migrations are a one-line change to the import.

Install#

The package is on the Hep.gg registry, so point npm at it once.

npm install hepgg --registry https://npm.hep.gg

echo 'registry=https://npm.hep.gg' >> .npmrc
npm install hepgg

Node 20 or newer. No other dependencies.

Migrating from id#

Change the import. The ID class, its constructor, and the original six methods are identical.

- import { ID } from "id";
+ import { ID } from "hepgg/id";

import { ID } from "hepgg/id";
 
const id = new ID({ username: "my-bot", token: process.env.ID_TOKEN });
await id.generateUUID(); // unchanged

You also gain generateLicense(), generateCUID(), the low-level generate() / generateMany(), and constructor options (timeoutMs, retries, fetch). Full details on the ID Generator SDK page.

Migrating from sms#

The functional send(token, recipient, content) is kept exactly, so the smallest migration is just the import.

- const { send } = require("sms");
+ const { send } = require("hepgg/sms");

import { send, SMS } from "hepgg/sms";
 
await send(process.env.SMS_KEY, "+447700900000", "Hello"); // unchanged
 
// New: a class with list() and stats(), plus webhook helpers.
const sms = new SMS({ token: process.env.SMS_KEY });
const inbox = await sms.list();

The old package used axios; the new one uses native fetch, so a failed send now throws a HepError instead of an axios error. Full details on the SMS SDK page.

Migrating from logger#

The logger moved into hepgg/logger and got a visual overhaul, new levels, and scopes, while keeping every old method. Because it is a Team Hydra tool used across services and bots, its full migration guide and reference live on the Team Hydra docs.

- const logger = require("logger");
+ const logger = require("hepgg/logger");

See The Logger on Team Hydra docs for the complete guide.

Migrating from hepgg-secrets#

The standalone hepgg-secrets package has been removed from the registry. The same one-shot, dotenv-style injector now ships as hepgg/secrets with the same API (config / get / all), the encrypted last-good cache, and end-to-end encryption.

- import { config } from "hepgg-secrets";
+ import { config } from "hepgg/secrets";

Full details on the Secrets SDK page.