@sulimenkoas/metaclient 26.5.1-lib

package/README.md

@@ -0,0 +1,37 @@
+# Metaclient
+
+Минимальный TypeScript-клиент для HTTP API MetaTerminal.
+
+## Установка
+
+```bash
+npm install @ptfin/metaclient
+```
+
+## Использование
+
+```ts
+import { createMetaClient } from '@ptfin/metaclient';
+
+const client = createMetaClient({
+  baseUrl: 'https://meta.example.com',
+  getToken: () => localStorage.getItem('metaToken'),
+});
+
+const response = await client.POST('/v1/auth/sign-in', {
+  body: {
+    login: 'user',
+    password: 'password',
+  },
+});
+```
+
+## Разработка
+
+```bash
+npm install
+npm run generate
+npm run build
+```
+
+OpenAPI-контракт лежит в `openapi/facade.openapi.json`.

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+import { type Client } from 'openapi-fetch';
+import type { paths } from './generated/schema.js';
+export interface MetaClientOptions {
+    baseUrl: string;
+    getToken?: () => string | null | undefined;
+    fetch?: typeof fetch;
+}
+export type MetaClient = Client<paths>;
+export declare const createMetaClient: (options: MetaClientOptions) => MetaClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAEvC,eAAO,MAAM,gBAAgB,GAAI,SAAS,iBAAiB,KAAG,UAmB7D,CAAC"}

package/dist/client.js

@@ -0,0 +1,18 @@
+import createClient from 'openapi-fetch';
+export const createMetaClient = (options) => {
+    const client = createClient({
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+    client.use({
+        async onRequest({ request }) {
+            const token = options.getToken?.();
+            if (token) {
+                request.headers.set('Authorization', `Bearer ${token}`);
+            }
+            return request;
+        },
+    });
+    return client;
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,YAA6B,MAAM,eAAe,CAAC;AAY1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAA0B,EAAc,EAAE;IACzE,MAAM,MAAM,GAAG,YAAY,CAAQ;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC;QACT,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;YACzB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YAEnC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/generated/schema.d.ts

@@ -0,0 +1,620 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/healthz": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Facade health check
+         * @description Simple health endpoint for the TypeScript facade service.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /**
+                                 * @description Health indicator
+                                 * @enum {string}
+                                 */
+                                status: "ok";
+                                /**
+                                 * @description Service name
+                                 * @enum {string}
+                                 */
+                                service: "facade";
+                                /** @description Public API version */
+                                version: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/auth/sign-in": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Authenticate user via the legacy backend and issue facade bearer token
+         * @description Validates user credentials against the legacy auth API, then returns a facade bearer token backed by the shared terminal_tokens session store.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            /** @description Credentials used to create a facade bearer token */
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description User login used by the legacy auth backend
+                         * @example demo@example.com
+                         */
+                        login: string;
+                        /**
+                         * @description Plain-text password for the user account
+                         * @example secret
+                         */
+                        password: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Successful authentication response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Created facade session */
+                            data: {
+                                /** @description Facade bearer token backed by the shared session table */
+                                accessToken: string;
+                                /**
+                                 * @description Authorization scheme for the access token
+                                 * @enum {string}
+                                 */
+                                tokenType: "Bearer";
+                                /** @description Normalized facade user */
+                                user: {
+                                    /** @description Internal user identifier from the shared session store */
+                                    id: number | string;
+                                    /** @description Login of the authenticated user */
+                                    login: string;
+                                    /** @description User type from the legacy auth model */
+                                    type: string | null;
+                                };
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/auth/sign-out": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Delete the current facade token from the shared session store
+         * @description Deletes the current token from the shared session store and clears the facade cookie if it was present in the request.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ok: boolean;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Resolve current user from the shared session store
+         * @description Reads the current bearer token or token cookie, resolves the shared session from Postgres, and returns a normalized user object.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Current authenticated user */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Normalized facade user */
+                            data: {
+                                /** @description Internal user identifier from the shared session store */
+                                id: number | string;
+                                /** @description Login of the authenticated user */
+                                login: string;
+                                /** @description User type from the legacy auth model */
+                                type: string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Describe the facade entrypoint
+         * @description Returns links to the generated OpenAPI document and Swagger UI for the current facade instance.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /**
+                                 * @description Facade service name
+                                 * @enum {string}
+                                 */
+                                name: "MetaTerminal Facade API";
+                                /**
+                                 * @description Public API version
+                                 * @enum {string}
+                                 */
+                                version: "v1";
+                                /** @description Swagger UI URL */
+                                docsUrl: string;
+                                /** @description Generated OpenAPI JSON URL */
+                                openapiUrl: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/accounts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List accounts from ptfin for the current user
+         * @description Uses the authenticated facade session to resolve the current user and fetches account data from the ptfin upstream, then normalizes the result.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of user accounts */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Accounts returned from ptfin and normalized by the facade */
+                            data: {
+                                /** @description Account identifier normalized by the facade */
+                                id: string | null;
+                                /** @description Human-readable account name when available */
+                                name: string | null;
+                                /** @description Broker or upstream source name */
+                                broker: string | null;
+                                /** @description Current account status from upstream data */
+                                status: string | null;
+                                /** @description Base account currency */
+                                currency: string | null;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/market-data/quotes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get normalized quote snapshots
+         * @description Requests quote snapshots from the legacy marketData API and maps the legacy quote fields into the public facade contract.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /**
+                     * @description Comma-separated symbols, e.g. AAPL,MSFT,SPY
+                     * @example AAPL,MSFT,SPY
+                     */
+                    symbols: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Market data response payload */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Quote snapshots for all requested symbols */
+                            data: {
+                                /** @description Ticker symbol */
+                                symbol: string;
+                                /** @description Latest traded price */
+                                price: number;
+                                /** @description Previous daily close when the upstream snapshot contains it */
+                                prevClose: number | null;
+                                /** @description Absolute change relative to previous close when available */
+                                change: number | null;
+                                /** @description Percentage change relative to previous close when available */
+                                changePercent: number | null;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @description Stable machine-readable error code */
+                                code: string;
+                                /** @description Human-readable error message */
+                                message: string;
+                                /** @description Optional structured details from the facade or upstream systems */
+                                details?: {
+                                    [key: string]: unknown;
+                                } | unknown[] | string | null;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/openapi.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: never;
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;
+//# sourceMappingURL=schema.d.ts.map