@claudiocc2/oauth2-client 2.0.0 → 2.0.2

package/index.d.ts

@@ -0,0 +1,177 @@
+// Type definitions for @tuempresa/oauth2-client
+// Updated with Zanzibar and Webhooks support
+
+export interface OAuth2Config {
+  clientId: string;
+  authServerUrl: string;
+  redirectUri: string;
+  scopes?: string[];
+  usePKCE?: boolean;
+}
+
+export interface AuthorizeOptions {
+  state?: string;
+}
+
+export interface CallbackResult {
+  code: string;
+  state: string;
+}
+
+export interface TokenResponse {
+  access_token: string;
+  refresh_token?: string;
+  expires_in: number;
+  token_type: string;
+  scope?: string;
+}
+
+export interface IntrospectResponse {
+  active: boolean;
+  user_id?: string;
+  username?: string;
+  client_id?: string;
+  scope?: string;
+  exp?: number;
+}
+
+// =====================================================
+// ZANZIBAR (PERMISOS)
+// =====================================================
+
+export interface PermissionCheck {
+  namespace: string;
+  object_id: string;
+  permission: string;
+  subject_type: string;
+  subject_id: string;
+}
+
+export interface PermissionRelation {
+  namespace: string;
+  object_id: string;
+  relation: string;
+  subject_type: string;
+  subject_id: string;
+}
+
+export interface Permission {
+  object_id: string;
+  permission: string;
+}
+
+// =====================================================
+// WEBHOOKS
+// =====================================================
+
+export interface CreateWebhookRequest {
+  name: string;
+  url: string;
+  events: string[];
+  headers?: Record<string, string>;
+}
+
+export interface Webhook {
+  id: string;
+  user_id: string;
+  name: string;
+  url: string;
+  events: string[];
+  active: boolean;
+  headers?: Record<string, string>;
+  created_at: string;
+  updated_at: string;
+  last_trigger?: string;
+}
+
+export interface WebhookDelivery {
+  id: string;
+  webhook_id: string;
+  event: string;
+  status_code: number;
+  success: boolean;
+  attempt: number;
+  max_attempts: number;
+  next_retry_at?: string;
+  error?: string;
+  duration: number;
+  created_at: string;
+}
+
+export interface ListWebhooksResponse {
+  webhooks: Webhook[];
+  total: number;
+  limit: number;
+  offset: number;
+}
+
+export interface ListDeliveriesResponse {
+  deliveries: WebhookDelivery[];
+  total: number;
+  limit: number;
+  offset: number;
+}
+
+// =====================================================
+// PASSWORD MANAGEMENT
+// =====================================================
+
+export interface ChangeUsernameResponse {
+  message: string;
+  old_username: string;
+  new_username: string;
+}
+
+// =====================================================
+// MAIN CLASS
+// =====================================================
+
+export default class OAuth2Client {
+  constructor(config: OAuth2Config);
+
+  // OAuth2 + PKCE
+  authorize(options?: AuthorizeOptions): Promise<void>;
+  handleCallback(callbackUrl?: string): CallbackResult | null;
+  exchangeCode(code: string): Promise<TokenResponse>;
+  handleCallbackAndExchange(): Promise<TokenResponse>;
+
+  // Token Management
+  getAccessToken(): string | null;
+  getRefreshToken(): string | null;
+  isTokenExpired(): boolean;
+  isAuthenticated(): boolean;
+  refreshToken(): Promise<TokenResponse>;
+  getValidToken(): Promise<string>;
+  logout(): void;
+
+  // HTTP Client
+  fetch(url: string, options?: RequestInit): Promise<Response>;
+
+  // Introspection
+  introspectToken(token: string): Promise<IntrospectResponse>;
+  isTokenValid(token: string): Promise<boolean>;
+
+  // Zanzibar (Permisos)
+  checkPermission(check: PermissionCheck): Promise<boolean>;
+  checkPermissions(checks: PermissionCheck[]): Promise<Array<{ allowed: boolean }>>;
+  grantPermission(relation: PermissionRelation): Promise<boolean>;
+  revokePermission(relation: PermissionRelation): Promise<boolean>;
+  listPermissions(namespace: string, subjectId: string): Promise<Permission[]>;
+
+  // Webhooks
+  createWebhook(webhook: CreateWebhookRequest): Promise<{ webhook: Webhook; secret: string }>;
+  listWebhooks(limit?: number, offset?: number): Promise<ListWebhooksResponse>;
+  getWebhook(webhookId: string): Promise<Webhook>;
+  updateWebhook(webhookId: string, data: Partial<CreateWebhookRequest>): Promise<{ message: string }>;
+  deleteWebhook(webhookId: string): Promise<boolean>;
+  listWebhookDeliveries(webhookId: string, limit?: number, offset?: number): Promise<ListDeliveriesResponse>;
+  testWebhook(webhookId: string): Promise<boolean>;
+  verifyWebhookSignature(payload: string, signature: string, secret: string): Promise<boolean>;
+  listWebhookEvents(): Promise<string[]>;
+
+  // Password Management
+  forgotPassword(email: string): Promise<boolean>;
+  resetPassword(token: string, newPassword: string): Promise<boolean>;
+  changePassword(currentPassword: string, newPassword: string): Promise<boolean>;
+  changeUsername(newUsername: string, password: string): Promise<ChangeUsernameResponse>;
+}