JavaScript / TypeScript

Node.js 20+ or modern browsers via WebCrypto. No native dependencies.

Install

npm install https://geckoguard.net/downloads/sdk/v1.3.0/geckoguard-sdk-1.3.0.tgz

This pins the reviewed historical v1.3.0 preview artifact. The first official coordinated release is planned as v1.0.0 and remains on hold.

Quick start

import { GeckoGuardClient, LicenseDeniedError } from '@geckoguard/sdk';

const gecko = new GeckoGuardClient({
  apiKey: 'gg_live_...',
  productId: 'your-product-uuid',
  signingSecret: 'your-signing-secret',
});

try {
  const auth = await gecko.authorize('LICENSE-KEY-123');
  console.log('Allowed:', auth.allow);
} catch (err) {
  if (err instanceof LicenseDeniedError) {
    console.error('Denied:', err.errorCode);
    throw err;
  }
  throw err;
}

Configuration

new GeckoGuardClient({
  apiKey: 'gg_live_...',
  productId: 'your-product-uuid',
  baseUrl: 'https://api.geckoguard.net', // default
  signingSecret: '...',                  // enable HMAC request signing
  timeoutMs: 15_000,
});

For the full method list and endpoint reference, see the API Reference.

For long-running applications, follow the session lifecycle and heartbeat requirements.