@plyaz/api 1.0.2 → 1.1.0

package/dist/api/services/campaigns/POST/useJoinCampaign.d.ts

@@ -0,0 +1,23 @@
+/**
+ * React Query Mutation Hook for Joining Campaigns
+ * Provides cache invalidation for participant lists
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { CampaignJoinResponse } from '@plyaz/types/api';
+import type { ServiceOptions } from '../../types';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for joining a campaign
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate: join, isPending } = useJoinCampaign();
+ * join(campaignId);
+ * ```
+ */
+export declare function useJoinCampaign<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<CampaignJoinResponse, Error, string, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<CampaignJoinResponse, Error, string, unknown, TEndpoints>>>;
+//# sourceMappingURL=useJoinCampaign.d.ts.map

package/dist/api/services/campaigns/POST/useJoinCampaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJoinCampaign.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/campaigns/POST/useJoinCampaign.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,GAAG,aAAa,EACxD,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CAAC,OAAO,iBAAiB,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAC/F,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CAAC,OAAO,iBAAiB,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAC/F,CAuBA"}

package/dist/api/services/campaigns/POST/useLeaveCampaign.d.ts

@@ -0,0 +1,23 @@
+/**
+ * React Query Mutation Hook for Leaving Campaigns
+ * Provides cache invalidation for participant lists
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { CampaignLeaveResponse } from '@plyaz/types/api';
+import type { ServiceOptions } from '../../types';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for leaving a campaign
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate: leave } = useLeaveCampaign();
+ * leave(campaignId);
+ * ```
+ */
+export declare function useLeaveCampaign<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<CampaignLeaveResponse, Error, string, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<CampaignLeaveResponse, Error, string, unknown, TEndpoints>>>;
+//# sourceMappingURL=useLeaveCampaign.d.ts.map

package/dist/api/services/campaigns/POST/useLeaveCampaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLeaveCampaign.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/campaigns/POST/useLeaveCampaign.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAG,aAAa,EACzD,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CAAC,OAAO,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAChG,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CAAC,OAAO,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAChG,CA0BA"}

package/dist/api/services/campaigns/PUT/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Campaign PUT Operations
+ * Exports all PUT services and hooks for campaigns
+ */
+export { updateCampaign } from './updateCampaign';
+export { useUpdateCampaign } from './useUpdateCampaign';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/campaigns/PUT/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/campaigns/PUT/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/api/services/campaigns/PUT/updateCampaign.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Update Campaign Service
+ * Updates an existing campaign with new data
+ */
+import type { UpdateCampaignDto } from '@plyaz/types/api';
+import type { ServiceOptions } from '../../types';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Update a campaign
+ * Uses endpoint: PUT /campaigns/:id
+ *
+ * @param campaignId - The campaign ID to update
+ * @param data - The update data
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<Campaign>
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const updated = await updateCampaign('camp-123', {
+ *   name: 'Updated Campaign Name',
+ *   description: 'New description'
+ * });
+ *
+ * // With timeout override
+ * const updated = await updateCampaign(
+ *   'camp-123',
+ *   { status: 'active' },
+ *   { apiConfig: { timeout: 10000 } }
+ * );
+ * ```
+ *
+ * @throws {ApiPackageError} When the request fails or campaign is not found
+ */
+export declare function updateCampaign<TEndpoints = EndpointsList>(campaignId: string, data: UpdateCampaignDto, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=updateCampaign.d.ts.map

package/dist/api/services/campaigns/PUT/updateCampaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCampaign.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/campaigns/PUT/updateCampaign.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,cAAc,CAAC,UAAU,GAAG,aAAa,EAC7D,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/api/services/campaigns/PUT/useUpdateCampaign.d.ts

@@ -0,0 +1,38 @@
+/**
+ * React Query Mutation Hook for Updating Campaigns
+ * Provides optimistic updates and cache invalidation
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { Campaign, UpdateCampaignDto } from '@plyaz/types/api';
+import type { ServiceOptions } from '../../types';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Parameters for update campaign mutation
+ */
+interface UpdateCampaignParams {
+    campaignId: string;
+    data: UpdateCampaignDto;
+}
+/**
+ * Hook for updating campaigns
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const { mutate } = useUpdateCampaign();
+ * mutate({ campaignId: id, data: updates });
+ *
+ * // With service options
+ * const { mutate } = useUpdateCampaign({
+ *   apiConfig: { timeout: 8000 },
+ *   updateConfigOptions: { strategy: 'merge' }
+ * });
+ * ```
+ */
+export declare function useUpdateCampaign<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<Campaign, Error, UpdateCampaignParams, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<Campaign, Error, UpdateCampaignParams, unknown, TEndpoints>>>;
+export {};
+//# sourceMappingURL=useUpdateCampaign.d.ts.map

package/dist/api/services/campaigns/PUT/useUpdateCampaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateCampaign.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/campaigns/PUT/useUpdateCampaign.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,UAAU,oBAAoB;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,GAAG,aAAa,EAC1D,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CAAC,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CACjG,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CAAC,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CACjG,CAwBA"}

package/dist/api/services/campaigns/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Campaign Services and Hooks
+ * Complete CRUD operations for campaigns with React Query integration
+ */
+export * from './GET';
+export * from './POST';
+export * from './PUT';
+export * from './DELETE';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/campaigns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/services/campaigns/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,OAAO,CAAC;AAGtB,cAAc,QAAQ,CAAC;AAGvB,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC"}

package/dist/api/services/clients.d.ts

@@ -0,0 +1,58 @@
+/**
+ * API Client Instances
+ * Default client references that can be set by the consuming application
+ *
+ * This module exports a default API client reference that service functions use.
+ * The consuming application (Next.js app, backend service, etc.) must set this
+ * client by calling `setDefaultApiClient()` after creating their client instance.
+ *
+ * The client should include all endpoints combined in EndpointsList.
+ */
+import type { ApiClientWithEvents } from '@plyaz/types/api';
+import type { ClientEventManager } from '../client/clientEventManager';
+import type { EndpointsList } from '../endpoints';
+/**
+ * Default API client used by all service functions
+ * This is set by the consuming application via `setDefaultApiClient()`
+ *
+ * The client has access to all endpoints defined in EndpointsList.
+ *
+ * @internal
+ */
+export declare let apiClient: ApiClientWithEvents<ClientEventManager, EndpointsList> | null;
+/**
+ * Set the default API client for all service functions
+ * Must be called by the consuming application before using any service functions
+ *
+ * The client should be created with all endpoints from the package.
+ *
+ * @param client - The API client instance with all endpoints from EndpointsList
+ *
+ * @example
+ * ```typescript
+ * // In your app initialization (e.g., Next.js _app.tsx or main.ts)
+ * import { createApiClient, setDefaultApiClient } from '@plyaz/api';
+ *
+ * const client = await createApiClient({
+ *   baseURL: process.env.NEXT_PUBLIC_API_URL,
+ *   // Endpoints are managed internally by the package
+ * });
+ *
+ * setDefaultApiClient(client);
+ *
+ * // Now all service functions have access to all endpoints
+ * const campaign = await fetchCampaign('123');
+ * ```
+ */
+export declare function setDefaultApiClient(client: ApiClientWithEvents<ClientEventManager, EndpointsList>): void;
+/**
+ * Get the default API client
+ * Returns the client with all endpoints from EndpointsList
+ *
+ * Throws an error if the client hasn't been set
+ *
+ * @internal
+ * @throws {Error} When the client hasn't been initialized
+ */
+export declare function getDefaultApiClient(): ApiClientWithEvents<ClientEventManager, EndpointsList>;
+//# sourceMappingURL=clients.d.ts.map

package/dist/api/services/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../../src/api/services/clients.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,IAAI,SAAS,EAAE,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG,IAAW,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAC7D,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAW5F"}

package/dist/api/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Services Layer
+ * Exports all service functions, hooks, and utilities
+ */
+export type { ServiceOptions } from './types';
+export { setDefaultApiClient, getDefaultApiClient } from './clients';
+export * from './campaigns';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrE,cAAc,aAAa,CAAC"}

package/dist/api/services/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Service Layer Types
+ * Core types for service functions and configuration
+ */
+import type { ApiConfig, ApiClientWithEvents, UpdateConfigOptions } from '@plyaz/types/api';
+import type { ClientEventManager } from '../client/clientEventManager';
+import type { EndpointsList } from '../endpoints';
+/**
+ * Options for service functions
+ * Allows overriding the API client instance, temporary config updates, and update strategy
+ *
+ * By default uses EndpointsList which includes all endpoints in the package.
+ * This ensures services have access to all available endpoints.
+ *
+ * @template TEndpoints - The endpoints type (defaults to EndpointsList)
+ *
+ * @example
+ * ```typescript
+ * // Use default client (has access to all endpoints internally)
+ * const campaign = await fetchCampaign('123');
+ *
+ * // Override timeout temporarily (uses temporary config mode by default)
+ * const campaign = await fetchCampaign('123', {
+ *   apiConfig: { timeout: 5000 }
+ * });
+ *
+ * // Override with different update strategy
+ * const campaign = await fetchCampaign('123', {
+ *   apiConfig: { timeout: 5000 },
+ *   updateConfigOptions: { strategy: 'merge', scope: 'client' }
+ * });
+ *
+ * // Use custom client instance (rare - usually for testing)
+ * const customClient = await createApiClient({ baseURL: 'https://staging.api.com' });
+ * const campaign = await fetchCampaign('123', {
+ *   apiClient: customClient,
+ *   apiConfig: { retry: { attempts: 5 } }
+ * });
+ * ```
+ */
+export interface ServiceOptions<TEndpoints = EndpointsList> {
+    /**
+     * Optional API client instance override
+     * Use this when you need a different client configuration
+     * The client should have all endpoints from EndpointsList
+     */
+    apiClient?: ApiClientWithEvents<ClientEventManager, TEndpoints>;
+    /**
+     * Optional API configuration updates
+     * By default applied with { strategy: 'temporary' } mode (affects only this request)
+     * Can be overridden via updateConfigOptions
+     */
+    apiConfig?: Partial<ApiConfig>;
+    /**
+     * Optional update config options
+     * Controls how apiConfig is applied to the client
+     *
+     * Defaults to: { strategy: 'temporary' }
+     * - 'temporary': Only affects this request (highest priority)
+     * - 'merge': Merges with client config (persists)
+     * - 'replace': Replaces client config (persists)
+     */
+    updateConfigOptions?: UpdateConfigOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/services/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/services/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU,GAAG,aAAa;IACxD;;;;OAIG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAEhE;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/B;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C"}

package/dist/api/strategies/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unified Strategies Module
+ * Convenience layer combining individual domain strategies
+ *
+ * @module strategies
+ */
+export { unifiedStrategies, applyUnifiedStrategy, getUnifiedStrategy, mergeUnifiedStrategy, isUnifiedStrategyName, getUnifiedStrategyNames, createCustomUnifiedStrategy, } from './unified';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,WAAW,CAAC"}

package/dist/api/strategies/tracked.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tracked Strategy Application
+ * Wrapper functions that apply strategies with conflict tracking
+ */
+import type { UnifiedStrategyName, UnifiedStrategyConfig } from '@plyaz/types/api';
+/**
+ * Apply unified strategy with conflict tracking
+ * This is the version that should be used in createApiClient
+ */
+export declare function applyTrackedUnifiedStrategy(strategyName: UnifiedStrategyName): UnifiedStrategyConfig;
+/**
+ * Get unified strategy with tracking (alternative API)
+ */
+export declare function getTrackedUnifiedStrategy(name: UnifiedStrategyName): UnifiedStrategyConfig;
+//# sourceMappingURL=tracked.d.ts.map

package/dist/api/strategies/tracked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/tracked.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAEV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,mBAAmB,GAChC,qBAAqB,CASvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,CAkC1F"}

package/dist/api/strategies/unified.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Unified API Strategies
+ * Combines individual strategies from different domains into convenient presets
+ *
+ * @module strategies/unified
+ */
+import type { UnifiedStrategyName, UnifiedStrategy, UnifiedStrategyConfig } from '@plyaz/types/api';
+export type { UnifiedStrategyName, UnifiedStrategy, UnifiedStrategyConfig } from '@plyaz/types/api';
+/**
+ * Unified strategies composed from individual domain strategies
+ * These are convenience presets - individual strategies remain the source of truth
+ *
+ * @example
+ * ```typescript
+ * import { createApiClient, unifiedStrategies } from '@plyaz/api';
+ *
+ * // Use unified strategy
+ * const api = createApiClient({ strategy: 'interactive' });
+ *
+ * // Or apply strategy configuration directly
+ * const config = applyUnifiedStrategy('background');
+ * ```
+ */
+export declare const unifiedStrategies: Readonly<Record<UnifiedStrategyName, UnifiedStrategy>>;
+/**
+ * Apply unified strategy configuration
+ * Resolves strategy names to actual configuration objects
+ *
+ * @param strategyName - Unified strategy name
+ * @returns Combined configuration from all domain strategies
+ *
+ * @example
+ * ```typescript
+ * const config = applyUnifiedStrategy('interactive');
+ * // Returns combined cache, retry, and polling configurations
+ * ```
+ */
+export declare function applyUnifiedStrategy(strategyName: UnifiedStrategyName): UnifiedStrategyConfig;
+/**
+ * Get unified strategy by name with fallback
+ *
+ * @param name - Strategy name
+ * @returns Strategy configuration or 'interactive' as fallback
+ */
+export declare function getUnifiedStrategy(name: UnifiedStrategyName): UnifiedStrategy;
+/**
+ * Merge unified strategy with overrides
+ * Allows overriding specific domains while keeping others from unified strategy
+ *
+ * @param strategyName - Base unified strategy name
+ * @param overrides - Domain-specific overrides
+ * @returns Merged strategy configuration
+ *
+ * @example
+ * ```typescript
+ * // Start with interactive strategy, but use aggressive retry
+ * const config = mergeUnifiedStrategy('interactive', {
+ *   retry: 'aggressive'
+ * });
+ * ```
+ */
+export declare function mergeUnifiedStrategy(strategyName: UnifiedStrategyName, overrides?: Partial<UnifiedStrategy>): UnifiedStrategy;
+/**
+ * Type guard to check if a value is a unified strategy name
+ */
+export declare function isUnifiedStrategyName(value: unknown): value is UnifiedStrategyName;
+/**
+ * Get all available unified strategy names
+ */
+export declare function getUnifiedStrategyNames(): UnifiedStrategyName[];
+/**
+ * Create a custom unified strategy
+ *
+ * @param name - Custom strategy name
+ * @param config - Strategy configuration
+ * @returns Custom strategy configuration
+ *
+ * @example
+ * ```typescript
+ * const customStrategy = createCustomUnifiedStrategy('fastApi', {
+ *   cache: 'shortLived',
+ *   retry: 'conservative'
+ * });
+ * ```
+ */
+export declare function createCustomUnifiedStrategy(name: string, config: UnifiedStrategy): Record<string, UnifiedStrategy>;
+//# sourceMappingURL=unified.d.ts.map

package/dist/api/strategies/unified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/unified.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAK1B,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEpG;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAsE3E,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,mBAAmB,GAAG,qBAAqB,CAS7F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CAyB7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,EACjC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GACvC,eAAe,CAOjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAEjC"}

package/dist/api/utils/async-control.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Async Control Utilities
+ * Generic utilities for controlling async operations like debouncing, throttling, and timeouts
+ */
+/**
+ * Generic debounce function
+ * Delays execution until after wait milliseconds have elapsed since the last invocation
+ *
+ * @param func - Function to debounce
+ * @param delay - Delay in milliseconds
+ * @returns Debounced function with cancel method
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = debounce((query: string) => {
+ *   search(query);
+ * }, 300);
+ *
+ * debouncedSearch('hello'); // Will execute after 300ms
+ * debouncedSearch('hello world'); // Previous call cancelled, this executes after 300ms
+ *
+ * // Cancel pending execution
+ * debouncedSearch.cancel();
+ * ```
+ */
+export declare function debounce<TArgs extends unknown[]>(func: (...args: TArgs) => void, delay: number): {
+    (...args: TArgs): void;
+    cancel: () => void;
+};
+/**
+ * Generic throttle function
+ * Limits function execution to at most once per limit milliseconds
+ *
+ * @param func - Function to throttle
+ * @param limit - Minimum time between executions (ms)
+ * @returns Throttled function
+ *
+ * @example
+ * ```typescript
+ * const throttledScroll = throttle((event: Event) => {
+ *   handleScroll(event);
+ * }, 100);
+ *
+ * window.addEventListener('scroll', throttledScroll);
+ * ```
+ */
+export declare function throttle<TArgs extends unknown[]>(func: (...args: TArgs) => void, limit: number): (...args: TArgs) => void;
+/**
+ * Execute function with timeout
+ * Automatically rejects after timeout period
+ *
+ * @param func - Async function to execute
+ * @param timeoutMs - Timeout in milliseconds
+ * @param timeoutError - Error to throw on timeout
+ * @returns Promise that resolves with function result or rejects on timeout
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   () => fetch('/api/slow-endpoint').then(r => r.json()),
+ *   5000,
+ *   new Error('Request timed out')
+ * );
+ * ```
+ */
+export declare function withTimeout<T>(func: () => Promise<T>, timeoutMs: number, timeoutError?: Error): Promise<T>;
+/**
+ * Create a delayed execution function
+ * Simple utility to delay function execution
+ *
+ * @param delay - Delay in milliseconds
+ * @returns Function that delays execution
+ *
+ * @example
+ * ```typescript
+ * const wait = createDelay(1000);
+ * await wait();
+ * console.log('Executed after 1 second');
+ * ```
+ */
+export declare function createDelay(delay: number): () => Promise<void>;
+/**
+ * Sleep/delay utility function
+ * Simple promise-based delay
+ *
+ * @param ms - Milliseconds to sleep
+ * @returns Promise that resolves after delay
+ *
+ * @example
+ * ```typescript
+ * await sleep(1000); // Wait 1 second
+ * console.log('Done waiting');
+ * ```
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=async-control.d.ts.map

package/dist/api/utils/async-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-control.d.ts","sourceRoot":"","sources":["../../../src/api/utils/async-control.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,OAAO,EAAE,EAC9C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC9B,KAAK,EAAE,MAAM,GACZ;IACD,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAsBA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,OAAO,EAAE,EAC9C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC9B,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CA4B1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,KAAK,GACnB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/api/utils/colors.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Color utilities for debug reporting
+ *
+ * Provides ANSI color codes for terminal output
+ */
+/**
+ * ANSI color codes
+ */
+export declare const COLORS: {
+    readonly reset: "\u001B[0m";
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+    readonly brightRed: "\u001B[91m";
+    readonly brightGreen: "\u001B[92m";
+    readonly brightYellow: "\u001B[93m";
+    readonly brightBlue: "\u001B[94m";
+    readonly brightMagenta: "\u001B[95m";
+    readonly brightCyan: "\u001B[96m";
+    readonly brightWhite: "\u001B[97m";
+    readonly bgRed: "\u001B[41m";
+    readonly bgGreen: "\u001B[42m";
+    readonly bgYellow: "\u001B[43m";
+    readonly bgBlue: "\u001B[44m";
+    readonly bgMagenta: "\u001B[45m";
+    readonly bgCyan: "\u001B[46m";
+    readonly bgWhite: "\u001B[47m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly blink: "\u001B[5m";
+    readonly reverse: "\u001B[7m";
+    readonly hidden: "\u001B[8m";
+    readonly strikethrough: "\u001B[9m";
+};
+/**
+ * Color helper functions
+ */
+export declare const color: {
+    success: (text: string) => string;
+    error: (text: string) => string;
+    warning: (text: string) => string;
+    info: (text: string) => string;
+    debug: (text: string) => string;
+    critical: (text: string) => string;
+    high: (text: string) => string;
+    medium: (text: string) => string;
+    low: (text: string) => string;
+    none: (text: string) => string;
+    bold: (text: string) => string;
+    underline: (text: string) => string;
+    dim: (text: string) => string;
+    code: (text: string) => string;
+    header: (text: string) => string;
+    subheader: (text: string) => string;
+    label: (text: string) => string;
+    value: (text: string) => string;
+    box: (text: string, colorCode?: "\u001B[36m") => string;
+    highlight: (text: string) => string;
+    score: (value: number, max?: number) => string;
+    percentage: (value: number) => string;
+    badge: (text: string, status: "success" | "error" | "warning" | "info") => string;
+    bullet: (text: string, level?: "primary" | "secondary" | "tertiary") => string;
+};
+/**
+ * Format table with colors
+ */
+export declare function colorTable(headers: string[], rows: string[][], options?: {
+    headerColor?: string;
+    borderColor?: string;
+    alternateRowColors?: boolean;
+}): string;
+/**
+ * Create a colored progress bar
+ */
+export declare function colorProgressBar(value: number, max: number, width?: number): string;
+/**
+ * Strip colors from text (useful for logging to files)
+ */
+export declare function stripColors(text: string): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/api/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/api/utils/colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CT,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;oBAEA,MAAM,KAAG,MAAM;kBACjB,MAAM,KAAG,MAAM;oBACb,MAAM,KAAG,MAAM;iBAClB,MAAM,KAAG,MAAM;kBACd,MAAM,KAAG,MAAM;qBAGZ,MAAM,KAAG,MAAM;iBACnB,MAAM,KAAG,MAAM;mBACb,MAAM,KAAG,MAAM;gBAClB,MAAM,KAAG,MAAM;iBACd,MAAM,KAAG,MAAM;iBAGf,MAAM,KAAG,MAAM;sBACV,MAAM,KAAG,MAAM;gBACrB,MAAM,KAAG,MAAM;iBACd,MAAM,KAAG,MAAM;mBAGb,MAAM,KAAG,MAAM;sBACZ,MAAM,KAAG,MAAM;kBACnB,MAAM,KAAG,MAAM;kBACf,MAAM,KAAG,MAAM;gBAGjB,MAAM,+BAA4B,MAAM;sBAClC,MAAM,KAAG,MAAM;mBAGlB,MAAM,QAAO,MAAM,KAAoB,MAAM;wBAYxC,MAAM,KAAG,MAAM;kBAWrB,MAAM,UAAU,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,KAAG,MAAM;mBAWhE,MAAM,UAAS,SAAS,GAAG,WAAW,GAAG,UAAU,KAAe,MAAM;CAaxF,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,GACA,MAAM,CAiDR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,MAAmC,GACzC,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD"}