fahricansecer/iddaai-be
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

cr

Browse Source
This commit is contained in:
Fahri Can
2026-04-16 17:21:48 +03:00
parent c8fa4c442d
commit c8e7e4e927
116 changed files with 3720 additions and 4197 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/scripts/export-postman-collection.ts
+170 -165
View File
@@ -1,9 +1,9 @@
import 'reflect-metadata';
import { mkdirSync, writeFileSync } from 'node:fs';
import * as path from 'node:path';
import { NestFactory } from '@nestjs/core';
import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
import { AppModule } from '../app.module';
import "reflect-metadata";
import { mkdirSync, writeFileSync } from "node:fs";
import * as path from "node:path";
import { NestFactory } from "@nestjs/core";
import { DocumentBuilder, SwaggerModule } from "@nestjs/swagger";
import { AppModule } from "../app.module";
type JsonRecord = Record<string, unknown>;
type SwaggerPaths = Record<string, Record<string, JsonRecord>>;
@@ -14,7 +14,7 @@ interface PostmanResponse {
originalRequest: JsonRecord;
status: string;
code: number;
_postman_previewlanguage: 'json';
_postman_previewlanguage: "json";
header: Array<{ key: string; value: string }>;
body: string;
}
@@ -28,7 +28,7 @@ interface PostmanItem {
interface AiEndpointDefinition {
name: string;
method: 'GET' | 'POST';
method: "GET" | "POST";
path: string;
description: string;
query?: Array<{ key: string; value: string; description: string }>;
@@ -40,7 +40,7 @@ function refName(ref: string | undefined): string | null {
if (!ref) {
return null;
}
const parts = ref.split('/');
const parts = ref.split("/");
return parts[parts.length - 1] ?? null;
}
@@ -48,12 +48,13 @@ function resolveSchema(
schema: unknown,
schemas: SwaggerSchemas,
): JsonRecord | null {
if (!schema || typeof schema !== 'object') {
if (!schema || typeof schema !== "object") {
return null;
}
const schemaObject = schema as JsonRecord;
const schemaRef = typeof schemaObject.$ref === 'string' ? schemaObject.$ref : null;
const schemaRef =
typeof schemaObject.$ref === "string" ? schemaObject.$ref : null;
if (schemaRef) {
const name = refName(schemaRef);
return name ? (schemas[name] ?? null) : null;
@@ -73,31 +74,31 @@ function examplePrimitive(schema: JsonRecord): unknown {
return schema.enum[0];
}
const type = typeof schema.type === 'string' ? schema.type : 'string';
const format = typeof schema.format === 'string' ? schema.format : '';
const type = typeof schema.type === "string" ? schema.type : "string";
const format = typeof schema.format === "string" ? schema.format : "";
if (type === 'string') {
if (format === 'email') {
return 'user@example.com';
if (type === "string") {
if (format === "email") {
return "user@example.com";
}
if (format === 'date-time') {
return '2026-04-14T00:00:00.000Z';
if (format === "date-time") {
return "2026-04-14T00:00:00.000Z";
}
if (format === 'date') {
return '2026-04-14';
if (format === "date") {
return "2026-04-14";
}
if (format === 'uuid') {
return '11111111-1111-1111-1111-111111111111';
if (format === "uuid") {
return "11111111-1111-1111-1111-111111111111";
}
return 'string';
return "string";
}
if (type === 'integer' || type === 'number') {
if (type === "integer" || type === "number") {
return 1;
}
if (type === 'boolean') {
if (type === "boolean") {
return true;
}
return 'string';
return "string";
}
function buildExampleFromSchema(
@@ -110,7 +111,7 @@ function buildExampleFromSchema(
return null;
}
const schemaRef = typeof resolved.$ref === 'string' ? resolved.$ref : null;
const schemaRef = typeof resolved.$ref === "string" ? resolved.$ref : null;
if (schemaRef) {
const name = refName(schemaRef);
if (!name || visited.has(name)) {
@@ -124,7 +125,7 @@ function buildExampleFromSchema(
if (Array.isArray(resolved.allOf) && resolved.allOf.length > 0) {
return resolved.allOf.reduce<JsonRecord>((accumulator, part) => {
const partial = buildExampleFromSchema(part, schemas, visited);
if (partial && typeof partial === 'object' && !Array.isArray(partial)) {
if (partial && typeof partial === "object" && !Array.isArray(partial)) {
return { ...accumulator, ...(partial as JsonRecord) };
}
return accumulator;
@@ -139,12 +140,12 @@ function buildExampleFromSchema(
return buildExampleFromSchema(resolved.anyOf[0], schemas, visited);
}
const type = typeof resolved.type === 'string' ? resolved.type : 'object';
if (type === 'array') {
const type = typeof resolved.type === "string" ? resolved.type : "object";
if (type === "array") {
return [buildExampleFromSchema(resolved.items, schemas, visited)];
}
if (type === 'object' || resolved.properties) {
if (type === "object" || resolved.properties) {
const properties = (resolved.properties ?? {}) as JsonRecord;
const output: JsonRecord = {};
for (const [key, value] of Object.entries(properties)) {
@@ -159,23 +160,23 @@ function buildExampleFromSchema(
}
function swaggerSchemaFromContent(content: unknown): unknown {
if (!content || typeof content !== 'object') {
if (!content || typeof content !== "object") {
return null;
}
const contentObject = content as JsonRecord;
const jsonContent = contentObject['application/json'];
if (jsonContent && typeof jsonContent === 'object') {
const jsonContent = contentObject["application/json"];
if (jsonContent && typeof jsonContent === "object") {
return (jsonContent as JsonRecord).schema ?? null;
}
const firstContent = Object.values(contentObject)[0];
if (firstContent && typeof firstContent === 'object') {
if (firstContent && typeof firstContent === "object") {
return (firstContent as JsonRecord).schema ?? null;
}
return null;
}
function toPostmanPath(pathname: string): string {
return pathname.replace(/\{([^}]+)\}/g, '{{$1}}');
return pathname.replace(/\{([^}]+)\}/g, "{{$1}}");
}
function buildRequestBody(
@@ -213,25 +214,26 @@ function buildResponses(
name: `${method.toUpperCase()} ${rawPath} - ${statusCode}`,
originalRequest: {
method: method.toUpperCase(),
header: [{ key: 'Content-Type', value: 'application/json' }],
header: [{ key: "Content-Type", value: "application/json" }],
body: body
? {
mode: 'raw',
mode: "raw",
raw: body,
}
: undefined,
url: {
raw: `{{${baseUrlVariable}}}${toPostmanPath(rawPath)}`,
host: [`{{${baseUrlVariable}}}`],
path: rawPath.split('/').filter(Boolean),
path: rawPath.split("/").filter(Boolean),
},
},
status: typeof responseRecord.description === 'string'
? responseRecord.description
: `HTTP ${statusCode}`,
status:
typeof responseRecord.description === "string"
? responseRecord.description
: `HTTP ${statusCode}`,
code: Number.isFinite(numericStatus) ? numericStatus : 200,
_postman_previewlanguage: 'json',
header: [{ key: 'Content-Type', value: 'application/json' }],
_postman_previewlanguage: "json",
header: [{ key: "Content-Type", value: "application/json" }],
body: JSON.stringify(example ?? {}, null, 2),
};
});
@@ -243,14 +245,14 @@ function buildQueryParams(operation: JsonRecord): Array<JsonRecord> {
: [];
return parameters
.filter((parameter) => parameter.in === 'query')
.filter((parameter) => parameter.in === "query")
.map((parameter) => ({
key: String(parameter.name ?? ''),
key: String(parameter.name ?? ""),
value:
parameter.schema && typeof parameter.schema === 'object'
? String(((parameter.schema as JsonRecord).default ?? ''))
: '',
description: String(parameter.description ?? ''),
parameter.schema && typeof parameter.schema === "object"
? String((parameter.schema as JsonRecord).default ?? "")
: "",
description: String(parameter.description ?? ""),
disabled: parameter.required === true ? false : true,
}));
}
@@ -258,8 +260,8 @@ function buildQueryParams(operation: JsonRecord): Array<JsonRecord> {
function buildHeaders(operation: JsonRecord): Array<JsonRecord> {
const headers: Array<JsonRecord> = [
{
key: 'Content-Type',
value: 'application/json',
key: "Content-Type",
value: "application/json",
},
];
@@ -268,8 +270,8 @@ function buildHeaders(operation: JsonRecord): Array<JsonRecord> {
: [];
if (security.length > 0) {
headers.push({
key: 'Authorization',
value: 'Bearer {{accessToken}}',
key: "Authorization",
value: "Bearer {{accessToken}}",
});
}
@@ -292,20 +294,22 @@ function createRequestItem(
method: method.toUpperCase(),
header: headers,
description:
typeof operation.description === 'string'
typeof operation.description === "string"
? operation.description
: (typeof operation.summary === 'string' ? operation.summary : ''),
: typeof operation.summary === "string"
? operation.summary
: "",
url: {
raw: `{{${baseUrlVariable}}}${toPostmanPath(rawPath)}`,
host: [`{{${baseUrlVariable}}}`],
path: rawPath.split('/').filter(Boolean),
path: rawPath.split("/").filter(Boolean),
query,
},
};
if (body) {
request.body = {
mode: 'raw',
mode: "raw",
raw: body,
};
}
@@ -335,18 +339,19 @@ function buildNestFolders(document: JsonRecord): PostmanItem[] {
for (const [rawPath, pathItem] of Object.entries(paths)) {
for (const [method, operationObject] of Object.entries(pathItem)) {
if (!['get', 'post', 'put', 'patch', 'delete'].includes(method)) {
if (!["get", "post", "put", "patch", "delete"].includes(method)) {
continue;
}
const operation = operationObject as JsonRecord;
const operation = operationObject;
const tags = Array.isArray(operation.tags) ? operation.tags : [];
const folderName =
typeof tags[0] === 'string' && tags[0].trim().length > 0
typeof tags[0] === "string" && tags[0].trim().length > 0
? tags[0]
: 'Misc';
: "Misc";
const requestName =
typeof operation.summary === 'string' && operation.summary.trim().length > 0
typeof operation.summary === "string" &&
operation.summary.trim().length > 0
? operation.summary
: `${method.toUpperCase()} ${rawPath}`;
@@ -354,7 +359,7 @@ function buildNestFolders(document: JsonRecord): PostmanItem[] {
requestName,
method,
rawPath,
'beBaseUrl',
"beBaseUrl",
operation,
safeSchemas,
);
@@ -379,8 +384,8 @@ function createAiRequest(
): PostmanItem {
const url: JsonRecord = {
raw: `{{aiBaseUrl}}${endpoint.path}`,
host: ['{{aiBaseUrl}}'],
path: endpoint.path.split('/').filter(Boolean),
host: ["{{aiBaseUrl}}"],
path: endpoint.path.split("/").filter(Boolean),
};
if (endpoint.query && endpoint.query.length > 0) {
@@ -393,14 +398,14 @@ function createAiRequest(
const request: JsonRecord = {
method: endpoint.method,
header: [{ key: 'Content-Type', value: 'application/json' }],
header: [{ key: "Content-Type", value: "application/json" }],
description: endpoint.description,
url,
};
if (endpoint.body) {
request.body = {
mode: 'raw',
mode: "raw",
raw: JSON.stringify(endpoint.body, null, 2),
};
}
@@ -412,10 +417,10 @@ function createAiRequest(
{
name: `${endpoint.method} ${endpoint.path}`,
originalRequest: request,
status: 'OK',
status: "OK",
code: 200,
_postman_previewlanguage: 'json',
header: [{ key: 'Content-Type', value: 'application/json' }],
_postman_previewlanguage: "json",
header: [{ key: "Content-Type", value: "application/json" }],
body: JSON.stringify(endpoint.response, null, 2),
},
],
@@ -425,105 +430,105 @@ function createAiRequest(
function buildAiFolder(): PostmanItem {
const v20Endpoints: AiEndpointDefinition[] = [
{
name: 'Root',
method: 'GET',
path: '/',
description: 'AI engine root status endpoint',
name: "Root",
method: "GET",
path: "/",
description: "AI engine root status endpoint",
response: {
status: 'Suggest-Bet AI Engine v20+',
engine: 'V20 Plus Single Match Orchestrator',
status: "Suggest-Bet AI Engine v20+",
engine: "V20 Plus Single Match Orchestrator",
},
},
{
name: 'Health',
method: 'GET',
path: '/health',
description: 'AI engine health endpoint',
response: { status: 'healthy', engine: 'v20plus', ready: true },
name: "Health",
method: "GET",
path: "/health",
description: "AI engine health endpoint",
response: { status: "healthy", engine: "v20plus", ready: true },
},
{
name: 'Analyze Match',
method: 'POST',
path: '/v20plus/analyze/{{match_id}}',
description: 'Full V20+ single match analysis',
name: "Analyze Match",
method: "POST",
path: "/v20plus/analyze/{{match_id}}",
description: "Full V20+ single match analysis",
response: {
model_version: 'v30.0',
match_info: { match_id: '{{match_id}}' },
main_pick: { market: 'OU25', pick: '2.5 Üst' },
model_version: "v30.0",
match_info: { match_id: "{{match_id}}" },
main_pick: { market: "OU25", pick: "2.5 Üst" },
market_board: {},
},
},
{
name: 'Analyze HTMS',
method: 'GET',
path: '/v20plus/analyze-htms/{{match_id}}',
description: 'Half-time result analysis endpoint',
response: { match_id: '{{match_id}}', market: 'HT' },
name: "Analyze HTMS",
method: "GET",
path: "/v20plus/analyze-htms/{{match_id}}",
description: "Half-time result analysis endpoint",
response: { match_id: "{{match_id}}", market: "HT" },
},
{
name: 'Analyze HTFT',
method: 'GET',
path: '/v20plus/analyze-htft/{{match_id}}',
description: 'Half-time/full-time analysis endpoint',
name: "Analyze HTFT",
method: "GET",
path: "/v20plus/analyze-htft/{{match_id}}",
description: "Half-time/full-time analysis endpoint",
query: [
{
key: 'timeout_sec',
value: '30',
description: 'Timeout between 3 and 120 seconds',
key: "timeout_sec",
value: "30",
description: "Timeout between 3 and 120 seconds",
},
],
response: {
engine: 'v20plus.1',
match_info: { match_id: '{{match_id}}' },
ht_ft_probs: { '1/1': 0.25, 'X/X': 0.18 },
engine: "v20plus.1",
match_info: { match_id: "{{match_id}}" },
ht_ft_probs: { "1/1": 0.25, "X/X": 0.18 },
},
},
{
name: 'Generate Coupon',
method: 'POST',
path: '/v20plus/coupon',
description: 'Generate V20+ coupon from selected matches',
name: "Generate Coupon",
method: "POST",
path: "/v20plus/coupon",
description: "Generate V20+ coupon from selected matches",
body: {
match_ids: ['match-1', 'match-2'],
strategy: 'BALANCED',
match_ids: ["match-1", "match-2"],
strategy: "BALANCED",
max_matches: 4,
min_confidence: 55,
},
response: {
success: true,
data: {
strategy: 'BALANCED',
strategy: "BALANCED",
bets: [],
},
},
},
{
name: 'Daily Banker',
method: 'GET',
path: '/v20plus/daily-banker',
description: 'Get daily banker picks',
name: "Daily Banker",
method: "GET",
path: "/v20plus/daily-banker",
description: "Get daily banker picks",
query: [
{
key: 'count',
value: '3',
description: 'Number of banker picks',
key: "count",
value: "3",
description: "Number of banker picks",
},
],
response: { count: 3, bankers: [] },
},
{
name: 'Reversal Watchlist',
method: 'GET',
path: '/v20plus/reversal-watchlist',
description: 'Reversal watchlist candidates',
name: "Reversal Watchlist",
method: "GET",
path: "/v20plus/reversal-watchlist",
description: "Reversal watchlist candidates",
query: [
{ key: 'count', value: '20', description: 'Result size' },
{ key: 'horizon_hours', value: '72', description: 'Future horizon' },
{ key: 'min_score', value: '45', description: 'Minimum score' },
{ key: "count", value: "20", description: "Result size" },
{ key: "horizon_hours", value: "72", description: "Future horizon" },
{ key: "min_score", value: "45", description: "Minimum score" },
{
key: 'top_leagues_only',
value: 'false',
description: 'Filter to top leagues',
key: "top_leagues_only",
value: "false",
description: "Filter to top leagues",
},
],
response: { count: 0, items: [] },
@@ -532,42 +537,42 @@ function buildAiFolder(): PostmanItem {
const v2Endpoints: AiEndpointDefinition[] = [
{
name: 'V2 Health',
method: 'GET',
path: '/v2/health',
description: 'V2 betting engine health',
name: "V2 Health",
method: "GET",
path: "/v2/health",
description: "V2 betting engine health",
response: {
status: 'healthy',
engine: 'v2.betting_engine',
status: "healthy",
engine: "v2.betting_engine",
models_loaded: true,
},
},
{
name: 'V2 Analyze Match',
method: 'POST',
path: '/v2/analyze/{{match_id}}',
description: 'V2 leakage-free match analysis',
name: "V2 Analyze Match",
method: "POST",
path: "/v2/analyze/{{match_id}}",
description: "V2 leakage-free match analysis",
response: {
model_version: 'v2.betting_engine',
match_info: { match_id: '{{match_id}}' },
main_pick: { market: 'MS', pick: '1' },
model_version: "v2.betting_engine",
match_info: { match_id: "{{match_id}}" },
main_pick: { market: "MS", pick: "1" },
market_board: {
MS: { pick: '1', confidence: 58.4 },
MS: { pick: "1", confidence: 58.4 },
},
},
},
];
return {
name: 'AI Engine',
name: "AI Engine",
item: [
{
name: 'V20+',
item: v20Endpoints.map((endpoint) => createAiRequest(endpoint, 'V20+')),
name: "V20+",
item: v20Endpoints.map((endpoint) => createAiRequest(endpoint, "V20+")),
},
{
name: 'V2',
item: v2Endpoints.map((endpoint) => createAiRequest(endpoint, 'V2')),
name: "V2",
item: v2Endpoints.map((endpoint) => createAiRequest(endpoint, "V2")),
},
],
};
@@ -575,21 +580,21 @@ function buildAiFolder(): PostmanItem {
async function run(): Promise<void> {
const projectRoot = process.cwd();
const outputDir = path.join(projectRoot, 'mds');
const outputDir = path.join(projectRoot, "mds");
const outputFile = path.join(
outputDir,
'suggest-bet-platform.postman_collection.json',
"suggest-bet-platform.postman_collection.json",
);
process.env.REDIS_ENABLED = 'true';
process.env.REDIS_ENABLED = "true";
const app = await NestFactory.create(AppModule, { logger: false });
app.setGlobalPrefix('api');
app.setGlobalPrefix("api");
const swaggerConfig = new DocumentBuilder()
.setTitle('Suggest Bet Backend API')
.setDescription('Postman collection export source')
.setVersion('1.0')
.setTitle("Suggest Bet Backend API")
.setDescription("Postman collection export source")
.setVersion("1.0")
.addBearerAuth()
.build();
@@ -600,25 +605,25 @@ async function run(): Promise<void> {
const collection: JsonRecord = {
info: {
name: 'Suggest-Bet Platform API',
name: "Suggest-Bet Platform API",
description:
'Auto-generated Postman collection for Nest backend and AI engine endpoints.',
"Auto-generated Postman collection for Nest backend and AI engine endpoints.",
schema:
'https://schema.getpostman.com/json/collection/v2.1.0/collection.json',
"https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
},
variable: [
{ key: 'beBaseUrl', value: 'http://localhost:3005' },
{ key: 'aiBaseUrl', value: 'http://localhost:8000' },
{ key: 'accessToken', value: '' },
{ key: 'match_id', value: 'sample-match-id' },
{ key: "beBaseUrl", value: "http://localhost:3005" },
{ key: "aiBaseUrl", value: "http://localhost:8000" },
{ key: "accessToken", value: "" },
{ key: "match_id", value: "sample-match-id" },
],
auth: {
type: 'bearer',
bearer: [{ key: 'token', value: '{{accessToken}}', type: 'string' }],
type: "bearer",
bearer: [{ key: "token", value: "{{accessToken}}", type: "string" }],
},
item: [
{
name: 'Nest API',
name: "Nest API",
item: buildNestFolders(document),
},
buildAiFolder(),
@@ -626,7 +631,7 @@ async function run(): Promise<void> {
};
mkdirSync(outputDir, { recursive: true });
writeFileSync(outputFile, JSON.stringify(collection, null, 2), 'utf8');
writeFileSync(outputFile, JSON.stringify(collection, null, 2), "utf8");
await app.close();