Replace build-time NEXT_PUBLIC_* environment variables with server-side runtime configuration. This allows changing the Pastel API URL without rebuilding the Docker image. **Changes:** - Add Next.js API proxy route at /api/pastel/[...path] for server-side proxying - Update API client to use proxy endpoint instead of direct API URL - Replace NEXT_PUBLIC_API_URL with server-side PASTEL_API_URL - Remove build arguments from Dockerfile (no longer needed) - Simplify docker-compose.yml to use runtime environment variables only - Update all .env files to reflect new configuration approach - Add comprehensive DOCKER.md documentation **Benefits:** - No rebuild required to change API URL - Same image works across all environments (dev/staging/prod) - Better security (API URL not exposed in client bundle) - Simpler deployment and configuration management **Migration:** Old: NEXT_PUBLIC_API_URL (build-time, embedded in bundle) New: PASTEL_API_URL (runtime, read by server proxy) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
247 lines
6.9 KiB
TypeScript
247 lines
6.9 KiB
TypeScript
import type {
|
|
ApiResponse,
|
|
ColorInfoRequest,
|
|
ColorInfoData,
|
|
ConvertFormatRequest,
|
|
ConvertFormatData,
|
|
ColorManipulationRequest,
|
|
ColorManipulationData,
|
|
ColorMixRequest,
|
|
ColorMixData,
|
|
RandomColorsRequest,
|
|
RandomColorsData,
|
|
DistinctColorsRequest,
|
|
DistinctColorsData,
|
|
GradientRequest,
|
|
GradientData,
|
|
ColorDistanceRequest,
|
|
ColorDistanceData,
|
|
ColorSortRequest,
|
|
ColorSortData,
|
|
ColorBlindnessRequest,
|
|
ColorBlindnessData,
|
|
TextColorRequest,
|
|
TextColorData,
|
|
NamedColorsData,
|
|
NamedColorSearchRequest,
|
|
NamedColorSearchData,
|
|
HealthData,
|
|
CapabilitiesData,
|
|
PaletteGenerateRequest,
|
|
PaletteGenerateData,
|
|
} from './types';
|
|
|
|
export class PastelAPIClient {
|
|
private baseURL: string;
|
|
|
|
constructor(baseURL?: string) {
|
|
// Use the Next.js API proxy route for runtime configuration
|
|
// This allows changing the backend API URL without rebuilding
|
|
this.baseURL = baseURL || '/api/pastel';
|
|
}
|
|
|
|
private async request<T>(
|
|
endpoint: string,
|
|
options?: RequestInit
|
|
): Promise<ApiResponse<T>> {
|
|
// Endpoint already includes /api/v1 prefix on backend,
|
|
// but our proxy route expects paths after /api/v1/
|
|
const url = `${this.baseURL}${endpoint}`;
|
|
|
|
try {
|
|
const response = await fetch(url, {
|
|
...options,
|
|
headers: {
|
|
'Content-Type': 'application/json',
|
|
...options?.headers,
|
|
},
|
|
});
|
|
|
|
const data = await response.json();
|
|
|
|
if (!response.ok) {
|
|
return {
|
|
success: false,
|
|
error: data.error || {
|
|
code: 'INTERNAL_ERROR',
|
|
message: 'An unknown error occurred',
|
|
},
|
|
};
|
|
}
|
|
|
|
return data;
|
|
} catch (error) {
|
|
return {
|
|
success: false,
|
|
error: {
|
|
code: 'NETWORK_ERROR',
|
|
message: error instanceof Error ? error.message : 'Network request failed',
|
|
},
|
|
};
|
|
}
|
|
}
|
|
|
|
// Color Information
|
|
async getColorInfo(request: ColorInfoRequest): Promise<ApiResponse<ColorInfoData>> {
|
|
return this.request<ColorInfoData>('/colors/info', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// Format Conversion
|
|
async convertFormat(request: ConvertFormatRequest): Promise<ApiResponse<ConvertFormatData>> {
|
|
return this.request<ConvertFormatData>('/colors/convert', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// Color Manipulation
|
|
async lighten(request: ColorManipulationRequest): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/lighten', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async darken(request: ColorManipulationRequest): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/darken', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async saturate(request: ColorManipulationRequest): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/saturate', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async desaturate(request: ColorManipulationRequest): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/desaturate', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async rotate(request: ColorManipulationRequest): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/rotate', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async complement(colors: string[]): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/complement', {
|
|
method: 'POST',
|
|
body: JSON.stringify({ colors }),
|
|
});
|
|
}
|
|
|
|
async grayscale(colors: string[]): Promise<ApiResponse<ColorManipulationData>> {
|
|
return this.request<ColorManipulationData>('/colors/grayscale', {
|
|
method: 'POST',
|
|
body: JSON.stringify({ colors }),
|
|
});
|
|
}
|
|
|
|
async mix(request: ColorMixRequest): Promise<ApiResponse<ColorMixData>> {
|
|
return this.request<ColorMixData>('/colors/mix', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// Color Generation
|
|
async generateRandom(request: RandomColorsRequest): Promise<ApiResponse<RandomColorsData>> {
|
|
return this.request<RandomColorsData>('/colors/random', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async generateDistinct(request: DistinctColorsRequest): Promise<ApiResponse<DistinctColorsData>> {
|
|
return this.request<DistinctColorsData>('/colors/distinct', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async generateGradient(request: GradientRequest): Promise<ApiResponse<GradientData>> {
|
|
return this.request<GradientData>('/colors/gradient', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// Color Analysis
|
|
async calculateDistance(request: ColorDistanceRequest): Promise<ApiResponse<ColorDistanceData>> {
|
|
return this.request<ColorDistanceData>('/colors/distance', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async sortColors(request: ColorSortRequest): Promise<ApiResponse<ColorSortData>> {
|
|
return this.request<ColorSortData>('/colors/sort', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// Accessibility
|
|
async simulateColorBlindness(request: ColorBlindnessRequest): Promise<ApiResponse<ColorBlindnessData>> {
|
|
return this.request<ColorBlindnessData>('/colors/colorblind', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
async getTextColor(request: TextColorRequest): Promise<ApiResponse<TextColorData>> {
|
|
return this.request<TextColorData>('/colors/textcolor', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// Named Colors
|
|
async getNamedColors(): Promise<ApiResponse<NamedColorsData>> {
|
|
return this.request<NamedColorsData>('/colors/names', {
|
|
method: 'GET',
|
|
});
|
|
}
|
|
|
|
async searchNamedColors(request: NamedColorSearchRequest): Promise<ApiResponse<NamedColorSearchData>> {
|
|
return this.request<NamedColorSearchData>('/colors/names/search', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
|
|
// System
|
|
async getHealth(): Promise<ApiResponse<HealthData>> {
|
|
return this.request<HealthData>('/health', {
|
|
method: 'GET',
|
|
});
|
|
}
|
|
|
|
async getCapabilities(): Promise<ApiResponse<CapabilitiesData>> {
|
|
return this.request<CapabilitiesData>('/capabilities', {
|
|
method: 'GET',
|
|
});
|
|
}
|
|
|
|
// Palette Generation
|
|
async generatePalette(request: PaletteGenerateRequest): Promise<ApiResponse<PaletteGenerateData>> {
|
|
return this.request<PaletteGenerateData>('/palettes/generate', {
|
|
method: 'POST',
|
|
body: JSON.stringify(request),
|
|
});
|
|
}
|
|
}
|
|
|
|
// Export singleton instance
|
|
export const pastelAPI = new PastelAPIClient();
|