signet-auth 1.0.0-beta.0

package/src/utils/duration.ts

@@ -0,0 +1,34 @@
+/**
+ * Parse human-readable duration strings into milliseconds.
+ * Supports: "30s", "5m", "24h", "7d"
+ */
+export function parseDuration(input: string): number {
+  const match = input.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/i);
+  if (!match) {
+    throw new Error(`Invalid duration format: "${input}". Expected format like "30s", "5m", "24h", "7d".`);
+  }
+
+  const value = parseFloat(match[1]);
+  const unit = match[2].toLowerCase();
+
+  const multipliers: Record<string, number> = {
+    ms: 1,
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+  };
+
+  return value * multipliers[unit];
+}
+
+/**
+ * Format milliseconds into a human-readable duration.
+ */
+export function formatDuration(ms: number): string {
+  if (ms < 1_000) return `${ms}ms`;
+  if (ms < 60_000) return `${Math.round(ms / 1_000)}s`;
+  if (ms < 3_600_000) return `${Math.round(ms / 60_000)}m`;
+  if (ms < 86_400_000) return `${(ms / 3_600_000).toFixed(1)}h`;
+  return `${(ms / 86_400_000).toFixed(1)}d`;
+}

package/src/utils/http.ts

@@ -0,0 +1,11 @@
+import os from 'node:os';
+
+/**
+ * Build a User-Agent string identifying signet.
+ */
+export function buildUserAgent(): string {
+  const platform = os.platform();
+  const arch = os.arch();
+  const nodeVersion = process.version;
+  return `signet/1.0.0 (${platform}; ${arch}) Node/${nodeVersion}`;
+}

package/src/utils/jwt.ts

@@ -0,0 +1,39 @@
+/**
+ * Lightweight JWT decode without signature verification.
+ * Used for reading token expiry and audience — NOT for security validation.
+ */
+
+export interface JwtPayload {
+  exp?: number;       // Expiration time (Unix timestamp)
+  iat?: number;       // Issued at
+  aud?: string | string[];  // Audience
+  iss?: string;       // Issuer
+  sub?: string;       // Subject
+  [key: string]: unknown;
+}
+
+export function decodeJwt(token: string): JwtPayload | null {
+  try {
+    const parts = token.split('.');
+    if (parts.length !== 3) return null;
+
+    const payload = parts[1];
+    const decoded = Buffer.from(payload, 'base64url').toString('utf-8');
+    return JSON.parse(decoded) as JwtPayload;
+  } catch {
+    return null;
+  }
+}
+
+export function isJwtExpired(token: string, bufferMs: number = 0): boolean {
+  const payload = decodeJwt(token);
+  if (!payload?.exp) return false; // No expiry = assume valid
+  const expiresAtMs = payload.exp * 1000;
+  return Date.now() + bufferMs >= expiresAtMs;
+}
+
+export function getJwtExpiresAt(token: string): Date | null {
+  const payload = decodeJwt(token);
+  if (!payload?.exp) return null;
+  return new Date(payload.exp * 1000);
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "declaration": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}