@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/telegram/telegram.contract.d.ts

@@ -0,0 +1,727 @@
+import { z } from 'zod';
+export declare const TelegramLinkTokenResponseSchema: z.ZodObject<{
+    token: z.ZodString;
+    deepLink: z.ZodString;
+    expiresAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    expiresAt: string;
+    token: string;
+    deepLink: string;
+}, {
+    expiresAt: string;
+    token: string;
+    deepLink: string;
+}>;
+export declare const TelegramLinkRequestSchema: z.ZodObject<{
+    token: z.ZodString;
+    chatId: z.ZodString;
+    telegramUsername: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+    chatId: string;
+    telegramUsername?: string | null | undefined;
+}, {
+    token: string;
+    chatId: string;
+    telegramUsername?: string | null | undefined;
+}>;
+export declare const TelegramLinkSchema: z.ZodObject<{
+    userId: z.ZodString;
+    chatId: z.ZodString;
+    firstName: z.ZodString;
+    phone: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    phone: string | null;
+    firstName: string;
+    chatId: string;
+}, {
+    userId: string;
+    phone: string | null;
+    firstName: string;
+    chatId: string;
+}>;
+export type TelegramLinkTokenResponse = z.infer<typeof TelegramLinkTokenResponseSchema>;
+export type TelegramLink = z.infer<typeof TelegramLinkSchema>;
+export declare const telegramContract: {
+    createLinkToken: {
+        metadata: {
+            tags: string[];
+        };
+        summary: "Mint a single-use Telegram deep-link token for the current user";
+        method: "POST";
+        body: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        path: "/v2/users/me/telegram/link-token";
+        responses: {
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            201: z.ZodObject<{
+                token: z.ZodString;
+                deepLink: z.ZodString;
+                expiresAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                expiresAt: string;
+                token: string;
+                deepLink: string;
+            }, {
+                expiresAt: string;
+                token: string;
+                deepLink: string;
+            }>;
+        };
+    };
+    link: {
+        metadata: {
+            tags: string[];
+        };
+        summary: "Bind a Telegram chatId to the user owning the token (bot-authenticated)";
+        method: "POST";
+        body: z.ZodObject<{
+            token: z.ZodString;
+            chatId: z.ZodString;
+            telegramUsername: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            token: string;
+            chatId: string;
+            telegramUsername?: string | null | undefined;
+        }, {
+            token: string;
+            chatId: string;
+            telegramUsername?: string | null | undefined;
+        }>;
+        path: "/v2/telegram/link";
+        responses: {
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            200: z.ZodObject<{
+                userId: z.ZodString;
+                firstName: z.ZodString;
+                phone: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                userId: string;
+                phone: string | null;
+                firstName: string;
+            }, {
+                userId: string;
+                phone: string | null;
+                firstName: string;
+            }>;
+            404: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            410: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+        };
+    };
+    unlinkMe: {
+        metadata: {
+            tags: string[];
+        };
+        summary: "Unlink the current user from Telegram";
+        method: "DELETE";
+        body: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+        path: "/v2/users/me/telegram";
+        responses: {
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            200: z.ZodObject<{
+                ok: z.ZodLiteral<true>;
+            }, "strip", z.ZodTypeAny, {
+                ok: true;
+            }, {
+                ok: true;
+            }>;
+        };
+    };
+    unlinkChat: {
+        metadata: {
+            tags: string[];
+        };
+        pathParams: z.ZodObject<{
+            chatId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            chatId: string;
+        }, {
+            chatId: string;
+        }>;
+        summary: "Unlink by chatId (bot-authenticated; used when the bot is blocked)";
+        method: "DELETE";
+        body: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+        path: "/v2/telegram/links/:chatId";
+        responses: {
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            200: z.ZodObject<{
+                ok: z.ZodLiteral<true>;
+            }, "strip", z.ZodTypeAny, {
+                ok: true;
+            }, {
+                ok: true;
+            }>;
+        };
+    };
+    listLinks: {
+        metadata: {
+            tags: string[];
+        };
+        summary: "All linked users (bot boot hydration)";
+        method: "GET";
+        path: "/v2/telegram/links";
+        responses: {
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                message: string;
+                code: string;
+                path: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            200: z.ZodArray<z.ZodObject<{
+                userId: z.ZodString;
+                chatId: z.ZodString;
+                firstName: z.ZodString;
+                phone: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                userId: string;
+                phone: string | null;
+                firstName: string;
+                chatId: string;
+            }, {
+                userId: string;
+                phone: string | null;
+                firstName: string;
+                chatId: string;
+            }>, "many">;
+        };
+    };
+};
+//# sourceMappingURL=telegram.contract.d.ts.map