@drttix/drt-sdk 1.4.2 → 1.4.5

package/src/scripts/build-all.ts

@@ -1,372 +1,380 @@
-import fs from 'fs';
-import path from 'path';
-import { execSync, execFileSync } from 'child_process';
-
-// On Windows, execFileSync with shell:true joins args without quoting, so paths
-// containing spaces are split. Use execSync with manual quoting on Windows instead.
-function runCommand(cmd: string, args: string[]): void {
-    if (process.platform === 'win32') {
-        const quotedArgs = args.map((a) => (a.includes(' ') ? `"${a}"` : a));
-        execSync([cmd, ...quotedArgs].join(' '), { stdio: 'inherit' });
-    } else {
-        execFileSync(cmd, args, { stdio: 'inherit' });
-    }
-}
-
-// Load the spec list (use staging specs when --staging flag is passed)
-const isStaging = process.argv.includes('--staging');
-const specsFile = isStaging
-    ? 'drt-api-specs-staging.json'
-    : 'drt-api-specs.json';
-const specsPath = path.resolve(specsFile);
-console.log(`📋 Using specs: ${specsFile}`);
-const specs = JSON.parse(fs.readFileSync(specsPath, 'utf-8')) as {
-    name: string;
-    url: string;
-}[];
-
-const GENERATED_BASE = path.resolve('src', 'generated');
-const INDEX_FILE = path.resolve('index.ts'); // <== write to project root
-
-// Platform-aware command names for Windows compatibility
-const NPX_CMD = process.platform === 'win32' ? 'npx.cmd' : 'npx';
-const CURL_CMD = process.platform === 'win32' ? 'curl.exe' : 'curl';
-
-for (const spec of specs) {
-    const { name, url } = spec;
-    const outputDir = path.join(GENERATED_BASE, name);
-
-    console.log(`\n🚧 Generating client for ${name}...`);
-
-    // Download spec to temp file first to avoid URL parsing issues
-    const tempSpecFile = path.join(process.cwd(), `${name}-spec.json`);
-    try {
-        console.log(`📥 Downloading spec from ${url}...`);
-        runCommand(CURL_CMD, ['-s', '-o', tempSpecFile, url]);
-
-        runCommand(NPX_CMD, [
-            'openapi-typescript-codegen',
-            '--input',
-            tempSpecFile,
-            '--output',
-            outputDir,
-            '--client',
-            'fetch',
-        ]);
-
-        // Clean up temp file
-        fs.unlinkSync(tempSpecFile);
-    } catch (error) {
-        console.error(`❌ Failed to generate client for ${name}`);
-        if (fs.existsSync(tempSpecFile)) {
-            fs.unlinkSync(tempSpecFile);
-        }
-        throw error;
-    }
-
-    console.log(`⚙️ Generating wrapper for ${name}...`);
-    runCommand(NPX_CMD, ['tsx', 'src/scripts/generate-definition.ts', name]);
-}
-
-// After generating all clients and definitions, replace request.ts for all services
-const customRequestPath = path.resolve('src/custom/custom-request.txt');
-const shopperRequestPath = path.resolve(
-    'src/generated/shopper/core/request.ts',
-);
-const portalRequestPath = path.resolve('src/generated/portal/core/request.ts');
-const scannerRequestPath = path.resolve(
-    'src/generated/scanner/core/request.ts',
-);
-
-const customRequestContent = fs.readFileSync(customRequestPath, 'utf-8');
-
-fs.writeFileSync(shopperRequestPath, customRequestContent);
-console.log('✅ Replaced shopper/core/request.ts with custom-request.txt');
-
-fs.writeFileSync(portalRequestPath, customRequestContent);
-console.log('✅ Replaced portal/core/request.ts with custom-request.txt');
-
-fs.writeFileSync(scannerRequestPath, customRequestContent);
-console.log('✅ Replaced scanner/core/request.ts with custom-request.txt');
-
-// Strip/rework credential params (shopperguid/accountid/apikey) from all generated service methods.
-//
-// Portal and scanner: DRT.init() injects these globally via OpenAPI.HEADERS,
-// so callers never need to pass them — params are removed entirely.
-//
-// Shopper: the three params collapse into a single optional trailing
-// `context?: { shopperGuid?: string; accountId?: string }` argument, resolved
-// per-call via resolveShopperHeaders(). This is what lets DRT.init({
-// shopperScope: 'per-request' }) serve many shoppers/accounts from one SDK
-// instance — see src/functions/sdkConfig.ts.
-console.log('⚙️  Stripping/reworking credential params in generated services...');
-
-// Finds each `public static <name>(<params>): <returnType> { <body> }` method
-// by tracking paren/brace nesting (a single regex can't express "matching
-// close paren/brace" when the body itself contains nested {}/() such as
-// `headers: {...}` or `path: {...}`). For any method whose body calls
-// resolveShopperHeaders(context) but whose parameter list doesn't already
-// declare a `context` param, appends `context?: { shopperGuid?: string;
-// accountId?: string }` as the last parameter.
-function patchMissingContextParam(src: string): string {
-    const methodStart = /public static \w+\(/g;
-    let result = '';
-    let cursor = 0;
-    let match: RegExpExecArray | null;
-
-    while ((match = methodStart.exec(src))) {
-        const parenOpen = match.index + match[0].length - 1;
-
-        // Walk from the opening '(' to its matching ')'.
-        let depth = 0;
-        let i = parenOpen;
-        for (; i < src.length; i++) {
-            if (src[i] === '(') depth++;
-            else if (src[i] === ')') {
-                depth--;
-                if (depth === 0) break;
-            }
-        }
-        const parenClose = i;
-
-        // Walk forward to the method's opening '{', then to its matching '}'.
-        const braceOpen = src.indexOf('{', parenClose);
-        depth = 0;
-        let j = braceOpen;
-        for (; j < src.length; j++) {
-            if (src[j] === '{') depth++;
-            else if (src[j] === '}') {
-                depth--;
-                if (depth === 0) break;
-            }
-        }
-        const braceClose = j;
-
-        const params = src.slice(parenOpen + 1, parenClose);
-        const body = src.slice(braceOpen + 1, braceClose);
-
-        if (/resolveShopperHeaders\(context\)/.test(body) && !/context\?:/.test(params)) {
-            // Indentation of an existing parameter line (the new param
-            // matches it); indentation of the ')' line (preserved as-is).
-            const paramIndentMatch = /\r?\n([^\S\r\n]+)\S/.exec(params);
-            const paramIndent = paramIndentMatch ? paramIndentMatch[1] : '        ';
-            const closeIndentMatch = /\r?\n([^\S\r\n]*)$/.exec(params);
-            const closeIndent = closeIndentMatch ? closeIndentMatch[1] : '    ';
-            const trimmedParams = params.replace(/[,\s]*$/, '');
-            const sep = trimmedParams.trim() ? ',\r\n' : '\r\n';
-            const newParams =
-                trimmedParams +
-                sep +
-                `${paramIndent}context?: { shopperGuid?: string; accountId?: string },\r\n${closeIndent}`;
-
-            result += src.slice(cursor, parenOpen + 1) + newParams;
-            cursor = parenClose;
-        }
-
-        methodStart.lastIndex = braceClose;
-    }
-
-    result += src.slice(cursor);
-    return result;
-}
-
-function walkServices(dir: string): string[] {
-    const results: string[] = [];
-    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-        const full = path.join(dir, entry.name);
-        if (entry.isDirectory()) results.push(...walkServices(full));
-        else if (
-            entry.isFile() &&
-            entry.name.endsWith('.ts') &&
-            dir.endsWith('services')
-        )
-            results.push(full);
-    }
-    return results;
-}
-const serviceFiles = walkServices(GENERATED_BASE);
-const shopperServicesDir = path.join(GENERATED_BASE, 'shopper', 'services');
-for (const file of serviceFiles) {
-    const isShopperService = file.startsWith(shopperServicesDir);
-    let src = fs.readFileSync(file, 'utf-8');
-    let patched: string;
-
-    if (isShopperService) {
-        patched = src
-            // Fold the shopperguid param into an optional context param
-            .replace(
-                /\n(\s*)shopperguid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
-                '\n$1context?: { shopperGuid?: string; accountId?: string },',
-            )
-            // accountid/apikey are resolved from context/DRT.init() instead
-            .replace(
-                /\n\s*accountid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
-                '',
-            )
-            .replace(
-                /\n\s*apikey: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
-                '',
-            )
-            // Rework @param jsdoc lines
-            .replace(
-                /\n(\s*)\* @param shopperguid[^\n]*/g,
-                '\n$1* @param context Optional per-call { shopperGuid, accountId } override. Falls back to the values passed to DRT.init().',
-            )
-            .replace(/\n\s*\* @param accountid[^\n]*/g, '')
-            .replace(/\n\s*\* @param apikey[^\n]*/g, '')
-            // Replace the credential header block with a resolver call. A few
-            // endpoints (e.g. DonationService.postDonation's ipAddress header)
-            // have an additional non-credential header — merge into those
-            // instead of emitting a second "headers:" key.
-            .replace(/\n\s*'shopperguid': shopperguid,/g, '')
-            .replace(/\n\s*'accountid': accountid,/g, '')
-            .replace(/\n\s*'apikey': apikey,/g, '')
-            .replace(
-                /headers: \{\s*\},/g,
-                'headers: resolveShopperHeaders(context),',
-            )
-            .replace(
-                /headers: \{\n(\s*)/g,
-                'headers: {\n$1...resolveShopperHeaders(context),\n$1',
-            )
-            // TS1016: a required parameter cannot follow an optional one.
-            // When context? was injected in place of shopperguid (which appeared
-            // before requestBody in the original spec), it ends up before a
-            // required requestBody param. Move context? to after requestBody.
-            // Note: blank "lines" between params may be orphaned \r chars (CRLF
-            // files lose the \n when accountid/apikey lines are stripped) — use
-            // [\r\n]+ to match any combination of CR/LF between the two params.
-            .replace(
-                /\n([^\S\n]+)context\?:\s*\{\s*shopperGuid\?:\s*string;\s*accountId\?:\s*string\s*\},[\r\n]+[^\S\n]+(requestBody:\s+[^?,\r\n][^,\r\n]*),/g,
-                (_, indent, rbPart) =>
-                    `\n${indent}${rbPart},\n${indent}context?: { shopperGuid?: string; accountId?: string },`,
-            );
-        // Some endpoints (e.g. Stripe's integrator-only calls) declare no
-        // shopperguid param, so the replace above never injects a `context`
-        // parameter into their signature — yet they still call
-        // resolveShopperHeaders(context) via the headers: {} replacement,
-        // leaving a dangling reference to an undeclared `context`. Add the
-        // param to any method signature whose body calls
-        // resolveShopperHeaders(context) but doesn't already declare one.
-        // Brace/paren nesting inside method bodies (headers: {...}, path:
-        // {...}, etc.) makes this unsafe to express as a single regex, so
-        // methods are located by tracking paren depth from `public static`
-        // through the matching close-paren of the parameter list, then brace
-        // depth from the following `{` through the matching method-closing
-        // `}`.
-        patched = patchMissingContextParam(patched);
-        if (patched !== src) {
-            patched = patched.replace(
-                "import { request as __request } from '../core/request';",
-                "import { request as __request } from '../core/request';\nimport { resolveShopperHeaders } from '../../../functions/sdkConfig';",
-            );
-        }
-    } else {
-        patched = src
-            // Remove param lines from function signatures
-            .replace(
-                /\n\s*shopperguid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
-                '',
-            )
-            .replace(
-                /\n\s*accountid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
-                '',
-            )
-            .replace(
-                /\n\s*apikey: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
-                '',
-            )
-            // Remove @param jsdoc lines
-            .replace(/\n\s*\* @param shopperguid[^\n]*/g, '')
-            .replace(/\n\s*\* @param accountid[^\n]*/g, '')
-            .replace(/\n\s*\* @param apikey[^\n]*/g, '')
-            // Remove header entries inside __request
-            .replace(/\n\s*'shopperguid': shopperguid,/g, '')
-            .replace(/\n\s*'accountid': accountid,/g, '')
-            .replace(/\n\s*'apikey': apikey,/g, '')
-            // Remove empty headers: {} blocks left behind
-            .replace(/\n\s*headers: \{\s*\},/g, '');
-    }
-
-    if (patched !== src) {
-        fs.writeFileSync(file, patched);
-    }
-}
-console.log(
-    `✅ Stripped/reworked credentials in ${serviceFiles.length} service files`,
-);
-
-// --- Patch portal ClientToolsTicketingLinkService to return Blob for generateFlyer
-// The AdminPortal Swagger declares this as binary/pdf but openapi-typescript-codegen
-// may still emit a non-Blob return type depending on the spec version. Patch as a safeguard.
-const flyerServicePath = path.resolve(
-    'src/generated/portal/services/ClientToolsTicketingLinkService.ts',
-);
-if (fs.existsSync(flyerServicePath)) {
-    let flyerSrc = fs.readFileSync(flyerServicePath, 'utf-8');
-    // Remove the SuccessResponse import if present (no longer needed for this file if it was only used here)
-    const patchedFlyerSrc = flyerSrc
-        .replace(
-            /import type \{ SuccessResponse \} from '\.\.\/models\/SuccessResponse';\n/g,
-            '',
-        )
-        .replace(
-            /\* @returns SuccessResponse [^\n]*\n(\s*\* @throws)/,
-            '* @returns binary Returns the generated PDF Flyer as a blob\n$1',
-        )
-        .replace(
-            /\): CancelablePromise<SuccessResponse> \{(\s*return __request\(OpenAPI, \{[\s\S]*?url: '\/client-tools\/ticketing-link\/flyer')/,
-            '): CancelablePromise<Blob> {$1',
-        );
-    if (patchedFlyerSrc !== flyerSrc) {
-        fs.writeFileSync(flyerServicePath, patchedFlyerSrc);
-        console.log('✅ Patched generateFlyer return type to Blob');
-    } else {
-        console.log('✅ generateFlyer already returns Blob (no patch needed)');
-    }
-}
-
-// --- Generate index.ts
-console.log(`🧩 Generating DRT index...`);
-
-const lines: string[] = [];
-lines.push('// AUTO-GENERATED FILE – DO NOT EDIT');
-lines.push('');
-
-for (const spec of specs) {
-    const name = spec.name.toLowerCase();
-    lines.push(`import { ${name} } from "./src/definitions/${name}";`);
-}
-lines.push(`import { setBaseUrlsOnce } from "./src/functions/setBaseURL";`);
-lines.push(
-    `import { init, isReady, getConfig, reset } from "./src/functions/sdkConfig";`,
-);
-lines.push('');
-
-// Re-export type namespaces for easy access
-for (const spec of specs) {
-    const name = spec.name.toLowerCase();
-    const typesNamespace =
-        name.charAt(0).toUpperCase() + name.slice(1) + 'Types';
-    lines.push(
-        `export { ${typesNamespace} } from "./src/definitions/${name}";`,
-    );
-}
-lines.push('');
-
-lines.push('export const DRT = {');
-for (const spec of specs) {
-    lines.push(`  ${spec.name.toLowerCase()},`);
-}
-lines.push('  init,');
-lines.push('  isReady,');
-lines.push('  getConfig,');
-lines.push('  reset,');
-lines.push('};');
-lines.push('');
-lines.push('setBaseUrlsOnce();');
-lines.push('');
-lines.push('export type DRT = typeof DRT;');
-
-fs.writeFileSync(INDEX_FILE, lines.join('\n'));
-console.log(`✅ Wrote DRT entrypoint to index.ts`);
+import fs from 'fs';
+import path from 'path';
+import { execSync, execFileSync } from 'child_process';
+
+// On Windows, execFileSync with shell:true joins args without quoting, so paths
+// containing spaces are split. Use execSync with manual quoting on Windows instead.
+function runCommand(cmd: string, args: string[]): void {
+    if (process.platform === 'win32') {
+        const quotedArgs = args.map((a) => (a.includes(' ') ? `"${a}"` : a));
+        execSync([cmd, ...quotedArgs].join(' '), { stdio: 'inherit' });
+    } else {
+        execFileSync(cmd, args, { stdio: 'inherit' });
+    }
+}
+
+// Load the spec list (use staging specs when --staging flag is passed)
+const isStaging = process.argv.includes('--staging');
+const specsFile = isStaging
+    ? 'drt-api-specs-staging.json'
+    : 'drt-api-specs.json';
+const specsPath = path.resolve(specsFile);
+console.log(`📋 Using specs: ${specsFile}`);
+const specs = JSON.parse(fs.readFileSync(specsPath, 'utf-8')) as {
+    name: string;
+    url: string;
+}[];
+
+const GENERATED_BASE = path.resolve('src', 'generated');
+const INDEX_FILE = path.resolve('index.ts'); // <== write to project root
+
+// Platform-aware command names for Windows compatibility
+const NPX_CMD = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+const CURL_CMD = process.platform === 'win32' ? 'curl.exe' : 'curl';
+
+for (const spec of specs) {
+    const { name, url } = spec;
+    const outputDir = path.join(GENERATED_BASE, name);
+
+    console.log(`\n🚧 Generating client for ${name}...`);
+
+    // Download spec to temp file first to avoid URL parsing issues
+    const tempSpecFile = path.join(process.cwd(), `${name}-spec.json`);
+    try {
+        console.log(`📥 Downloading spec from ${url}...`);
+        runCommand(CURL_CMD, ['-f', '-s', '-o', tempSpecFile, url]);
+
+        // Validate the downloaded file is valid JSON
+        const specContent = fs.readFileSync(tempSpecFile, 'utf-8');
+        try {
+            JSON.parse(specContent);
+        } catch (parseError) {
+            throw new Error(`Downloaded spec is not valid JSON. This often means the endpoint returned an error (e.g., 502, 404). Check that ${url} is accessible and returning a valid OpenAPI spec.`);
+        }
+
+        runCommand(NPX_CMD, [
+            'openapi-typescript-codegen',
+            '--input',
+            tempSpecFile,
+            '--output',
+            outputDir,
+            '--client',
+            'fetch',
+        ]);
+
+        // Clean up temp file
+        fs.unlinkSync(tempSpecFile);
+    } catch (error) {
+        console.error(`❌ Failed to generate client for ${name}`);
+        if (fs.existsSync(tempSpecFile)) {
+            fs.unlinkSync(tempSpecFile);
+        }
+        throw error;
+    }
+
+    console.log(`⚙️ Generating wrapper for ${name}...`);
+    runCommand(NPX_CMD, ['tsx', 'src/scripts/generate-definition.ts', name]);
+}
+
+// After generating all clients and definitions, replace request.ts for all services
+const customRequestPath = path.resolve('src/custom/custom-request.txt');
+const shopperRequestPath = path.resolve(
+    'src/generated/shopper/core/request.ts',
+);
+const portalRequestPath = path.resolve('src/generated/portal/core/request.ts');
+const scannerRequestPath = path.resolve(
+    'src/generated/scanner/core/request.ts',
+);
+
+const customRequestContent = fs.readFileSync(customRequestPath, 'utf-8');
+
+fs.writeFileSync(shopperRequestPath, customRequestContent);
+console.log('✅ Replaced shopper/core/request.ts with custom-request.txt');
+
+fs.writeFileSync(portalRequestPath, customRequestContent);
+console.log('✅ Replaced portal/core/request.ts with custom-request.txt');
+
+fs.writeFileSync(scannerRequestPath, customRequestContent);
+console.log('✅ Replaced scanner/core/request.ts with custom-request.txt');
+
+// Strip/rework credential params (shopperguid/accountid/apikey) from all generated service methods.
+//
+// Portal and scanner: DRT.init() injects these globally via OpenAPI.HEADERS,
+// so callers never need to pass them — params are removed entirely.
+//
+// Shopper: the three params collapse into a single optional trailing
+// `context?: { shopperGuid?: string; accountId?: string }` argument, resolved
+// per-call via resolveShopperHeaders(). This is what lets DRT.init({
+// shopperScope: 'per-request' }) serve many shoppers/accounts from one SDK
+// instance — see src/functions/sdkConfig.ts.
+console.log('⚙️  Stripping/reworking credential params in generated services...');
+
+// Finds each `public static <name>(<params>): <returnType> { <body> }` method
+// by tracking paren/brace nesting (a single regex can't express "matching
+// close paren/brace" when the body itself contains nested {}/() such as
+// `headers: {...}` or `path: {...}`). For any method whose body calls
+// resolveShopperHeaders(context) but whose parameter list doesn't already
+// declare a `context` param, appends `context?: { shopperGuid?: string;
+// accountId?: string }` as the last parameter.
+function patchMissingContextParam(src: string): string {
+    const methodStart = /public static \w+\(/g;
+    let result = '';
+    let cursor = 0;
+    let match: RegExpExecArray | null;
+
+    while ((match = methodStart.exec(src))) {
+        const parenOpen = match.index + match[0].length - 1;
+
+        // Walk from the opening '(' to its matching ')'.
+        let depth = 0;
+        let i = parenOpen;
+        for (; i < src.length; i++) {
+            if (src[i] === '(') depth++;
+            else if (src[i] === ')') {
+                depth--;
+                if (depth === 0) break;
+            }
+        }
+        const parenClose = i;
+
+        // Walk forward to the method's opening '{', then to its matching '}'.
+        const braceOpen = src.indexOf('{', parenClose);
+        depth = 0;
+        let j = braceOpen;
+        for (; j < src.length; j++) {
+            if (src[j] === '{') depth++;
+            else if (src[j] === '}') {
+                depth--;
+                if (depth === 0) break;
+            }
+        }
+        const braceClose = j;
+
+        const params = src.slice(parenOpen + 1, parenClose);
+        const body = src.slice(braceOpen + 1, braceClose);
+
+        if (/resolveShopperHeaders\(context\)/.test(body) && !/context\?:/.test(params)) {
+            // Indentation of an existing parameter line (the new param
+            // matches it); indentation of the ')' line (preserved as-is).
+            const paramIndentMatch = /\r?\n([^\S\r\n]+)\S/.exec(params);
+            const paramIndent = paramIndentMatch ? paramIndentMatch[1] : '        ';
+            const closeIndentMatch = /\r?\n([^\S\r\n]*)$/.exec(params);
+            const closeIndent = closeIndentMatch ? closeIndentMatch[1] : '    ';
+            const trimmedParams = params.replace(/[,\s]*$/, '');
+            const sep = trimmedParams.trim() ? ',\r\n' : '\r\n';
+            const newParams =
+                trimmedParams +
+                sep +
+                `${paramIndent}context?: { shopperGuid?: string; accountId?: string },\r\n${closeIndent}`;
+
+            result += src.slice(cursor, parenOpen + 1) + newParams;
+            cursor = parenClose;
+        }
+
+        methodStart.lastIndex = braceClose;
+    }
+
+    result += src.slice(cursor);
+    return result;
+}
+
+function walkServices(dir: string): string[] {
+    const results: string[] = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) results.push(...walkServices(full));
+        else if (
+            entry.isFile() &&
+            entry.name.endsWith('.ts') &&
+            dir.endsWith('services')
+        )
+            results.push(full);
+    }
+    return results;
+}
+const serviceFiles = walkServices(GENERATED_BASE);
+const shopperServicesDir = path.join(GENERATED_BASE, 'shopper', 'services');
+for (const file of serviceFiles) {
+    const isShopperService = file.startsWith(shopperServicesDir);
+    let src = fs.readFileSync(file, 'utf-8');
+    let patched: string;
+
+    if (isShopperService) {
+        patched = src
+            // Fold the shopperguid param into an optional context param
+            .replace(
+                /\n(\s*)shopperguid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
+                '\n$1context?: { shopperGuid?: string; accountId?: string },',
+            )
+            // accountid/apikey are resolved from context/DRT.init() instead
+            .replace(
+                /\n\s*accountid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
+                '',
+            )
+            .replace(
+                /\n\s*apikey: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
+                '',
+            )
+            // Rework @param jsdoc lines
+            .replace(
+                /\n(\s*)\* @param shopperguid[^\n]*/g,
+                '\n$1* @param context Optional per-call { shopperGuid, accountId } override. Falls back to the values passed to DRT.init().',
+            )
+            .replace(/\n\s*\* @param accountid[^\n]*/g, '')
+            .replace(/\n\s*\* @param apikey[^\n]*/g, '')
+            // Replace the credential header block with a resolver call. A few
+            // endpoints (e.g. DonationService.postDonation's ipAddress header)
+            // have an additional non-credential header — merge into those
+            // instead of emitting a second "headers:" key.
+            .replace(/\n\s*'shopperguid': shopperguid,/g, '')
+            .replace(/\n\s*'accountid': accountid,/g, '')
+            .replace(/\n\s*'apikey': apikey,/g, '')
+            .replace(
+                /headers: \{\s*\},/g,
+                'headers: resolveShopperHeaders(context),',
+            )
+            .replace(
+                /headers: \{\n(\s*)/g,
+                'headers: {\n$1...resolveShopperHeaders(context),\n$1',
+            )
+            // TS1016: a required parameter cannot follow an optional one.
+            // When context? was injected in place of shopperguid (which appeared
+            // before requestBody in the original spec), it ends up before a
+            // required requestBody param. Move context? to after requestBody.
+            // Note: blank "lines" between params may be orphaned \r chars (CRLF
+            // files lose the \n when accountid/apikey lines are stripped) — use
+            // [\r\n]+ to match any combination of CR/LF between the two params.
+            .replace(
+                /\n([^\S\n]+)context\?:\s*\{\s*shopperGuid\?:\s*string;\s*accountId\?:\s*string\s*\},[\r\n]+[^\S\n]+(requestBody:\s+[^?,\r\n][^,\r\n]*),/g,
+                (_, indent, rbPart) =>
+                    `\n${indent}${rbPart},\n${indent}context?: { shopperGuid?: string; accountId?: string },`,
+            );
+        // Some endpoints (e.g. Stripe's integrator-only calls) declare no
+        // shopperguid param, so the replace above never injects a `context`
+        // parameter into their signature — yet they still call
+        // resolveShopperHeaders(context) via the headers: {} replacement,
+        // leaving a dangling reference to an undeclared `context`. Add the
+        // param to any method signature whose body calls
+        // resolveShopperHeaders(context) but doesn't already declare one.
+        // Brace/paren nesting inside method bodies (headers: {...}, path:
+        // {...}, etc.) makes this unsafe to express as a single regex, so
+        // methods are located by tracking paren depth from `public static`
+        // through the matching close-paren of the parameter list, then brace
+        // depth from the following `{` through the matching method-closing
+        // `}`.
+        patched = patchMissingContextParam(patched);
+        if (patched !== src) {
+            patched = patched.replace(
+                "import { request as __request } from '../core/request';",
+                "import { request as __request } from '../core/request';\nimport { resolveShopperHeaders } from '../../../functions/sdkConfig';",
+            );
+        }
+    } else {
+        patched = src
+            // Remove param lines from function signatures
+            .replace(
+                /\n\s*shopperguid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
+                '',
+            )
+            .replace(
+                /\n\s*accountid: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
+                '',
+            )
+            .replace(
+                /\n\s*apikey: string(?:\s*\|\s*undefined)?\s*(?:=\s*undefined)?,/g,
+                '',
+            )
+            // Remove @param jsdoc lines
+            .replace(/\n\s*\* @param shopperguid[^\n]*/g, '')
+            .replace(/\n\s*\* @param accountid[^\n]*/g, '')
+            .replace(/\n\s*\* @param apikey[^\n]*/g, '')
+            // Remove header entries inside __request
+            .replace(/\n\s*'shopperguid': shopperguid,/g, '')
+            .replace(/\n\s*'accountid': accountid,/g, '')
+            .replace(/\n\s*'apikey': apikey,/g, '')
+            // Remove empty headers: {} blocks left behind
+            .replace(/\n\s*headers: \{\s*\},/g, '');
+    }
+
+    if (patched !== src) {
+        fs.writeFileSync(file, patched);
+    }
+}
+console.log(
+    `✅ Stripped/reworked credentials in ${serviceFiles.length} service files`,
+);
+
+// --- Patch portal ClientToolsTicketingLinkService to return Blob for generateFlyer
+// The AdminPortal Swagger declares this as binary/pdf but openapi-typescript-codegen
+// may still emit a non-Blob return type depending on the spec version. Patch as a safeguard.
+const flyerServicePath = path.resolve(
+    'src/generated/portal/services/ClientToolsTicketingLinkService.ts',
+);
+if (fs.existsSync(flyerServicePath)) {
+    let flyerSrc = fs.readFileSync(flyerServicePath, 'utf-8');
+    // Remove the SuccessResponse import if present (no longer needed for this file if it was only used here)
+    const patchedFlyerSrc = flyerSrc
+        .replace(
+            /import type \{ SuccessResponse \} from '\.\.\/models\/SuccessResponse';\n/g,
+            '',
+        )
+        .replace(
+            /\* @returns SuccessResponse [^\n]*\n(\s*\* @throws)/,
+            '* @returns binary Returns the generated PDF Flyer as a blob\n$1',
+        )
+        .replace(
+            /\): CancelablePromise<SuccessResponse> \{(\s*return __request\(OpenAPI, \{[\s\S]*?url: '\/client-tools\/ticketing-link\/flyer')/,
+            '): CancelablePromise<Blob> {$1',
+        );
+    if (patchedFlyerSrc !== flyerSrc) {
+        fs.writeFileSync(flyerServicePath, patchedFlyerSrc);
+        console.log('✅ Patched generateFlyer return type to Blob');
+    } else {
+        console.log('✅ generateFlyer already returns Blob (no patch needed)');
+    }
+}
+
+// --- Generate index.ts
+console.log(`🧩 Generating DRT index...`);
+
+const lines: string[] = [];
+lines.push('// AUTO-GENERATED FILE – DO NOT EDIT');
+lines.push('');
+
+for (const spec of specs) {
+    const name = spec.name.toLowerCase();
+    lines.push(`import { ${name} } from "./src/definitions/${name}";`);
+}
+lines.push(`import { setBaseUrlsOnce } from "./src/functions/setBaseURL";`);
+lines.push(
+    `import { init, isReady, getConfig, reset } from "./src/functions/sdkConfig";`,
+);
+lines.push('');
+
+// Re-export type namespaces for easy access
+for (const spec of specs) {
+    const name = spec.name.toLowerCase();
+    const typesNamespace =
+        name.charAt(0).toUpperCase() + name.slice(1) + 'Types';
+    lines.push(
+        `export { ${typesNamespace} } from "./src/definitions/${name}";`,
+    );
+}
+lines.push('');
+
+lines.push('export const DRT = {');
+for (const spec of specs) {
+    lines.push(`  ${spec.name.toLowerCase()},`);
+}
+lines.push('  init,');
+lines.push('  isReady,');
+lines.push('  getConfig,');
+lines.push('  reset,');
+lines.push('};');
+lines.push('');
+lines.push('setBaseUrlsOnce();');
+lines.push('');
+lines.push('export type DRT = typeof DRT;');
+
+fs.writeFileSync(INDEX_FILE, lines.join('\n'));
+console.log(`✅ Wrote DRT entrypoint to index.ts`);