fix(cli, typescript): Fix ts local github generation to match remote generation

.gitignore

@@ -85,4 +85,6 @@ seed/python-sdk/**/output.prof
 .yarn-cache
 .pnpm-cache
 
-**/vitest.config.ts.*.mjs
+**/vitest.config.ts.*.mjs
+
+.local

generators/base/src/AbstractGeneratorAgent.ts

@@ -72,7 +72,7 @@ export abstract class AbstractGeneratorAgent<GeneratorContext extends AbstractGe
     }): Promise<string> {
         const readmeConfig = this.getReadmeConfig({
             context,
-            remote: this.getRemote(),
+            remote: this.getRemote(context),
             featureConfig: await this.readFeatureConfig(),
             endpointSnippets
         });
@@ -127,17 +127,41 @@ export abstract class AbstractGeneratorAgent<GeneratorContext extends AbstractGe
         return loaded;
     }
 
-    protected getRemote(): FernGeneratorCli.Remote | undefined {
+    protected getRemote(context: GeneratorContext): FernGeneratorCli.Remote | undefined {
         const outputMode = this.config.output.mode.type === "github" ? this.config.output.mode : undefined;
         if (outputMode?.repoUrl != null && outputMode?.installationToken != null) {
             return FernGeneratorCli.Remote.github({
                 repoUrl: outputMode.repoUrl,
                 installationToken: outputMode.installationToken
             });
         }
+
+        const githubConfig = this.getGitHubConfig({ context });
+        if (githubConfig.uri != null && githubConfig.token != null) {
+            return FernGeneratorCli.Remote.github({
+                repoUrl: this.normalizeRepoUrl(githubConfig.uri),
+                installationToken: githubConfig.token
+            });
+        }
+
         return undefined;
     }
 
+    private normalizeRepoUrl(repoUrl: string): string {
+        // If it's already a full URL, return as-is
+        if (repoUrl.startsWith("https://")) {
+            return repoUrl;
+        }
+
+        // If it's in owner/repo format, convert to full GitHub URL
+        if (repoUrl.match(/^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_-]+$/)) {
+            return `https://github.com/${repoUrl}`;
+        }
+
+        // Default: assume it's a GitHub URL and add prefix
+        return `https://github.com/${repoUrl}`;
+    }
+
     private async getFeaturesConfig(): Promise<string> {
         // try to find the features.yml file using the well-known paths
         for (const each of FEATURES_CONFIG_PATHS) {

generators/swift/sdk/src/SwiftGeneratorAgent.ts

@@ -40,7 +40,7 @@ export class SwiftGeneratorAgent extends AbstractGeneratorAgent<SdkGeneratorCont
     }): Promise<string> {
         const readmeConfig = this.getReadmeConfig({
             context,
-            remote: this.getRemote(),
+            remote: this.getRemote(context),
             featureConfig: await this.readFeatureConfig(),
             endpointSnippets
         });

generators/typescript-v2/ast/src/custom-config/TypescriptCustomConfigSchema.ts

@@ -64,7 +64,10 @@ export const TypescriptCustomConfigSchema = z.strictObject({
 
     // deprecated
     timeoutInSeconds: z.optional(z.union([z.literal("infinity"), z.number()])),
-    includeApiReference: z.optional(z.boolean())
+    includeApiReference: z.optional(z.boolean()),
+
+    // internal - license name extracted from custom license file
+    _fernLicenseName: z.optional(z.string())
 });
 
 export type TypescriptCustomConfigSchema = z.infer<typeof TypescriptCustomConfigSchema>;

generators/typescript-v2/browser-compatible-base/src/utils/constructNpmPackage.ts

@@ -1,6 +1,32 @@
 import { FernGeneratorExec } from "@fern-fern/generator-exec-sdk";
 
 import { type NpmPackage } from "../NpmPackage";
+import { PublishInfo } from "../PublishInfo";
+
+export interface constructNpmPackageArgs {
+    packageName?: string;
+    version?: string;
+    repoUrl?: string;
+    publishInfo?: PublishInfo;
+    licenseConfig?: FernGeneratorExec.LicenseConfig;
+    isPackagePrivate: boolean;
+}
+
+export function constructNpmPackageFromArgs(args: constructNpmPackageArgs): NpmPackage | undefined {
+    const { packageName, version, repoUrl, publishInfo, licenseConfig, isPackagePrivate } = args;
+    if (packageName == null || version == null) {
+        return undefined;
+    }
+
+    return {
+        packageName,
+        version,
+        private: isPackagePrivate,
+        publishInfo,
+        license: licenseFromLicenseConfig(licenseConfig),
+        repoUrl: getRepoUrlFromUrl(repoUrl)
+    };
+}
 
 export function constructNpmPackage({
     generatorConfig,
@@ -50,7 +76,10 @@ export function constructNpmPackage({
     }
 }
 
-function getRepoUrlFromUrl(repoUrl: string): string {
+function getRepoUrlFromUrl(repoUrl: string | undefined): string | undefined {
+    if (repoUrl == null) {
+        return undefined;
+    }
     if (repoUrl.startsWith("https://github.com/")) {
         return `github:${removeGitSuffix(repoUrl).replace("https://github.com/", "")}`;
     }
@@ -84,3 +113,11 @@ function removeGitSuffix(repoUrl: string): string {
     }
     return repoUrl;
 }
+
+function licenseFromLicenseConfig(licenseConfig: FernGeneratorExec.LicenseConfig | undefined): string | undefined {
+    return licenseConfig?._visit({
+        basic: (basic) => basic.id,
+        custom: (custom) => `See ${custom.filename}`,
+        _other: () => undefined
+    });
+}

generators/typescript-v2/browser-compatible-base/src/utils/index.ts

@@ -1,2 +1,2 @@
-export { constructNpmPackage } from "./constructNpmPackage";
+export * from "./constructNpmPackage";
 export { getNamespaceExport } from "./getNamespaceExport";

generators/typescript/sdk/cli/src/SdkGeneratorCli.ts

@@ -13,6 +13,8 @@ import {
 } from "@fern-typescript/commons";
 import { GeneratorContext } from "@fern-typescript/contexts";
 import { SdkGenerator } from "@fern-typescript/sdk-generator";
+import fs from "fs/promises";
+import path from "path";
 
 import { SdkCustomConfig } from "./custom-config/SdkCustomConfig";
 import { SdkCustomConfigSchema } from "./custom-config/schema/SdkCustomConfigSchema";
@@ -239,6 +241,7 @@ export class SdkGeneratorCli extends AbstractGeneratorCli<SdkCustomConfig> {
             pathToSrc: persistedTypescriptProject.getSrcDirectory()
         });
         await writeTemplateFiles(rootDirectory, this.getTemplateVariables(customConfig));
+        await this.writeLicenseFile(config, rootDirectory, generatorContext.logger);
         await this.postProcess(persistedTypescriptProject, customConfig);
 
         return persistedTypescriptProject;
@@ -253,6 +256,48 @@ export class SdkGeneratorCli extends AbstractGeneratorCli<SdkCustomConfig> {
         };
     }
 
+    private async writeLicenseFile(
+        config: FernGeneratorExec.GeneratorConfig,
+        rootDirectory: AbsoluteFilePath,
+        logger: Logger
+    ): Promise<void> {
+        if (config.license?.type === "custom") {
+            // For custom licenses, we need to get the license content from the source file
+            // The CLI should have read the license file content and made it available
+            // For now, we'll read the license file from the original location
+
+            try {
+                // The license file path is relative to the fern config directory
+                // We need to construct the full path to read the license content
+                const licenseFileName = config.license.filename;
+                const licenseContent = await this.readLicenseFileContent(licenseFileName);
+
+                const licenseFilePath = path.join(rootDirectory, "LICENSE");
+                await fs.writeFile(licenseFilePath, licenseContent, "utf-8");
+                logger.debug(`Successfully wrote LICENSE file to ${licenseFilePath}`);
+            } catch (error) {
+                // If we can't read the license file, we'll skip writing it
+                // This maintains backwards compatibility
+                logger.warn(`Failed to write LICENSE file: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+
+    private async readLicenseFileContent(licenseFileName: string): Promise<string> {
+        const fs = await import("fs/promises");
+
+        // In Docker execution environment, the license file is mounted at /tmp/LICENSE
+        const dockerLicensePath = "/tmp/LICENSE";
+
+        try {
+            return await fs.readFile(dockerLicensePath, "utf-8");
+        } catch (error) {
+            throw new Error(
+                `Could not read license file from ${dockerLicensePath}: ${error instanceof Error ? error.message : String(error)}`
+            );
+        }
+    }
+
     private async postProcess(
         persistedTypescriptProject: PersistedTypescriptProject,
         _customConfig: SdkCustomConfig

generators/typescript/sdk/client-class-generator/src/GeneratedSdkClientClassImpl.ts

@@ -1253,6 +1253,12 @@ export class GeneratedSdkClientClassImpl implements GeneratedSdkClientClass {
                     header: context.ir.sdkConfig.platformHeaders.userAgent.header,
                     value: ts.factory.createStringLiteral(context.ir.sdkConfig.platformHeaders.userAgent.value)
                 });
+            } else if (this.npmPackage != null) {
+                // Fallback: generate User-Agent header from npm package info
+                headers.push({
+                    header: "User-Agent",
+                    value: ts.factory.createStringLiteral(`${this.npmPackage.packageName}/${this.npmPackage.version}`)
+                });
             }
 
             const generatedVersion = context.versionContext.getGeneratedVersion();

generators/typescript/sdk/generator/src/TypeScriptGeneratorAgent.ts

@@ -1,4 +1,4 @@
-import { AbstractGeneratorAgent } from "@fern-api/base-generator";
+import { AbstractGeneratorAgent, RawGithubConfig } from "@fern-api/base-generator";
 import { Logger } from "@fern-api/logger";
 import { FernGeneratorCli } from "@fern-fern/generator-cli-sdk";
 import { FernGeneratorExec } from "@fern-fern/generator-exec-sdk";
@@ -70,13 +70,14 @@ export class TypeScriptGeneratorAgent extends AbstractGeneratorAgent<SdkContext>
         };
     }
 
-    public getGitHubConfig(args: AbstractGeneratorAgent.GitHubConfigArgs<SdkContext>): FernGeneratorCli.GitHubConfig {
+    public getGitHubConfig(args: AbstractGeneratorAgent.GitHubConfigArgs<SdkContext>): RawGithubConfig {
         // TODO: get from env
         return {
-            sourceDirectory: "NONE",
-            uri: "NONE",
-            token: "token",
-            branch: "NONE"
+            sourceDirectory: "fern/output",
+            type: this.publishConfig?.type,
+            uri: this.publishConfig?.type === "github" ? this.publishConfig.uri : undefined,
+            token: this.publishConfig?.type === "github" ? this.publishConfig.token : undefined,
+            mode: this.publishConfig?.type === "github" ? this.publishConfig.mode : undefined
         };
     }
 }

generators/typescript/sdk/versions.yml

@@ -1,4 +1,12 @@
 # yaml-language-server: $schema=../../../fern-versions-yml.schema.json
+- version: 3.17.2
+  changelogEntry:
+    - summary: |
+        Fix TypeScript SDK generator's local GitHub generation to match remote generation.
+      type: fix
+  createdAt: "2025-10-31"
+  irVersion: 60
+
 - version: 3.17.1
   changelogEntry:
     - summary: |

generators/typescript/utils/abstract-generator-cli/src/AbstractGeneratorCli.ts

@@ -11,9 +11,15 @@ import { assertNever } from "@fern-api/core-utils";
 import { AbsoluteFilePath, join, RelativeFilePath } from "@fern-api/fs-utils";
 import { CONSOLE_LOGGER, createLogger, Logger, LogLevel } from "@fern-api/logger";
 import { createLoggingExecutable } from "@fern-api/logging-execa";
-import { serialization } from "@fern-fern/ir-sdk";
+import { FernIr, serialization } from "@fern-fern/ir-sdk";
 import { IntermediateRepresentation } from "@fern-fern/ir-sdk/api";
-import { constructNpmPackage, NpmPackage, PersistedTypescriptProject } from "@fern-typescript/commons";
+import {
+    constructNpmPackage,
+    constructNpmPackageArgs,
+    constructNpmPackageFromArgs,
+    NpmPackage,
+    PersistedTypescriptProject
+} from "@fern-typescript/commons";
 import { GeneratorContext } from "@fern-typescript/contexts";
 import { writeFile } from "fs/promises";
 import tmp from "tmp-promise";
@@ -72,11 +78,20 @@ export abstract class AbstractGeneratorCli<CustomConfig> {
             });
             const customConfig = this.parseCustomConfig(config.customConfig, logger);
 
-            const npmPackage = constructNpmPackage({
-                generatorConfig: config,
-                isPackagePrivate: this.isPackagePrivate(customConfig)
+            const ir = await parseIR({
+                absolutePathToIR: AbsoluteFilePath.of(config.irFilepath),
+                parse: serialization.IntermediateRepresentation.parse
             });
 
+            const npmPackage = ir.selfHosted
+                ? constructNpmPackageFromArgs(
+                      npmPackageInfoFromPublishConfig(ir.publishConfig, this.isPackagePrivate(customConfig))
+                  )
+                : constructNpmPackage({
+                      generatorConfig: config,
+                      isPackagePrivate: this.isPackagePrivate(customConfig)
+                  });
+
             await generatorNotificationService.sendUpdate(
                 FernGeneratorExec.GeneratorUpdate.initV2({
                     publishingToRegistry:
@@ -91,11 +106,6 @@ export abstract class AbstractGeneratorCli<CustomConfig> {
                 _other: () => undefined
             });
 
-            const ir = await parseIR({
-                absolutePathToIR: AbsoluteFilePath.of(config.irFilepath),
-                parse: serialization.IntermediateRepresentation.parse
-            });
-
             const generatorContext = new GeneratorContextImpl(logger, version);
             const typescriptProject = await this.generateTypescriptProject({
                 config,
@@ -288,6 +298,54 @@ export abstract class AbstractGeneratorCli<CustomConfig> {
     }
 }
 
+function npmPackageInfoFromPublishConfig(
+    publishConfig: FernIr.PublishingConfig | undefined,
+    isPackagePrivate: boolean
+): constructNpmPackageArgs {
+    return (
+        publishConfig?._visit({
+            github: (publishConfig) => {
+                return {
+                    ...npmInfoFromPublishTarget(publishConfig.target),
+                    repoUrl: publishConfig.uri,
+                    publishInfo: undefined,
+                    // TODO: add licence config
+                    licenceConfig: undefined,
+                    isPackagePrivate
+                };
+            },
+            direct: (publishConfig) => {
+                return { isPackagePrivate };
+            },
+            filesystem: () => {
+                return { isPackagePrivate };
+            },
+            _other: () => {
+                return { isPackagePrivate };
+            }
+        }) ?? { isPackagePrivate }
+    );
+}
+
+function npmInfoFromPublishTarget(
+    target?: FernIr.PublishTarget
+): { packageName?: string; version?: string } | undefined {
+    return (
+        target?._visit({
+            npm: (value) => {
+                return {
+                    packageName: value.packageName,
+                    version: value.version
+                };
+            },
+            postman: () => undefined,
+            maven: () => undefined,
+            pypi: () => undefined,
+            _other: () => undefined
+        }) ?? undefined
+    );
+}
+
 class GeneratorContextImpl implements GeneratorContext {
     private isSuccess = true;
 

package.json

@@ -14,6 +14,7 @@
     "bootstrap": "./scripts/bootstrap.sh",
     "clean": "turbo clean",
     "compile": "turbo compile",
+    "compile:cli": "turbo compile --filter=@fern-api/cli",
     "compile:debug": "turbo compile:debug",
     "compile:win": "pnpm -r compile",
     "test": "turbo test --filter=!@fern-api/ete-tests",

packages/cli/generation/local-generation/local-workspace-runner/package.json

@@ -51,6 +51,7 @@
     "@fern-api/logging-execa": "workspace:*",
     "@fern-api/php-dynamic-snippets": "workspace:*",
     "@fern-api/python-dynamic-snippets": "workspace:*",
+    "@fern-api/remote-workspace-runner": "workspace:*",
     "@fern-api/ruby-dynamic-snippets": "workspace:*",
     "@fern-api/rust-dynamic-snippets": "workspace:*",
     "@fern-api/sdk": "0.12.3",