pnpm add @fatturazione-elettronica-aruba/core

import { ArubaClient } from '@fatturazione-elettronica-aruba/core';

const client = new ArubaClient({
  environment: 'production',
  timeout: 30000,
  maxRetries: 3,
});

// Check if client is authenticated
client.isAuthenticated(): boolean

const token = await client.auth.signIn('user@example.com', 'password');
// Token is automatically stored and used for subsequent requests

const newToken = await client.auth.refresh();
// Or with explicit refresh token
const newToken = await client.auth.refresh('refresh_token_value');

const info = await client.auth.getUserInfo();
console.log(info.vatCode);      // VAT number
console.log(info.fiscalCode);   // Fiscal code
console.log(info.accountStatus.expired); // Account status
console.log(info.usageStatus.usedSpaceKB); // Used storage

const result = await client.auth.getMulticedenti({
  page: 0,
  size: 20,
  status: 'ACTIVE',
});

for (const company of result.content) {
  console.log(company.vatCode, company.description);
}

if (client.auth.isAuthenticated()) {
  // Token is available
}

const http = client.http;

// GET request
const data = await http.get<ResponseType>('ws', '/api/v2/endpoint', { param: 'value' });

// POST request
const result = await http.post<ResponseType>('ws', '/api/v2/endpoint', { body: 'data' });

// GET with query parameters
http.get<T>(baseType: 'auth' | 'ws', path: string, params?: object, options?: RequestOptions): Promise<T>

// POST with JSON body
http.post<T>(baseType: 'auth' | 'ws', path: string, body?: unknown, options?: RequestOptions): Promise<T>

// POST with form data
http.postForm<T>(baseType: 'auth' | 'ws', path: string, data: Record<string, string>, options?: RequestOptions): Promise<T>

// Token management
http.setAccessToken(token: string | null): void
http.getAccessToken(): string | null

interface TokenStorage {
  getToken(): AuthToken | null;
  setToken(token: AuthToken): void;
  clearToken(): void;
}

import { MemoryTokenStorage } from '@fatturazione-elettronica-aruba/core';

const storage = new MemoryTokenStorage();

class RedisTokenStorage implements TokenStorage {
  constructor(private redis: RedisClient, private key: string) {}

  getToken(): AuthToken | null {
    const data = this.redis.get(this.key);
    return data ? JSON.parse(data) : null;
  }

  setToken(token: AuthToken): void {
    this.redis.set(this.key, JSON.stringify(token));
  }

  clearToken(): void {
    this.redis.del(this.key);
  }
}

const client = new ArubaClient({
  environment: 'production',
  tokenStorage: new RedisTokenStorage(redis, 'aruba:token'),
});

type Environment = 'demo' | 'production';

interface AuthToken {
  access_token: string;
  token_type: 'bearer';
  expires_in: number;       // Seconds (typically 1800 = 30 min)
  refresh_token: string;
  userName: string;
  'as:client_id': string;
  '.issued': string;
  '.expires': string;
}

interface UserInfo {
  username: string;
  pec: string;
  userDescription: string;
  countryCode: string;
  vatCode: string;
  fiscalCode: string;
  accountStatus: AccountStatus;
  usageStatus: UsageStatus;
}

interface AccountStatus {
  expired: boolean;
  expirationDate: string;
}

interface UsageStatus {
  usedSpaceKB: number;
  maxSpaceKB: number;
}

interface Multicedente {
  id: string;
  description: string;
  countryCode: string;
  vatCode: string;
  usedSpaceKB: number;
  creationDate: string;
  status: MulticedenteStatus;
}

type MulticedenteStatus =
  | 'ACTIVE'
  | 'INACTIVE'
  | 'PENDING'
  | 'REQUESTED_FOR_ACTIVATION'
  | 'REQUESTED_FOR_DEACTIVATION';

interface PagedResponse<T> {
  content: T[];
  totalElements: number;
  totalPages: number;
  size: number;
  number: number;  // Current page (0-indexed)
}

import { ENVIRONMENT_URLS } from '@fatturazione-elettronica-aruba/core';

ENVIRONMENT_URLS.demo.authUrl    // 'https://demoauth.fatturazioneelettronica.aruba.it'
ENVIRONMENT_URLS.demo.wsUrl      // 'https://demows.fatturazioneelettronica.aruba.it'
ENVIRONMENT_URLS.production.authUrl // 'https://auth.fatturazioneelettronica.aruba.it'
ENVIRONMENT_URLS.production.wsUrl   // 'https://ws.fatturazioneelettronica.aruba.it'

import { RATE_LIMITS } from '@fatturazione-elettronica-aruba/core';

RATE_LIMITS.auth    // 1 request/minute
RATE_LIMITS.upload  // 30 requests/minute
RATE_LIMITS.search  // 12 requests/minute

import { FILE_LIMITS } from '@fatturazione-elettronica-aruba/core';

FILE_LIMITS.maxFileSize  // 5242880 (5 MB)

import { ARUBA_CONSTANTS } from '@fatturazione-elettronica-aruba/core';

ARUBA_CONSTANTS.codiceDestinatario  // 'KRRH6B9'
ARUBA_CONSTANTS.idTrasmittente      // 'IT01879020517'

import {
  ARUBA_ID_TRASMITTENTE,     // '01879020517'
  ARUBA_CODICE_DESTINATARIO, // 'KRRH6B9'
  ARUBA_COUNTRY_CODE,        // 'IT'
} from '@fatturazione-elettronica-aruba/core';