init

Bin

2025-12-16 9e0b2ba2c317b1a86212f24cbae3195ad1f3dbfa

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
import { APIProxy } from "../api-proxy";
import type { ApiProviderConfig } from "./types";
 
let apiInstance: APIProxy<Record<string, unknown>> | null = null;
 
/**
 * Creates and initializes the API instance with the provided configuration.
 * This should be called once at application startup.
 *
 * @param config - Configuration for the API instance
 * @returns The initialized API instance
 */
export function createApiInstance(config: ApiProviderConfig): APIProxy<Record<string, unknown>> {
  if (apiInstance) {
    console.warn("API instance already exists. Returning existing instance.");
    return apiInstance;
  }
 
  apiInstance = new APIProxy({
    gateway: config.gateway,
    endpoints: config.endpoints,
    commonHeaders: config.commonHeaders,
    onRequestFinished: config.onRequestFinished,
    alwaysExpectJSON: config.alwaysExpectJSON,
    sharedParams: config.sharedParams,
    mockDelay: config.mockDelay,
    mockDisabled: config.mockDisabled,
  });
 
  return apiInstance;
}
 
/**
 * Gets the current API instance.
 * Throws an error if the instance has not been initialized.
 *
 * @returns The API instance
 * @throws {Error} If API instance is not initialized
 */
export function getApiInstance(): APIProxy<Record<string, unknown>> {
  if (!apiInstance) {
    throw new Error("API instance not initialized. Call createApiInstance first.");
  }
  return apiInstance;
}
 
/**
 * Resets the API instance (useful for testing).
 * This should not be used in production code.
 */
export function resetApiInstance(): void {
  apiInstance = null;
}
 
/**
 * Export singleton proxy that lazily gets the API instance.
 * This maintains backward compatibility with direct API imports.
 */
export const API = new Proxy({} as APIProxy<Record<string, unknown>>, {
  get(_target, prop) {
    const instance = getApiInstance();
    const value = instance[prop as keyof APIProxy<Record<string, unknown>>];
 
    // Bind methods to the instance
    if (typeof value === "function") {
      return value.bind(instance);
    }
 
    return value;
  },
});