@oneidentity/safeguard 8.0.1 → 8.0.2

package/dist/events-zHsrmRBj.d.cts

@@ -1,185 +0,0 @@
-import { HubConnection } from "@microsoft/signalr";
-
-//#region src/events/types.d.ts
-/**
- * Event listener connection states.
- */
-type EventListenerState = 'starting' | 'connected' | 'disconnected' | 'reconnecting' | 'stopped';
-/**
- * Handler for Safeguard events (NotifyEventAsync messages from SignalR).
- */
-type EventHandler = (event: SafeguardEvent) => void;
-/**
- * Handler for state change notifications.
- */
-type StateChangeHandler = (state: EventListenerState) => void;
-/**
- * A Safeguard event as delivered by SignalR.
- */
-interface SafeguardEvent {
-  EventName: string;
-  [key: string]: unknown;
-}
-/**
- * Options for persistent event listeners.
- */
-interface PersistentListenerOptions {
-  /** Delay between reconnection attempts in milliseconds. Default: 5000. */
-  retryIntervalMs?: number;
-  /** Maximum number of reconnect attempts before giving up. Default: unlimited. */
-  maxRetries?: number;
-}
-//# sourceMappingURL=types.d.ts.map
-//#endregion
-//#region src/events/listener.d.ts
-/**
- * One-shot event listener wrapping a SignalR HubConnection.
- * For persistent auto-reconnect behavior, use PersistentSafeguardEventListener.
- */
-declare class SafeguardEventListener {
-  #private;
-  constructor(connection: HubConnection);
-  /** Current connection state. */
-  get state(): EventListenerState;
-  /**
-   * Register an event handler for Safeguard notifications.
-   */
-  on(_method: 'NotifyEventAsync', handler: EventHandler): this;
-  /**
-   * Start the SignalR connection.
-   */
-  start(): Promise<void>;
-  /**
-   * Stop the SignalR connection.
-   */
-  stop(): Promise<void>;
-}
-//# sourceMappingURL=listener.d.ts.map
-//#endregion
-//#region src/http/types.d.ts
-/**
- * Platform-agnostic HTTP client interface for the Safeguard SDK.
- */
-interface HttpRequestOptions {
-  url: string;
-  method: string;
-  headers?: Record<string, string>;
-  body?: string | Buffer | null;
-  signal?: AbortSignal;
-  timeout?: number;
-}
-interface HttpResponse {
-  status: number;
-  headers: Record<string, string>;
-  body: string;
-}
-/**
- * Abstract HTTP client interface.
- * Implementations: NodeHttpClient (undici), BrowserHttpClient (fetch).
- */
-interface HttpClient {
-  request(options: HttpRequestOptions): Promise<HttpResponse>;
-  dispose?(): void;
-}
-//# sourceMappingURL=types.d.ts.map
-//#endregion
-//#region src/storage/types.d.ts
-/**
- * Interface for token/state storage backends.
- */
-interface StorageProvider {
-  get(key: string): string | null;
-  set(key: string, value: string): void;
-  remove(key: string): void;
-  clear(): void;
-}
-/** Well-known storage keys used by the SDK. */
-//#endregion
-//#region src/secret.d.ts
-/**
- * A wrapper that prevents accidental logging of sensitive values.
- *
- * - `toString()` returns "[REDACTED]"
- * - `toJSON()` returns "[REDACTED]"
- * - `console.log(secretValue)` prints "[REDACTED]"
- * - `.expose()` returns the raw value when intentionally needed
- */
-declare class SecretValue {
-  #private;
-  constructor(value: string);
-  /** Returns the raw secret. Use only when you intentionally need the plaintext. */
-  expose(): string;
-  toString(): string;
-  toJSON(): string;
-  get [Symbol.toStringTag](): string;
-}
-//# sourceMappingURL=secret.d.ts.map
-//#endregion
-//#region src/auth/types.d.ts
-/**
- * Token set returned by authentication.
- */
-interface TokenSet {
-  /** The Safeguard user access token (wrapped to prevent accidental logging). */
-  accessToken: SecretValue;
-  /** Token lifetime in seconds from when it was issued. */
-  expiresIn?: number;
-  /** Timestamp (ms since epoch) when the token was acquired. */
-  acquiredAt: number;
-}
-/**
- * Auth strategy interface. All authentication methods implement this.
- */
-interface Auth {
-  /**
-   * Authenticate against the Safeguard RSTS and return a token set.
-   * @param host - Appliance hostname
-   * @param httpClient - HTTP client to use for requests
-   * @param storage - Storage provider for persisting tokens/state
-   */
-  authenticate(host: string, httpClient: HttpClient, storage: StorageProvider): Promise<TokenSet>;
-  /**
-   * Refresh the token if possible. Returns new token set or null if refresh not supported.
-   */
-  refreshToken?(host: string, httpClient: HttpClient, storage: StorageProvider): Promise<TokenSet | null>;
-  /** Human-readable description of this auth strategy (for logging). */
-  readonly description: string;
-}
-//# sourceMappingURL=types.d.ts.map
-//#endregion
-//#region src/events/persistent.d.ts
-/**
- * Persistent event listener with automatic reconnection and token refresh.
- *
- * Wraps SignalR's built-in `withAutomaticReconnect()` AND adds:
- * - Token refresh on reconnect (re-authenticates if needed)
- * - State change event notifications
- * - Manual `stop()` that prevents further auto-reconnect
- */
-declare class PersistentSafeguardEventListener {
-  #private;
-  constructor(connection: HubConnection, auth: Auth, host: string, httpClient: HttpClient, storage: StorageProvider, options?: PersistentListenerOptions, tokenSet?: TokenSet);
-  /** Current connection state. */
-  get state(): EventListenerState;
-  /**
-   * Register an event handler for Safeguard notifications.
-   */
-  on(_method: 'NotifyEventAsync', handler: EventHandler): this;
-  /**
-   * Register a state change handler.
-   */
-  onStateChange(handler: StateChangeHandler): this;
-  /**
-   * Start the persistent connection.
-   */
-  start(): Promise<void>;
-  /**
-   * Stop the connection. Prevents auto-reconnect.
-   */
-  stop(): Promise<void>;
-}
-//# sourceMappingURL=persistent.d.ts.map
-
-//#endregion
-export { type EventHandler, type EventListenerState, type PersistentListenerOptions, PersistentSafeguardEventListener, type SafeguardEvent, SafeguardEventListener, type StateChangeHandler };
-//# sourceMappingURL=events-zHsrmRBj.d.cts.map

package/dist/events-zHsrmRBj.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"events-zHsrmRBj.d.cts","names":[],"sources":["../src/events/types.ts","../src/events/listener.ts","../src/http/types.ts","../src/storage/types.ts","../src/secret.ts","../src/auth/types.ts","../src/events/persistent.ts"],"mappings":"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"}