@exyconn/common 1.0.0

package/dist/client/utils/index.d.mts

@@ -0,0 +1,285 @@
+import { a as ApiResponse, P as PaginatedResponse, c as PaginationMeta } from '../../response.types-D--UhLJq.mjs';
+
+/**
+ * Format date to readable string
+ * @param date - Date to format
+ * @param locale - Locale for formatting (default: 'en-US')
+ */
+declare const formatDate: (date: Date | string | number, locale?: string) => string;
+/**
+ * Format date with time
+ */
+declare const formatDateTime: (date: Date | string | number, locale?: string) => string;
+/**
+ * Format date as relative time (e.g., "2 hours ago")
+ */
+declare const formatRelativeTime: (date: Date | string | number) => string;
+/**
+ * Format date for input[type="date"]
+ */
+declare const formatDateForInput: (date: Date | string | number) => string;
+/**
+ * Format date for input[type="datetime-local"]
+ */
+declare const formatDateTimeForInput: (date: Date | string | number) => string;
+/**
+ * Check if date is today
+ */
+declare const isToday: (date: Date | string | number) => boolean;
+/**
+ * Check if date is in the past
+ */
+declare const isPast: (date: Date | string | number) => boolean;
+/**
+ * Check if date is in the future
+ */
+declare const isFuture: (date: Date | string | number) => boolean;
+/**
+ * Add days to a date
+ */
+declare const addDays: (date: Date | string | number, days: number) => Date;
+/**
+ * Get start of day
+ */
+declare const startOfDay: (date: Date | string | number) => Date;
+/**
+ * Get end of day
+ */
+declare const endOfDay: (date: Date | string | number) => Date;
+
+/**
+ * Copy text to clipboard
+ * @returns Promise<boolean> - true if successful
+ */
+declare const copyToClipboard: (text: string) => Promise<boolean>;
+/**
+ * Read text from clipboard
+ * @returns Promise<string | null>
+ */
+declare const readFromClipboard: () => Promise<string | null>;
+/**
+ * Check if clipboard API is available
+ */
+declare const isClipboardAvailable: () => boolean;
+
+/**
+ * Generate URL-friendly slug from text
+ */
+declare const slugify: (text: string) => string;
+/**
+ * Generate slug with unique suffix
+ */
+declare const slugifyUnique: (text: string) => string;
+/**
+ * Convert slug back to readable text
+ */
+declare const unslugify: (slug: string) => string;
+/**
+ * Truncate text to specified length with ellipsis
+ */
+declare const truncate: (text: string, maxLength: number, suffix?: string) => string;
+/**
+ * Truncate text by words
+ */
+declare const truncateWords: (text: string, maxWords: number, suffix?: string) => string;
+/**
+ * Capitalize first letter of each word
+ */
+declare const capitalizeWords: (text: string) => string;
+/**
+ * Capitalize first letter only
+ */
+declare const capitalize: (text: string) => string;
+/**
+ * Convert camelCase to kebab-case
+ */
+declare const camelToKebab: (text: string) => string;
+/**
+ * Convert kebab-case to camelCase
+ */
+declare const kebabToCamel: (text: string) => string;
+
+/**
+ * Event Emitter for client-side event handling
+ */
+type EventHandler<T = unknown> = (data: T) => void;
+interface EventMap {
+    [event: string]: unknown;
+}
+/**
+ * Simple typed event emitter for browser use
+ */
+declare class EventEmitter<Events extends EventMap = EventMap> {
+    private handlers;
+    /**
+     * Subscribe to an event
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): () => void;
+    /**
+     * Subscribe to an event once
+     */
+    once<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): () => void;
+    /**
+     * Unsubscribe from an event
+     */
+    off<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void;
+    /**
+     * Emit an event
+     */
+    emit<K extends keyof Events>(event: K, data: Events[K]): void;
+    /**
+     * Remove all handlers for an event (or all events)
+     */
+    removeAllListeners(event?: keyof Events): void;
+    /**
+     * Get count of listeners for an event
+     */
+    listenerCount(event: keyof Events): number;
+}
+/**
+ * Create a new event emitter instance
+ */
+declare const createEventEmitter: <Events extends EventMap = EventMap>() => EventEmitter<Events>;
+/**
+ * Global app event emitter (singleton)
+ */
+declare const appEvents: EventEmitter<{
+    [key: string]: unknown;
+    'auth:login': {
+        userId: string;
+    };
+    'auth:logout': void;
+    'notification:show': {
+        message: string;
+        type: "success" | "error" | "warning" | "info";
+    };
+    'theme:change': "light" | "dark";
+}>;
+
+/**
+ * API URL Builder
+ * Centralized API endpoint management
+ */
+interface ApiUrlConfig {
+    baseUrl: string;
+    version?: string;
+}
+/**
+ * API URL builder class
+ */
+declare class ApiUrlBuilder {
+    private baseUrl;
+    private version;
+    constructor(config: ApiUrlConfig);
+    /**
+     * Build full URL from path
+     */
+    build(path: string): string;
+    /**
+     * Build URL with query parameters
+     */
+    buildWithParams(path: string, params: Record<string, string | number | boolean | undefined>): string;
+    /**
+     * Build URL with path parameters
+     */
+    buildWithPathParams(template: string, params: Record<string, string | number>): string;
+    /**
+     * Get base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Set new base URL
+     */
+    setBaseUrl(baseUrl: string): void;
+}
+/**
+ * Create API URL builder
+ */
+declare const createApiUrlBuilder: (config: ApiUrlConfig) => ApiUrlBuilder;
+/**
+ * Common API endpoints factory
+ */
+declare const createApiEndpoints: (builder: ApiUrlBuilder) => {
+    auth: {
+        login: () => string;
+        register: () => string;
+        logout: () => string;
+        refresh: () => string;
+        me: () => string;
+        forgotPassword: () => string;
+        resetPassword: () => string;
+    };
+    users: {
+        list: () => string;
+        get: (id: string) => string;
+        create: () => string;
+        update: (id: string) => string;
+        delete: (id: string) => string;
+    };
+    crud: (resource: string) => {
+        list: () => string;
+        get: (id: string) => string;
+        create: () => string;
+        update: (id: string) => string;
+        delete: (id: string) => string;
+    };
+};
+
+/**
+ * Response Parser Utilities
+ * Common patterns for parsing API responses
+ */
+
+/**
+ * Check if response is successful
+ */
+declare const isSuccessResponse: <T>(response: ApiResponse<T>) => response is ApiResponse<T> & {
+    success: true;
+};
+/**
+ * Check if response is an error
+ */
+declare const isErrorResponse: <T>(response: ApiResponse<T>) => response is ApiResponse<T> & {
+    success: false;
+};
+/**
+ * Extract data from response or return default
+ */
+declare const getResponseData: <T>(response: ApiResponse<T>, defaultValue: T) => T;
+/**
+ * Extract error message from response
+ */
+declare const getErrorMessage: <T>(response: ApiResponse<T>, defaultMessage?: string) => string;
+/**
+ * Check if response has data
+ */
+declare const hasData: <T>(response: ApiResponse<T>) => response is ApiResponse<T> & {
+    data: NonNullable<T>;
+};
+/**
+ * Check if paginated response has more pages
+ */
+declare const hasMorePages: <T>(response: PaginatedResponse<T>) => boolean;
+/**
+ * Get next page number from paginated response
+ */
+declare const getNextPage: <T>(response: PaginatedResponse<T>) => number | null;
+/**
+ * Get previous page number from paginated response
+ */
+declare const getPrevPage: <T>(response: PaginatedResponse<T>) => number | null;
+/**
+ * Create empty pagination meta
+ */
+declare const createEmptyPaginationMeta: () => PaginationMeta;
+/**
+ * Create success response
+ */
+declare const createSuccessResponse: <T>(data: T, message?: string) => ApiResponse<T>;
+/**
+ * Create error response
+ */
+declare const createErrorResponse: (message: string, statusCode?: number, error?: string) => ApiResponse<never>;
+
+export { ApiUrlBuilder, type ApiUrlConfig, EventEmitter, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatRelativeTime, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify };

package/dist/client/utils/index.d.ts

@@ -0,0 +1,285 @@
+import { a as ApiResponse, P as PaginatedResponse, c as PaginationMeta } from '../../response.types-D--UhLJq.js';
+
+/**
+ * Format date to readable string
+ * @param date - Date to format
+ * @param locale - Locale for formatting (default: 'en-US')
+ */
+declare const formatDate: (date: Date | string | number, locale?: string) => string;
+/**
+ * Format date with time
+ */
+declare const formatDateTime: (date: Date | string | number, locale?: string) => string;
+/**
+ * Format date as relative time (e.g., "2 hours ago")
+ */
+declare const formatRelativeTime: (date: Date | string | number) => string;
+/**
+ * Format date for input[type="date"]
+ */
+declare const formatDateForInput: (date: Date | string | number) => string;
+/**
+ * Format date for input[type="datetime-local"]
+ */
+declare const formatDateTimeForInput: (date: Date | string | number) => string;
+/**
+ * Check if date is today
+ */
+declare const isToday: (date: Date | string | number) => boolean;
+/**
+ * Check if date is in the past
+ */
+declare const isPast: (date: Date | string | number) => boolean;
+/**
+ * Check if date is in the future
+ */
+declare const isFuture: (date: Date | string | number) => boolean;
+/**
+ * Add days to a date
+ */
+declare const addDays: (date: Date | string | number, days: number) => Date;
+/**
+ * Get start of day
+ */
+declare const startOfDay: (date: Date | string | number) => Date;
+/**
+ * Get end of day
+ */
+declare const endOfDay: (date: Date | string | number) => Date;
+
+/**
+ * Copy text to clipboard
+ * @returns Promise<boolean> - true if successful
+ */
+declare const copyToClipboard: (text: string) => Promise<boolean>;
+/**
+ * Read text from clipboard
+ * @returns Promise<string | null>
+ */
+declare const readFromClipboard: () => Promise<string | null>;
+/**
+ * Check if clipboard API is available
+ */
+declare const isClipboardAvailable: () => boolean;
+
+/**
+ * Generate URL-friendly slug from text
+ */
+declare const slugify: (text: string) => string;
+/**
+ * Generate slug with unique suffix
+ */
+declare const slugifyUnique: (text: string) => string;
+/**
+ * Convert slug back to readable text
+ */
+declare const unslugify: (slug: string) => string;
+/**
+ * Truncate text to specified length with ellipsis
+ */
+declare const truncate: (text: string, maxLength: number, suffix?: string) => string;
+/**
+ * Truncate text by words
+ */
+declare const truncateWords: (text: string, maxWords: number, suffix?: string) => string;
+/**
+ * Capitalize first letter of each word
+ */
+declare const capitalizeWords: (text: string) => string;
+/**
+ * Capitalize first letter only
+ */
+declare const capitalize: (text: string) => string;
+/**
+ * Convert camelCase to kebab-case
+ */
+declare const camelToKebab: (text: string) => string;
+/**
+ * Convert kebab-case to camelCase
+ */
+declare const kebabToCamel: (text: string) => string;
+
+/**
+ * Event Emitter for client-side event handling
+ */
+type EventHandler<T = unknown> = (data: T) => void;
+interface EventMap {
+    [event: string]: unknown;
+}
+/**
+ * Simple typed event emitter for browser use
+ */
+declare class EventEmitter<Events extends EventMap = EventMap> {
+    private handlers;
+    /**
+     * Subscribe to an event
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): () => void;
+    /**
+     * Subscribe to an event once
+     */
+    once<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): () => void;
+    /**
+     * Unsubscribe from an event
+     */
+    off<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void;
+    /**
+     * Emit an event
+     */
+    emit<K extends keyof Events>(event: K, data: Events[K]): void;
+    /**
+     * Remove all handlers for an event (or all events)
+     */
+    removeAllListeners(event?: keyof Events): void;
+    /**
+     * Get count of listeners for an event
+     */
+    listenerCount(event: keyof Events): number;
+}
+/**
+ * Create a new event emitter instance
+ */
+declare const createEventEmitter: <Events extends EventMap = EventMap>() => EventEmitter<Events>;
+/**
+ * Global app event emitter (singleton)
+ */
+declare const appEvents: EventEmitter<{
+    [key: string]: unknown;
+    'auth:login': {
+        userId: string;
+    };
+    'auth:logout': void;
+    'notification:show': {
+        message: string;
+        type: "success" | "error" | "warning" | "info";
+    };
+    'theme:change': "light" | "dark";
+}>;
+
+/**
+ * API URL Builder
+ * Centralized API endpoint management
+ */
+interface ApiUrlConfig {
+    baseUrl: string;
+    version?: string;
+}
+/**
+ * API URL builder class
+ */
+declare class ApiUrlBuilder {
+    private baseUrl;
+    private version;
+    constructor(config: ApiUrlConfig);
+    /**
+     * Build full URL from path
+     */
+    build(path: string): string;
+    /**
+     * Build URL with query parameters
+     */
+    buildWithParams(path: string, params: Record<string, string | number | boolean | undefined>): string;
+    /**
+     * Build URL with path parameters
+     */
+    buildWithPathParams(template: string, params: Record<string, string | number>): string;
+    /**
+     * Get base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Set new base URL
+     */
+    setBaseUrl(baseUrl: string): void;
+}
+/**
+ * Create API URL builder
+ */
+declare const createApiUrlBuilder: (config: ApiUrlConfig) => ApiUrlBuilder;
+/**
+ * Common API endpoints factory
+ */
+declare const createApiEndpoints: (builder: ApiUrlBuilder) => {
+    auth: {
+        login: () => string;
+        register: () => string;
+        logout: () => string;
+        refresh: () => string;
+        me: () => string;
+        forgotPassword: () => string;
+        resetPassword: () => string;
+    };
+    users: {
+        list: () => string;
+        get: (id: string) => string;
+        create: () => string;
+        update: (id: string) => string;
+        delete: (id: string) => string;
+    };
+    crud: (resource: string) => {
+        list: () => string;
+        get: (id: string) => string;
+        create: () => string;
+        update: (id: string) => string;
+        delete: (id: string) => string;
+    };
+};
+
+/**
+ * Response Parser Utilities
+ * Common patterns for parsing API responses
+ */
+
+/**
+ * Check if response is successful
+ */
+declare const isSuccessResponse: <T>(response: ApiResponse<T>) => response is ApiResponse<T> & {
+    success: true;
+};
+/**
+ * Check if response is an error
+ */
+declare const isErrorResponse: <T>(response: ApiResponse<T>) => response is ApiResponse<T> & {
+    success: false;
+};
+/**
+ * Extract data from response or return default
+ */
+declare const getResponseData: <T>(response: ApiResponse<T>, defaultValue: T) => T;
+/**
+ * Extract error message from response
+ */
+declare const getErrorMessage: <T>(response: ApiResponse<T>, defaultMessage?: string) => string;
+/**
+ * Check if response has data
+ */
+declare const hasData: <T>(response: ApiResponse<T>) => response is ApiResponse<T> & {
+    data: NonNullable<T>;
+};
+/**
+ * Check if paginated response has more pages
+ */
+declare const hasMorePages: <T>(response: PaginatedResponse<T>) => boolean;
+/**
+ * Get next page number from paginated response
+ */
+declare const getNextPage: <T>(response: PaginatedResponse<T>) => number | null;
+/**
+ * Get previous page number from paginated response
+ */
+declare const getPrevPage: <T>(response: PaginatedResponse<T>) => number | null;
+/**
+ * Create empty pagination meta
+ */
+declare const createEmptyPaginationMeta: () => PaginationMeta;
+/**
+ * Create success response
+ */
+declare const createSuccessResponse: <T>(data: T, message?: string) => ApiResponse<T>;
+/**
+ * Create error response
+ */
+declare const createErrorResponse: (message: string, statusCode?: number, error?: string) => ApiResponse<never>;
+
+export { ApiUrlBuilder, type ApiUrlConfig, EventEmitter, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatRelativeTime, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify };