| 
									
										
										
										
											2022-10-22 11:51:07 -08:00
										 |  |  | const parts = { | 
					
						
							|  |  |  |   host: "http://localhost.com", | 
					
						
							| 
									
										
										
										
											2023-02-11 21:26:10 -09:00
										 |  |  |   prefix: "", | 
					
						
							| 
									
										
										
										
											2022-10-22 11:51:07 -08:00
										 |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | export function overrideParts(host: string, prefix: string) { | 
					
						
							|  |  |  |   parts.host = host; | 
					
						
							|  |  |  |   parts.prefix = prefix; | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | export type QueryValue = string | string[] | number | number[] | boolean | null | undefined; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /** | 
					
						
							|  |  |  |  * route is a the main URL builder for the API. It will use a predefined host and prefix (global) | 
					
						
							|  |  |  |  * in the urls.ts file and then append the passed in path parameter uring the `URL` class from the | 
					
						
							|  |  |  |  * browser. It will also append any query parameters passed in as the second parameter. | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * The default host `http://localhost.com` is removed from the path if it is present. This allows us | 
					
						
							|  |  |  |  * to bootstrap the API with different hosts as needed (like for testing) but still allows us to use | 
					
						
							|  |  |  |  * relative URLs in production because the API and client bundle are served from the same server/host. | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | export function route(rest: string, params: Record<string, QueryValue> | null = null): string { | 
					
						
							|  |  |  |   const url = new URL(parts.prefix + rest, parts.host); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   if (params) { | 
					
						
							|  |  |  |     for (const [key, value] of Object.entries(params)) { | 
					
						
							|  |  |  |       if (Array.isArray(value)) { | 
					
						
							|  |  |  |         for (const item of value) { | 
					
						
							|  |  |  |           url.searchParams.append(key, String(item)); | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  |       } else { | 
					
						
							|  |  |  |         url.searchParams.append(key, String(value)); | 
					
						
							|  |  |  |       } | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  |   } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   return url.toString().replace("http://localhost.com", ""); | 
					
						
							|  |  |  | } |