---
title: Migrating to the hepgg package (LLM)
description: The standalone id, sms, logger, hepgg-secrets packages are retired; use the unified hepgg package.
---

# Migrating to the hepgg package

The standalone client packages are retired. Use the unified `hepgg` package
(subpath per module). Export shapes are unchanged; migration is a one-line import
change. Node 20+.

Mapping:
  id            -> hepgg/id        (deprecated)
  sms           -> hepgg/sms       (deprecated)
  logger        -> hepgg/logger    (deprecated; guide: https://docs.teamhydra.dev/docs/logger/getting-started)
  hepgg-secrets -> hepgg/secrets   (removed from the registry)

## Install

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

## Behaviour change

All clients throw a typed HepError on non-2xx (old `id` returned error JSON
silently; old `sms` threw an axios error). Successful results unchanged.

## id

  - from: import { ID } from "id";
  - to:   import { ID } from "hepgg/id";
  ID class, constructor, and the six original methods are identical. New:
  generateLicense(), generateCUID(), generate(), generateMany(), and
  timeoutMs/retries/fetch options. See /llms/idgen/sdk.

## sms

  - from: const { send } = require("sms");
  - to:   const { send } = require("hepgg/sms");
  Functional send(token, recipient, content) unchanged. New SMS class
  (send/list/stats) and webhook helpers (parseWebhook/verifyWebhook). Uses native
  fetch now; failed sends throw HepError. See /llms/sms/sdk.

## logger

  - from: const logger = require("logger");
  - to:   const logger = require("hepgg/logger");
  Same singleton and methods; restyled output, new levels (trace/success/warn/
  fatal) with warning/severe/log aliases, scopes, createLogger. Guide:
  https://docs.teamhydra.dev/docs/logger/getting-started

## hepgg-secrets

  - from: import { config } from "hepgg-secrets";
  - to:   import { config } from "hepgg/secrets";
  Same config/get/all API, encrypted last-good cache, E2EE. The standalone
  package is removed from the registry. See /llms/secrets/sdk.