@pushflodev/sdk 1.0.5 → 1.0.6

package/README.md

@@ -48,6 +48,9 @@ const subscription = client.subscribe('notifications', {
 // 4. Cleanup when done
 subscription.unsubscribe();
 client.disconnect();
+
+// 5. Clean up all resources (optional - for complete teardown)
+client.destroy();
 ```
 
 ## Quick Start - Server (60 seconds)

package/dist/{PushFloClient-B4smuFOa.d.ts → ConnectionError-CfKkkpfA.d.ts}

@@ -1,4 +1,4 @@
-import { a as ConnectionInfo, M as Message, C as ClientOptions, b as ConnectionState, e as SubscriptionOptions, S as Subscription } from './message-CVgilLwz.js';
+import { a as ConnectionInfo, M as Message, C as ClientOptions, b as ConnectionState, f as SubscriptionOptions, S as Subscription, e as PushFloError } from './ValidationError-izGOr1dF.js';
 
 /**
  * Type-safe event emitter with zero dependencies
@@ -101,4 +101,26 @@ declare class PushFloClient extends TypedEventEmitter<PushFloClientEvents> {
     private handleServerMessage;
 }
 
-export { PushFloClient as P };
+/**
+ * Error thrown when connection to PushFlo fails
+ */
+declare class ConnectionError extends PushFloError {
+    constructor(message: string, code?: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+    });
+    /**
+     * Create a connection timeout error
+     */
+    static timeout(timeoutMs: number): ConnectionError;
+    /**
+     * Create a connection closed error
+     */
+    static closed(reason?: string): ConnectionError;
+    /**
+     * Create a connection failed error
+     */
+    static failed(reason?: string, cause?: Error): ConnectionError;
+}
+
+export { ConnectionError as C, PushFloClient as P };

package/dist/{PushFloClient-DqOYR0GV.d.cts → ConnectionError-DMzDtJlz.d.cts}

@@ -1,4 +1,4 @@
-import { a as ConnectionInfo, M as Message, C as ClientOptions, b as ConnectionState, e as SubscriptionOptions, S as Subscription } from './message-CVgilLwz.cjs';
+import { a as ConnectionInfo, M as Message, C as ClientOptions, b as ConnectionState, f as SubscriptionOptions, S as Subscription, e as PushFloError } from './ValidationError-izGOr1dF.cjs';
 
 /**
  * Type-safe event emitter with zero dependencies
@@ -101,4 +101,26 @@ declare class PushFloClient extends TypedEventEmitter<PushFloClientEvents> {
     private handleServerMessage;
 }
 
-export { PushFloClient as P };
+/**
+ * Error thrown when connection to PushFlo fails
+ */
+declare class ConnectionError extends PushFloError {
+    constructor(message: string, code?: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+    });
+    /**
+     * Create a connection timeout error
+     */
+    static timeout(timeoutMs: number): ConnectionError;
+    /**
+     * Create a connection closed error
+     */
+    static closed(reason?: string): ConnectionError;
+    /**
+     * Create a connection failed error
+     */
+    static failed(reason?: string, cause?: Error): ConnectionError;
+}
+
+export { ConnectionError as C, PushFloClient as P };

package/dist/{message-CVgilLwz.d.cts → ValidationError-izGOr1dF.d.cts}

@@ -127,4 +127,95 @@ interface SubscriptionOptions {
     onUnsubscribed?: () => void;
 }
 
-export type { ClientOptions as C, Message as M, PublishOptions as P, Subscription as S, ConnectionInfo as a, ConnectionState as b, MessageHistoryOptions as c, PublishResult as d, SubscriptionOptions as e, ServerOptions as f };
+/**
+ * Base error class for all PushFlo SDK errors
+ */
+declare class PushFloError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** Whether this error is potentially recoverable through retry */
+    readonly retryable: boolean;
+    /** Original error that caused this error, if any */
+    readonly cause?: Error;
+    constructor(message: string, code: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+    });
+    /**
+     * Convert error to JSON-serializable object
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create a string representation
+     */
+    toString(): string;
+}
+
+/**
+ * Error thrown when authentication fails
+ */
+declare class AuthenticationError extends PushFloError {
+    constructor(message: string, code?: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+    });
+    /**
+     * Create an invalid API key error
+     */
+    static invalidKey(keyType?: string): AuthenticationError;
+    /**
+     * Create an unauthorized error
+     */
+    static unauthorized(reason?: string): AuthenticationError;
+    /**
+     * Create a forbidden error
+     */
+    static forbidden(action?: string): AuthenticationError;
+}
+
+/**
+ * Error thrown for network-related failures
+ */
+declare class NetworkError extends PushFloError {
+    /** HTTP status code, if applicable */
+    readonly statusCode?: number;
+    constructor(message: string, code?: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+        statusCode?: number;
+    });
+    /**
+     * Create a network error from fetch failure
+     */
+    static fromFetch(cause: Error): NetworkError;
+    /**
+     * Create a request timeout error
+     */
+    static timeout(timeoutMs: number): NetworkError;
+    /**
+     * Create an error from HTTP status code
+     */
+    static fromStatus(statusCode: number, message?: string): NetworkError;
+    private static getStatusMessage;
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * Error thrown when input validation fails
+ */
+declare class ValidationError extends PushFloError {
+    /** The field that failed validation */
+    readonly field?: string;
+    constructor(message: string, field?: string);
+    /**
+     * Create an error for an invalid channel slug
+     */
+    static invalidChannelSlug(slug: string): ValidationError;
+    /**
+     * Create an error for a required field
+     */
+    static required(field: string): ValidationError;
+    toJSON(): Record<string, unknown>;
+}
+
+export { AuthenticationError as A, type ClientOptions as C, type Message as M, NetworkError as N, type PublishOptions as P, type Subscription as S, ValidationError as V, type ConnectionInfo as a, type ConnectionState as b, type MessageHistoryOptions as c, type PublishResult as d, PushFloError as e, type SubscriptionOptions as f, type ServerOptions as g };

package/dist/{message-CVgilLwz.d.ts → ValidationError-izGOr1dF.d.ts}

@@ -127,4 +127,95 @@ interface SubscriptionOptions {
     onUnsubscribed?: () => void;
 }
 
-export type { ClientOptions as C, Message as M, PublishOptions as P, Subscription as S, ConnectionInfo as a, ConnectionState as b, MessageHistoryOptions as c, PublishResult as d, SubscriptionOptions as e, ServerOptions as f };
+/**
+ * Base error class for all PushFlo SDK errors
+ */
+declare class PushFloError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** Whether this error is potentially recoverable through retry */
+    readonly retryable: boolean;
+    /** Original error that caused this error, if any */
+    readonly cause?: Error;
+    constructor(message: string, code: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+    });
+    /**
+     * Convert error to JSON-serializable object
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create a string representation
+     */
+    toString(): string;
+}
+
+/**
+ * Error thrown when authentication fails
+ */
+declare class AuthenticationError extends PushFloError {
+    constructor(message: string, code?: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+    });
+    /**
+     * Create an invalid API key error
+     */
+    static invalidKey(keyType?: string): AuthenticationError;
+    /**
+     * Create an unauthorized error
+     */
+    static unauthorized(reason?: string): AuthenticationError;
+    /**
+     * Create a forbidden error
+     */
+    static forbidden(action?: string): AuthenticationError;
+}
+
+/**
+ * Error thrown for network-related failures
+ */
+declare class NetworkError extends PushFloError {
+    /** HTTP status code, if applicable */
+    readonly statusCode?: number;
+    constructor(message: string, code?: string, options?: {
+        retryable?: boolean;
+        cause?: Error;
+        statusCode?: number;
+    });
+    /**
+     * Create a network error from fetch failure
+     */
+    static fromFetch(cause: Error): NetworkError;
+    /**
+     * Create a request timeout error
+     */
+    static timeout(timeoutMs: number): NetworkError;
+    /**
+     * Create an error from HTTP status code
+     */
+    static fromStatus(statusCode: number, message?: string): NetworkError;
+    private static getStatusMessage;
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * Error thrown when input validation fails
+ */
+declare class ValidationError extends PushFloError {
+    /** The field that failed validation */
+    readonly field?: string;
+    constructor(message: string, field?: string);
+    /**
+     * Create an error for an invalid channel slug
+     */
+    static invalidChannelSlug(slug: string): ValidationError;
+    /**
+     * Create an error for a required field
+     */
+    static required(field: string): ValidationError;
+    toJSON(): Record<string, unknown>;
+}
+
+export { AuthenticationError as A, type ClientOptions as C, type Message as M, NetworkError as N, type PublishOptions as P, type Subscription as S, ValidationError as V, type ConnectionInfo as a, type ConnectionState as b, type MessageHistoryOptions as c, type PublishResult as d, PushFloError as e, type SubscriptionOptions as f, type ServerOptions as g };

package/dist/{api-Dgp2k2ZF.d.cts → api-DKISn33_.d.cts}

@@ -1,94 +1,3 @@
-/**
- * Base error class for all PushFlo SDK errors
- */
-declare class PushFloError extends Error {
-    /** Error code for programmatic handling */
-    readonly code: string;
-    /** Whether this error is potentially recoverable through retry */
-    readonly retryable: boolean;
-    /** Original error that caused this error, if any */
-    readonly cause?: Error;
-    constructor(message: string, code: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-    });
-    /**
-     * Convert error to JSON-serializable object
-     */
-    toJSON(): Record<string, unknown>;
-    /**
-     * Create a string representation
-     */
-    toString(): string;
-}
-
-/**
- * Error thrown when authentication fails
- */
-declare class AuthenticationError extends PushFloError {
-    constructor(message: string, code?: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-    });
-    /**
-     * Create an invalid API key error
-     */
-    static invalidKey(keyType?: string): AuthenticationError;
-    /**
-     * Create an unauthorized error
-     */
-    static unauthorized(reason?: string): AuthenticationError;
-    /**
-     * Create a forbidden error
-     */
-    static forbidden(action?: string): AuthenticationError;
-}
-
-/**
- * Error thrown for network-related failures
- */
-declare class NetworkError extends PushFloError {
-    /** HTTP status code, if applicable */
-    readonly statusCode?: number;
-    constructor(message: string, code?: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-        statusCode?: number;
-    });
-    /**
-     * Create a network error from fetch failure
-     */
-    static fromFetch(cause: Error): NetworkError;
-    /**
-     * Create a request timeout error
-     */
-    static timeout(timeoutMs: number): NetworkError;
-    /**
-     * Create an error from HTTP status code
-     */
-    static fromStatus(statusCode: number, message?: string): NetworkError;
-    private static getStatusMessage;
-    toJSON(): Record<string, unknown>;
-}
-
-/**
- * Error thrown when input validation fails
- */
-declare class ValidationError extends PushFloError {
-    /** The field that failed validation */
-    readonly field?: string;
-    constructor(message: string, field?: string);
-    /**
-     * Create an error for an invalid channel slug
-     */
-    static invalidChannelSlug(slug: string): ValidationError;
-    /**
-     * Create an error for a required field
-     */
-    static required(field: string): ValidationError;
-    toJSON(): Record<string, unknown>;
-}
-
 /**
  * Channel slug validation utilities
  *
@@ -226,4 +135,4 @@ interface Pagination {
     totalPages: number;
 }
 
-export { AuthenticationError as A, type Channel as C, type ListChannelsOptions as L, MAX_SLUG_LENGTH as M, NetworkError as N, PushFloError as P, type SlugValidationResult as S, ValidationError as V, type ChannelInput as a, type ChannelUpdateInput as b, MIN_SLUG_LENGTH as c, type Pagination as d, isValidChannelSlug as i, toChannelSlug as t, validateChannelSlug as v };
+export { type Channel as C, type ListChannelsOptions as L, MAX_SLUG_LENGTH as M, type Pagination as P, type SlugValidationResult as S, type ChannelInput as a, type ChannelUpdateInput as b, MIN_SLUG_LENGTH as c, isValidChannelSlug as i, toChannelSlug as t, validateChannelSlug as v };

package/dist/{api-Dgp2k2ZF.d.ts → api-DKISn33_.d.ts}

@@ -1,94 +1,3 @@
-/**
- * Base error class for all PushFlo SDK errors
- */
-declare class PushFloError extends Error {
-    /** Error code for programmatic handling */
-    readonly code: string;
-    /** Whether this error is potentially recoverable through retry */
-    readonly retryable: boolean;
-    /** Original error that caused this error, if any */
-    readonly cause?: Error;
-    constructor(message: string, code: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-    });
-    /**
-     * Convert error to JSON-serializable object
-     */
-    toJSON(): Record<string, unknown>;
-    /**
-     * Create a string representation
-     */
-    toString(): string;
-}
-
-/**
- * Error thrown when authentication fails
- */
-declare class AuthenticationError extends PushFloError {
-    constructor(message: string, code?: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-    });
-    /**
-     * Create an invalid API key error
-     */
-    static invalidKey(keyType?: string): AuthenticationError;
-    /**
-     * Create an unauthorized error
-     */
-    static unauthorized(reason?: string): AuthenticationError;
-    /**
-     * Create a forbidden error
-     */
-    static forbidden(action?: string): AuthenticationError;
-}
-
-/**
- * Error thrown for network-related failures
- */
-declare class NetworkError extends PushFloError {
-    /** HTTP status code, if applicable */
-    readonly statusCode?: number;
-    constructor(message: string, code?: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-        statusCode?: number;
-    });
-    /**
-     * Create a network error from fetch failure
-     */
-    static fromFetch(cause: Error): NetworkError;
-    /**
-     * Create a request timeout error
-     */
-    static timeout(timeoutMs: number): NetworkError;
-    /**
-     * Create an error from HTTP status code
-     */
-    static fromStatus(statusCode: number, message?: string): NetworkError;
-    private static getStatusMessage;
-    toJSON(): Record<string, unknown>;
-}
-
-/**
- * Error thrown when input validation fails
- */
-declare class ValidationError extends PushFloError {
-    /** The field that failed validation */
-    readonly field?: string;
-    constructor(message: string, field?: string);
-    /**
-     * Create an error for an invalid channel slug
-     */
-    static invalidChannelSlug(slug: string): ValidationError;
-    /**
-     * Create an error for a required field
-     */
-    static required(field: string): ValidationError;
-    toJSON(): Record<string, unknown>;
-}
-
 /**
  * Channel slug validation utilities
  *
@@ -226,4 +135,4 @@ interface Pagination {
     totalPages: number;
 }
 
-export { AuthenticationError as A, type Channel as C, type ListChannelsOptions as L, MAX_SLUG_LENGTH as M, NetworkError as N, PushFloError as P, type SlugValidationResult as S, ValidationError as V, type ChannelInput as a, type ChannelUpdateInput as b, MIN_SLUG_LENGTH as c, type Pagination as d, isValidChannelSlug as i, toChannelSlug as t, validateChannelSlug as v };
+export { type Channel as C, type ListChannelsOptions as L, MAX_SLUG_LENGTH as M, type Pagination as P, type SlugValidationResult as S, type ChannelInput as a, type ChannelUpdateInput as b, MIN_SLUG_LENGTH as c, isValidChannelSlug as i, toChannelSlug as t, validateChannelSlug as v };

package/dist/index.d.cts

@@ -1,28 +1,3 @@
-export { P as PushFloClient } from './PushFloClient-DqOYR0GV.cjs';
-import { P as PushFloError } from './api-Dgp2k2ZF.cjs';
-export { A as AuthenticationError, C as Channel, a as ChannelInput, b as ChannelUpdateInput, L as ListChannelsOptions, M as MAX_SLUG_LENGTH, c as MIN_SLUG_LENGTH, N as NetworkError, d as Pagination, S as SlugValidationResult, V as ValidationError, i as isValidChannelSlug, t as toChannelSlug, v as validateChannelSlug } from './api-Dgp2k2ZF.cjs';
-export { C as ClientOptions, a as ConnectionInfo, b as ConnectionState, M as Message, c as MessageHistoryOptions, P as PublishOptions, d as PublishResult, S as Subscription, e as SubscriptionOptions } from './message-CVgilLwz.cjs';
-
-/**
- * Error thrown when connection to PushFlo fails
- */
-declare class ConnectionError extends PushFloError {
-    constructor(message: string, code?: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-    });
-    /**
-     * Create a connection timeout error
-     */
-    static timeout(timeoutMs: number): ConnectionError;
-    /**
-     * Create a connection closed error
-     */
-    static closed(reason?: string): ConnectionError;
-    /**
-     * Create a connection failed error
-     */
-    static failed(reason?: string, cause?: Error): ConnectionError;
-}
-
-export { ConnectionError, PushFloError };
+export { C as ConnectionError, P as PushFloClient } from './ConnectionError-DMzDtJlz.cjs';
+export { A as AuthenticationError, C as ClientOptions, a as ConnectionInfo, b as ConnectionState, M as Message, c as MessageHistoryOptions, N as NetworkError, P as PublishOptions, d as PublishResult, e as PushFloError, S as Subscription, f as SubscriptionOptions, V as ValidationError } from './ValidationError-izGOr1dF.cjs';
+export { C as Channel, a as ChannelInput, b as ChannelUpdateInput, L as ListChannelsOptions, M as MAX_SLUG_LENGTH, c as MIN_SLUG_LENGTH, P as Pagination, S as SlugValidationResult, i as isValidChannelSlug, t as toChannelSlug, v as validateChannelSlug } from './api-DKISn33_.cjs';

package/dist/index.d.ts

@@ -1,28 +1,3 @@
-export { P as PushFloClient } from './PushFloClient-B4smuFOa.js';
-import { P as PushFloError } from './api-Dgp2k2ZF.js';
-export { A as AuthenticationError, C as Channel, a as ChannelInput, b as ChannelUpdateInput, L as ListChannelsOptions, M as MAX_SLUG_LENGTH, c as MIN_SLUG_LENGTH, N as NetworkError, d as Pagination, S as SlugValidationResult, V as ValidationError, i as isValidChannelSlug, t as toChannelSlug, v as validateChannelSlug } from './api-Dgp2k2ZF.js';
-export { C as ClientOptions, a as ConnectionInfo, b as ConnectionState, M as Message, c as MessageHistoryOptions, P as PublishOptions, d as PublishResult, S as Subscription, e as SubscriptionOptions } from './message-CVgilLwz.js';
-
-/**
- * Error thrown when connection to PushFlo fails
- */
-declare class ConnectionError extends PushFloError {
-    constructor(message: string, code?: string, options?: {
-        retryable?: boolean;
-        cause?: Error;
-    });
-    /**
-     * Create a connection timeout error
-     */
-    static timeout(timeoutMs: number): ConnectionError;
-    /**
-     * Create a connection closed error
-     */
-    static closed(reason?: string): ConnectionError;
-    /**
-     * Create a connection failed error
-     */
-    static failed(reason?: string, cause?: Error): ConnectionError;
-}
-
-export { ConnectionError, PushFloError };
+export { C as ConnectionError, P as PushFloClient } from './ConnectionError-CfKkkpfA.js';
+export { A as AuthenticationError, C as ClientOptions, a as ConnectionInfo, b as ConnectionState, M as Message, c as MessageHistoryOptions, N as NetworkError, P as PublishOptions, d as PublishResult, e as PushFloError, S as Subscription, f as SubscriptionOptions, V as ValidationError } from './ValidationError-izGOr1dF.js';
+export { C as Channel, a as ChannelInput, b as ChannelUpdateInput, L as ListChannelsOptions, M as MAX_SLUG_LENGTH, c as MIN_SLUG_LENGTH, P as Pagination, S as SlugValidationResult, i as isValidChannelSlug, t as toChannelSlug, v as validateChannelSlug } from './api-DKISn33_.js';

package/dist/react.cjs

@@ -123,6 +123,13 @@ var ERROR_CODES = {
   INVALID_API_KEY: "INVALID_API_KEY",
   UNAUTHORIZED: "UNAUTHORIZED",
   FORBIDDEN: "FORBIDDEN",
+  // Network errors
+  NETWORK_ERROR: "NETWORK_ERROR",
+  REQUEST_TIMEOUT: "REQUEST_TIMEOUT",
+  // API errors
+  NOT_FOUND: "NOT_FOUND",
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  RATE_LIMITED: "RATE_LIMITED",
   SERVER_ERROR: "SERVER_ERROR"};
 
 // src/utils/logger.ts
@@ -1346,7 +1353,82 @@ function useChannel(channel, options = {}) {
   };
 }
 
+// src/errors/NetworkError.ts
+var NetworkError = class _NetworkError extends PushFloError {
+  /** HTTP status code, if applicable */
+  statusCode;
+  constructor(message, code = ERROR_CODES.NETWORK_ERROR, options = {}) {
+    super(message, code, { retryable: true, ...options });
+    this.name = "NetworkError";
+    this.statusCode = options.statusCode;
+  }
+  /**
+   * Create a network error from fetch failure
+   */
+  static fromFetch(cause) {
+    return new _NetworkError(
+      `Network request failed: ${cause.message}`,
+      ERROR_CODES.NETWORK_ERROR,
+      { retryable: true, cause }
+    );
+  }
+  /**
+   * Create a request timeout error
+   */
+  static timeout(timeoutMs) {
+    return new _NetworkError(
+      `Request timed out after ${timeoutMs}ms`,
+      ERROR_CODES.REQUEST_TIMEOUT,
+      { retryable: true }
+    );
+  }
+  /**
+   * Create an error from HTTP status code
+   */
+  static fromStatus(statusCode, message) {
+    const defaultMessage = _NetworkError.getStatusMessage(statusCode);
+    const retryable = statusCode >= 500 || statusCode === 429;
+    let code = ERROR_CODES.SERVER_ERROR;
+    if (statusCode === 404) {
+      code = ERROR_CODES.NOT_FOUND;
+    } else if (statusCode === 422 || statusCode === 400) {
+      code = ERROR_CODES.VALIDATION_ERROR;
+    } else if (statusCode === 429) {
+      code = ERROR_CODES.RATE_LIMITED;
+    }
+    return new _NetworkError(
+      message ?? defaultMessage,
+      code,
+      { retryable, statusCode }
+    );
+  }
+  static getStatusMessage(statusCode) {
+    const messages = {
+      400: "Bad request",
+      404: "Resource not found",
+      422: "Validation error",
+      429: "Rate limit exceeded",
+      500: "Internal server error",
+      502: "Bad gateway",
+      503: "Service unavailable",
+      504: "Gateway timeout"
+    };
+    return messages[statusCode] ?? `HTTP error ${statusCode}`;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      statusCode: this.statusCode
+    };
+  }
+};
+
+exports.AuthenticationError = AuthenticationError;
+exports.ConnectionError = ConnectionError;
+exports.NetworkError = NetworkError;
+exports.PushFloError = PushFloError;
 exports.PushFloProvider = PushFloProvider;
+exports.ValidationError = ValidationError;
 exports.useChannel = useChannel;
 exports.usePushFlo = usePushFlo;
 exports.usePushFloContext = usePushFloContext;