@fern-api/java-dynamic-snippets 4.10.4 → 4.10.6

package/dist/index.d.cts

@@ -14,6 +14,7 @@ declare namespace DynamicTypeLiteralMapper {
         as?: ConvertedAs;
         inUndiscriminatedUnion?: boolean;
         isCollapsedOptionalNullable?: boolean;
+        nestedClassReference?: java.ClassReference;
     }
     type ConvertedAs = "mapKey" | "mapValue" | "request";
 }
@@ -23,7 +24,9 @@ declare class DynamicTypeLiteralMapper {
         context: DynamicSnippetsGeneratorContext;
     });
     private usesOptionalNullable;
+    private usesNullableAnnotation;
     private wrapInOptionalIfNotNop;
+    private wrapNullableOrOptionalValue;
     convert(args: DynamicTypeLiteralMapper.Args): java.TypeLiteral;
     private convertList;
     private convertLiteral;
@@ -32,6 +35,37 @@ declare class DynamicTypeLiteralMapper {
     private convertNamed;
     private convertDiscriminatedUnion;
     private convertObject;
+    /**
+     * Mirrors the v1 generator's inline-type naming (see ObjectGenerator / InlineTypeIdResolver):
+     * when a property's type resolves to an inline named type, v1 emits it as a class nested within
+     * the enclosing object. This walks the property's type reference (descending through container
+     * wrappers, applying the same name suffixes as v1) and, if it terminates in an inline named type,
+     * returns the nested class reference to use. Returns undefined for non-inline types, which fall
+     * back to the standalone top-level class name.
+     */
+    resolveInlineNestedClassReference({ enclosing, baseName, typeReference, reservedNames, siblingPropertyNames }: {
+        enclosing: java.ClassReference;
+        baseName: string;
+        typeReference: FernIr.dynamic.TypeReference;
+        reservedNames: Set<string>;
+        siblingPropertyNames: Set<string>;
+    }): java.ClassReference | undefined;
+    /**
+     * Resolves the nested class reference for an inline member of an undiscriminated union.
+     * Unlike object properties and discriminated-union variants (whose nested name is derived
+     * from the property/discriminant name), v1 names an undiscriminated union's inline members
+     * after the member type's own name, with the union's name stripped as a prefix (see
+     * UndiscriminatedUnionGenerator). Descends through container wrappers to the terminal named
+     * type.
+     */
+    private resolveUndiscriminatedInlineNestedClassReference;
+    /**
+     * Returns true when a property becomes a required stage in v1's staged builder. v1 stages
+     * fields that are neither optional, nullable, nor collections (list/set/map); those are all
+     * exposed on the final stage instead. This intentionally resolves aliases itself because the
+     * shared `isOptional` helper does not treat an alias to an optional type as optional.
+     */
+    private isStagedBuilderProperty;
     private convertToRawJavaLiteral;
     private escapeJavaString;
     private getDefaultValueForTypeReference;
@@ -96,13 +130,32 @@ declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGen
     dynamicTypeMapper: DynamicTypeMapper;
     dynamicTypeLiteralMapper: DynamicTypeLiteralMapper;
     filePropertyMapper: FilePropertyMapper;
-    constructor({ ir, config, options, sharedCustomConfig }: {
+    /**
+     * The set of type IDs that the v1 generator emits as nested (inline) classes rather than
+     * top-level types. The dynamic IR does not carry the `inline` flag, so the v2 SDK generator
+     * computes this from the full IR and threads it through. Used to mirror v1's nested-class
+     * naming when referencing inline types in snippets.
+     */
+    inlineTypeIds: Set<string>;
+    constructor({ ir, config, options, sharedCustomConfig, inlineTypeIds }: {
         ir: FernIr.dynamic.DynamicIntermediateRepresentation;
         config: FernGeneratorExec.GeneratorConfig;
         options?: Options;
         sharedCustomConfig?: BaseJavaCustomConfigSchema;
+        inlineTypeIds?: Set<string>;
     });
     clone(): DynamicSnippetsGeneratorContext;
+    isInlineType(typeId: string): boolean;
+    /**
+     * Builds a reference to a class nested within `enclosing`. The resulting reference imports the
+     * outermost enclosing class and is written using the dotted path (e.g. `PostRootRequest.Bar`).
+     */
+    getNestedInlineClassReference({ enclosing, name }: {
+        enclosing: java.ClassReference;
+        name: string;
+    }): java.ClassReference;
+    wrappedAliases(): boolean;
+    enableInlineTypes(): boolean;
     getClassName(name: FernIr.Name): string;
     getEnumName(name: FernIr.Name): string;
     getPropertyName(name: FernIr.Name): string;
@@ -168,6 +221,8 @@ declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGen
     getPackageLayout(): string;
     shouldInlinePathParameters(): boolean;
     shouldInlineFileProperties(): boolean;
+    usesNullableAnnotation(): boolean;
+    usesOptionalNullable(): boolean;
     private getPackageNameSegments;
     private getPackageNameSegment;
     private getPackagePrefixTokens;
@@ -241,10 +296,11 @@ declare class EndpointSnippetGenerator {
 }
 
 declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<DynamicSnippetsGeneratorContext, EndpointSnippetGenerator> {
-    constructor({ ir, config, options }: {
+    constructor({ ir, config, options, inlineTypeIds }: {
         ir: FernIr.dynamic.DynamicIntermediateRepresentation;
         config: FernGeneratorExec.GeneratorConfig;
         options?: Options;
+        inlineTypeIds?: Set<string>;
     });
     generate(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): Promise<FernIr.dynamic.EndpointSnippetResponse>;
     generateSync(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): FernIr.dynamic.EndpointSnippetResponse;

package/dist/index.d.ts

@@ -14,6 +14,7 @@ declare namespace DynamicTypeLiteralMapper {
         as?: ConvertedAs;
         inUndiscriminatedUnion?: boolean;
         isCollapsedOptionalNullable?: boolean;
+        nestedClassReference?: java.ClassReference;
     }
     type ConvertedAs = "mapKey" | "mapValue" | "request";
 }
@@ -23,7 +24,9 @@ declare class DynamicTypeLiteralMapper {
         context: DynamicSnippetsGeneratorContext;
     });
     private usesOptionalNullable;
+    private usesNullableAnnotation;
     private wrapInOptionalIfNotNop;
+    private wrapNullableOrOptionalValue;
     convert(args: DynamicTypeLiteralMapper.Args): java.TypeLiteral;
     private convertList;
     private convertLiteral;
@@ -32,6 +35,37 @@ declare class DynamicTypeLiteralMapper {
     private convertNamed;
     private convertDiscriminatedUnion;
     private convertObject;
+    /**
+     * Mirrors the v1 generator's inline-type naming (see ObjectGenerator / InlineTypeIdResolver):
+     * when a property's type resolves to an inline named type, v1 emits it as a class nested within
+     * the enclosing object. This walks the property's type reference (descending through container
+     * wrappers, applying the same name suffixes as v1) and, if it terminates in an inline named type,
+     * returns the nested class reference to use. Returns undefined for non-inline types, which fall
+     * back to the standalone top-level class name.
+     */
+    resolveInlineNestedClassReference({ enclosing, baseName, typeReference, reservedNames, siblingPropertyNames }: {
+        enclosing: java.ClassReference;
+        baseName: string;
+        typeReference: FernIr.dynamic.TypeReference;
+        reservedNames: Set<string>;
+        siblingPropertyNames: Set<string>;
+    }): java.ClassReference | undefined;
+    /**
+     * Resolves the nested class reference for an inline member of an undiscriminated union.
+     * Unlike object properties and discriminated-union variants (whose nested name is derived
+     * from the property/discriminant name), v1 names an undiscriminated union's inline members
+     * after the member type's own name, with the union's name stripped as a prefix (see
+     * UndiscriminatedUnionGenerator). Descends through container wrappers to the terminal named
+     * type.
+     */
+    private resolveUndiscriminatedInlineNestedClassReference;
+    /**
+     * Returns true when a property becomes a required stage in v1's staged builder. v1 stages
+     * fields that are neither optional, nullable, nor collections (list/set/map); those are all
+     * exposed on the final stage instead. This intentionally resolves aliases itself because the
+     * shared `isOptional` helper does not treat an alias to an optional type as optional.
+     */
+    private isStagedBuilderProperty;
     private convertToRawJavaLiteral;
     private escapeJavaString;
     private getDefaultValueForTypeReference;
@@ -96,13 +130,32 @@ declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGen
     dynamicTypeMapper: DynamicTypeMapper;
     dynamicTypeLiteralMapper: DynamicTypeLiteralMapper;
     filePropertyMapper: FilePropertyMapper;
-    constructor({ ir, config, options, sharedCustomConfig }: {
+    /**
+     * The set of type IDs that the v1 generator emits as nested (inline) classes rather than
+     * top-level types. The dynamic IR does not carry the `inline` flag, so the v2 SDK generator
+     * computes this from the full IR and threads it through. Used to mirror v1's nested-class
+     * naming when referencing inline types in snippets.
+     */
+    inlineTypeIds: Set<string>;
+    constructor({ ir, config, options, sharedCustomConfig, inlineTypeIds }: {
         ir: FernIr.dynamic.DynamicIntermediateRepresentation;
         config: FernGeneratorExec.GeneratorConfig;
         options?: Options;
         sharedCustomConfig?: BaseJavaCustomConfigSchema;
+        inlineTypeIds?: Set<string>;
     });
     clone(): DynamicSnippetsGeneratorContext;
+    isInlineType(typeId: string): boolean;
+    /**
+     * Builds a reference to a class nested within `enclosing`. The resulting reference imports the
+     * outermost enclosing class and is written using the dotted path (e.g. `PostRootRequest.Bar`).
+     */
+    getNestedInlineClassReference({ enclosing, name }: {
+        enclosing: java.ClassReference;
+        name: string;
+    }): java.ClassReference;
+    wrappedAliases(): boolean;
+    enableInlineTypes(): boolean;
     getClassName(name: FernIr.Name): string;
     getEnumName(name: FernIr.Name): string;
     getPropertyName(name: FernIr.Name): string;
@@ -168,6 +221,8 @@ declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGen
     getPackageLayout(): string;
     shouldInlinePathParameters(): boolean;
     shouldInlineFileProperties(): boolean;
+    usesNullableAnnotation(): boolean;
+    usesOptionalNullable(): boolean;
     private getPackageNameSegments;
     private getPackageNameSegment;
     private getPackagePrefixTokens;
@@ -241,10 +296,11 @@ declare class EndpointSnippetGenerator {
 }
 
 declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<DynamicSnippetsGeneratorContext, EndpointSnippetGenerator> {
-    constructor({ ir, config, options }: {
+    constructor({ ir, config, options, inlineTypeIds }: {
         ir: FernIr.dynamic.DynamicIntermediateRepresentation;
         config: FernGeneratorExec.GeneratorConfig;
         options?: Options;
+        inlineTypeIds?: Set<string>;
     });
     generate(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): Promise<FernIr.dynamic.EndpointSnippetResponse>;
     generateSync(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): FernIr.dynamic.EndpointSnippetResponse;