HiveForge SDK

HIVEFORGE_DEPLOYMENT_ID=d9f2a1b4-7c3e-4f8a-b5d6-1e2f3a4b5c6d
HIVEFORGE_DEPLOYMENT_SECRET=sk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
HIVEFORGE_API_URL=https://api.hiveforge.dev/api/v1   # Optional, this is the default

import { HiveForgeClient } from '@producthacker/hiveforge-sdk';
 
const hiveforge = new HiveForgeClient({
  deploymentId: process.env.HIVEFORGE_DEPLOYMENT_ID!,
  deploymentSecret: process.env.HIVEFORGE_DEPLOYMENT_SECRET!,
  apiUrl: process.env.HIVEFORGE_API_URL,  // optional
  debug: false,                            // optional, enables console logging
});
 
// Must be called before using any features
await hiveforge.initialize();

import { createHiveForgeClient } from '@producthacker/hiveforge-sdk';
 
// Reads HIVEFORGE_DEPLOYMENT_ID and HIVEFORGE_DEPLOYMENT_SECRET from env
const hiveforge = createHiveForgeClient({
  debug: process.env.NODE_ENV === 'development',
});
 
await hiveforge.initialize();

if (hiveforge.isEnabled('ai_enabled')) {
  // AI features are available
}
 
if (hiveforge.isEnabled('billing_enabled')) {
  // Billing features are available
}

const status = hiveforge.getStatus();
// 'active' | 'trialing' | 'past_due' | 'grace_period' | 'suspended' | 'canceled'

const tier = hiveforge.getTier();
// 'sandbox' | 'trial' | 'launch' | 'growth' | 'enterprise'

const message = hiveforge.getMessage();
// "Trial expires in 3 days" or null

const entitlements = hiveforge.getEntitlements();
if (entitlements) {
  console.log(entitlements.tier);
  console.log(entitlements.features.ai_monthly_limit);
  console.log(entitlements.quotas);
}

const aiQuota = hiveforge.getQuota('ai_tokens');
if (aiQuota) {
  console.log(`Used: ${aiQuota.used}, Limit: ${aiQuota.limit}, Remaining: ${aiQuota.remaining}`);
}

if (hiveforge.isSuspended()) {
  // Show suspension UI
}

if (hiveforge.isInGracePeriod()) {
  // Show grace period warning banner
}

const entitlements = await hiveforge.refreshEntitlements();

hiveforge.shutdown();

// Entitlements refreshed
const unsub1 = hiveforge.on('entitlements:updated', (entitlements) => {
  console.log('Tier:', entitlements.tier);
  console.log('Status:', entitlements.status);
});
 
// Subscription status changed
const unsub2 = hiveforge.on('status:changed', ({ previous, current }) => {
  console.log(`Status changed: ${previous} -> ${current}`);
});
 
// Quota approaching limit (80% threshold)
const unsub3 = hiveforge.on('quota:warning', ({ resource, used, limit }) => {
  console.warn(`${resource} at ${Math.round((used / limit) * 100)}% usage`);
});
 
// Quota exceeded
const unsub4 = hiveforge.on('quota:exceeded', ({ resource, used, limit }) => {
  console.error(`${resource} quota exceeded: ${used}/${limit}`);
});
 
// Entitlement refresh failed
const unsub5 = hiveforge.on('entitlements:error', (error) => {
  console.error('Failed to refresh entitlements:', error.message);
});
 
// Unsubscribe when done
unsub1();
unsub2();

import type {
  HiveForgeConfig,
  Entitlements,
  SubscriptionStatus,
  FeatureFlags,
  QuotaInfo,
  ChatMessage,
  AICompletionOptions,
  AICompletionResponse,
  AIStreamOptions,
  AIStreamChunk,
  AIEmbeddingOptions,
  AIEmbeddingResponse,
  AIQuotaResponse,
  CheckoutOptions,
  CheckoutResponse,
  PortalOptions,
  PortalResponse,
  HiveForgeEvent,
  HiveForgeEventData,
  HiveForgeEventHandler,
} from '@producthacker/hiveforge-sdk';

// lib/hiveforge.ts
import { HiveForgeClient } from '@producthacker/hiveforge-sdk';
 
export const hiveforge = new HiveForgeClient({
  deploymentId: process.env.HIVEFORGE_DEPLOYMENT_ID!,
  deploymentSecret: process.env.HIVEFORGE_DEPLOYMENT_SECRET!,
});
 
// Initialize once on server start
if (typeof window === 'undefined') {
  hiveforge.initialize().catch(console.error);
}

// pages/api/ai.ts (or app/api/ai/route.ts)
import { hiveforge } from '@/lib/hiveforge';
 
export default async function handler(req, res) {
  const { message } = req.body;
 
  const response = await hiveforge.ai.complete({
    messages: [{ role: 'user', content: message }],
  });
 
  res.json({ content: response.content });
}