@dapex-tech/elite-online-services 0.0.0-development

package/.npmrc.publish

@@ -0,0 +1,2 @@
+@dapex-tech:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}

package/.release.config.js

@@ -0,0 +1,17 @@
+module.exports = {
+  branches: ['main'],
+  tagFormat: 'sdk-v${version}',
+  plugins: [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/release-notes-generator',
+    [
+      '@semantic-release/npm',
+      {
+        pkgRoot: 'sdk',
+        npmPublish: true,
+        access: 'public',
+      },
+    ],
+    '@semantic-release/github',
+  ],
+};

package/README.md

@@ -0,0 +1,176 @@
+# 📦 @dapex-tech/elite-online-services
+
+A client library to connect with the **Elite Online App**.  
+This package provides a simple interface to request information from the **Elite Online REST API**.
+
+---
+
+## 🛠 API Coverage
+
+This client includes typed interfaces for the Elite Online REST API, including:
+
+- **MainService** → Core endpoints of Elite Online App
+- **SocketService** → Real-time events (if enabled)
+- **CancelablePromise** → Control async requests
+- **Request utilities** → Custom API requests
+
+---
+
+## 🚀 Installation
+
+Using **npm**:
+
+```bash
+npm install @dapex-tech/elite-online-services
+```
+
+Using **Yarn**:
+
+```bash
+yarn add @dapex-tech/elite-online-services
+```
+
+---
+
+## 🔑 Authentication
+
+Before making requests, configure the client with your **API key** or **auth token** (depending on how the Elite Online App issues credentials).
+
+```ts
+import { OpenAPI } from '@dapex-tech/elite-online-services';
+
+OpenAPI.TOKEN = 'your_api_token_here';
+OpenAPI.BASE = 'https://api.eliteonlineapp.com';
+```
+
+---
+
+## 📘 Usage Example
+
+### Import the client
+
+```ts
+import { MainService } from '@dapex-tech/elite-online-services';
+```
+
+### Make a request
+
+```ts
+async function run() {
+  try {
+    const data = await MainService.getUserProfile({ userId: 123 });
+    console.log('User profile:', data);
+  } catch (error) {
+    console.error('API error:', error);
+  }
+}
+
+run();
+```
+
+---
+
+## 🔌 Socket Usage
+
+This package includes a `SocketService` class that wraps **socket.io-client** and provides convenient methods to work with real-time events.
+
+### Import and Connect
+
+```ts
+import { SocketService } from '@dapex-tech/elite-online-services';
+
+const socket = new SocketService('https://your-api-base-url');
+
+// Connect to the socket
+socket.connect();
+
+// Disconnect when done
+// socket.disconnect();
+```
+
+### Sending and Receiving Messages
+
+```ts
+// Send a message
+socket.sendMessage('Hello world!');
+
+// Listen for incoming messages
+socket.onMessageReceived((data) => {
+  console.log('Message received:', data.text);
+});
+```
+
+### Updating and Listening to Location Events
+
+```ts
+// Emit a location update
+socket.updateLocation({ lat: 35.9185, lng: -110.7258, clientID: '12345' });
+
+// Listen for location updates from the server
+socket.onLocationUpdated((data) => {
+  console.log('Location updated:', data);
+});
+
+// Listen for all active client locations
+socket.onAllLocations((locations) => {
+  console.log('All locations:', locations);
+});
+```
+
+### Removing Listeners
+
+```ts
+// Remove a specific listener
+socket.offMessageReceived(myMessageHandler);
+
+// Or remove all listeners for an event
+socket.off('locationUpdated');
+```
+
+---
+
+## ⚙️ Configuration
+
+You can configure global client settings via `OpenAPI`:
+
+```ts
+import { OpenAPI } from '@dapex-tech/elite-online-services';
+
+OpenAPI.BASE = 'https://api.eliteonlineapp.com';
+OpenAPI.TOKEN = 'my-secret-token';
+OpenAPI.WITH_CREDENTIALS = true;
+```
+
+---
+
+## 📄 TypeScript Support
+
+The client is written in **TypeScript**, so you get full type definitions out of the box.
+
+```ts
+import { ApiResult } from '@dapex-tech/elite-online-services';
+
+const result: ApiResult = {
+  ok: true,
+  status: 200,
+  body: { message: 'success' },
+};
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome!
+
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Commit your changes (`git commit -m 'Add new feature'`)
+4. Push to your branch (`git push origin feature/my-feature`)
+5. Open a Pull Request
+
+---
+
+## 📜 License
+
+[MIT](./LICENSE) © 2025 Dapex Tech

package/core/ApiError.ts

@@ -0,0 +1,25 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+import type { ApiRequestOptions } from './ApiRequestOptions';
+import type { ApiResult } from './ApiResult';
+
+export class ApiError extends Error {
+    public readonly url: string;
+    public readonly status: number;
+    public readonly statusText: string;
+    public readonly body: any;
+    public readonly request: ApiRequestOptions;
+
+    constructor(request: ApiRequestOptions, response: ApiResult, message: string) {
+        super(message);
+
+        this.name = 'ApiError';
+        this.url = response.url;
+        this.status = response.status;
+        this.statusText = response.statusText;
+        this.body = response.body;
+        this.request = request;
+    }
+}

package/core/ApiRequestOptions.ts

@@ -0,0 +1,17 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+export type ApiRequestOptions = {
+    readonly method: 'GET' | 'PUT' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD' | 'PATCH';
+    readonly url: string;
+    readonly path?: Record<string, any>;
+    readonly cookies?: Record<string, any>;
+    readonly headers?: Record<string, any>;
+    readonly query?: Record<string, any>;
+    readonly formData?: Record<string, any>;
+    readonly body?: any;
+    readonly mediaType?: string;
+    readonly responseHeader?: string;
+    readonly errors?: Record<number, string>;
+};

package/core/ApiResult.ts

@@ -0,0 +1,11 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+export type ApiResult = {
+    readonly url: string;
+    readonly ok: boolean;
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: any;
+};

package/core/CancelablePromise.ts

@@ -0,0 +1,131 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+export class CancelError extends Error {
+
+    constructor(message: string) {
+        super(message);
+        this.name = 'CancelError';
+    }
+
+    public get isCancelled(): boolean {
+        return true;
+    }
+}
+
+export interface OnCancel {
+    readonly isResolved: boolean;
+    readonly isRejected: boolean;
+    readonly isCancelled: boolean;
+
+    (cancelHandler: () => void): void;
+}
+
+export class CancelablePromise<T> implements Promise<T> {
+    #isResolved: boolean;
+    #isRejected: boolean;
+    #isCancelled: boolean;
+    readonly #cancelHandlers: (() => void)[];
+    readonly #promise: Promise<T>;
+    #resolve?: (value: T | PromiseLike<T>) => void;
+    #reject?: (reason?: any) => void;
+
+    constructor(
+        executor: (
+            resolve: (value: T | PromiseLike<T>) => void,
+            reject: (reason?: any) => void,
+            onCancel: OnCancel
+        ) => void
+    ) {
+        this.#isResolved = false;
+        this.#isRejected = false;
+        this.#isCancelled = false;
+        this.#cancelHandlers = [];
+        this.#promise = new Promise<T>((resolve, reject) => {
+            this.#resolve = resolve;
+            this.#reject = reject;
+
+            const onResolve = (value: T | PromiseLike<T>): void => {
+                if (this.#isResolved || this.#isRejected || this.#isCancelled) {
+                    return;
+                }
+                this.#isResolved = true;
+                if (this.#resolve) this.#resolve(value);
+            };
+
+            const onReject = (reason?: any): void => {
+                if (this.#isResolved || this.#isRejected || this.#isCancelled) {
+                    return;
+                }
+                this.#isRejected = true;
+                if (this.#reject) this.#reject(reason);
+            };
+
+            const onCancel = (cancelHandler: () => void): void => {
+                if (this.#isResolved || this.#isRejected || this.#isCancelled) {
+                    return;
+                }
+                this.#cancelHandlers.push(cancelHandler);
+            };
+
+            Object.defineProperty(onCancel, 'isResolved', {
+                get: (): boolean => this.#isResolved,
+            });
+
+            Object.defineProperty(onCancel, 'isRejected', {
+                get: (): boolean => this.#isRejected,
+            });
+
+            Object.defineProperty(onCancel, 'isCancelled', {
+                get: (): boolean => this.#isCancelled,
+            });
+
+            return executor(onResolve, onReject, onCancel as OnCancel);
+        });
+    }
+
+    get [Symbol.toStringTag]() {
+        return "Cancellable Promise";
+    }
+
+    public then<TResult1 = T, TResult2 = never>(
+        onFulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,
+        onRejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null
+    ): Promise<TResult1 | TResult2> {
+        return this.#promise.then(onFulfilled, onRejected);
+    }
+
+    public catch<TResult = never>(
+        onRejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null
+    ): Promise<T | TResult> {
+        return this.#promise.catch(onRejected);
+    }
+
+    public finally(onFinally?: (() => void) | null): Promise<T> {
+        return this.#promise.finally(onFinally);
+    }
+
+    public cancel(): void {
+        if (this.#isResolved || this.#isRejected || this.#isCancelled) {
+            return;
+        }
+        this.#isCancelled = true;
+        if (this.#cancelHandlers.length) {
+            try {
+                for (const cancelHandler of this.#cancelHandlers) {
+                    cancelHandler();
+                }
+            } catch (error) {
+                console.warn('Cancellation threw an error', error);
+                return;
+            }
+        }
+        this.#cancelHandlers.length = 0;
+        if (this.#reject) this.#reject(new CancelError('Request aborted'));
+    }
+
+    public get isCancelled(): boolean {
+        return this.#isCancelled;
+    }
+}

package/core/OpenAPI.ts

@@ -0,0 +1,32 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+import type { ApiRequestOptions } from './ApiRequestOptions';
+
+type Resolver<T> = (options: ApiRequestOptions) => Promise<T>;
+type Headers = Record<string, string>;
+
+export type OpenAPIConfig = {
+    BASE: string;
+    VERSION: string;
+    WITH_CREDENTIALS: boolean;
+    CREDENTIALS: 'include' | 'omit' | 'same-origin';
+    TOKEN?: string | Resolver<string> | undefined;
+    USERNAME?: string | Resolver<string> | undefined;
+    PASSWORD?: string | Resolver<string> | undefined;
+    HEADERS?: Headers | Resolver<Headers> | undefined;
+    ENCODE_PATH?: ((path: string) => string) | undefined;
+};
+
+export const OpenAPI: OpenAPIConfig = {
+    BASE: '',
+    VERSION: '1.0',
+    WITH_CREDENTIALS: false,
+    CREDENTIALS: 'include',
+    TOKEN: undefined,
+    USERNAME: undefined,
+    PASSWORD: undefined,
+    HEADERS: undefined,
+    ENCODE_PATH: undefined,
+};

package/core/index.ts

@@ -0,0 +1,6 @@
+export * from './ApiError';
+export * from './ApiRequestOptions';
+export * from './ApiResult';
+export * from './CancelablePromise';
+export * from './OpenAPI';
+export * from './request';