@fern-api/swift-dynamic-snippets 0.1.1 → 0.26.0

package/dist/index.d.cts

@@ -0,0 +1,145 @@
+import { AbstractDynamicSnippetsGeneratorContext, FernGeneratorExec, Options, AbstractAstNode, AbstractDynamicSnippetsGenerator } from '@fern-api/browser-compatible-base-generator';
+import { FernIr } from '@fern-api/dynamic-ir-sdk';
+import { swift, BaseSwiftCustomConfigSchema, NameRegistry, Referencer } from '@fern-api/swift-codegen';
+
+interface Config {
+}
+
+declare namespace DynamicTypeLiteralMapper {
+    interface Args {
+        fromSymbol: swift.Symbol;
+        typeReference: FernIr.dynamic.TypeReference;
+        value: unknown;
+        as?: ConvertedAs;
+    }
+    type ConvertedAs = "mapKey" | "mapValue";
+}
+declare class DynamicTypeLiteralMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    convert(args: DynamicTypeLiteralMapper.Args): swift.Expression;
+    private convertList;
+    private convertMap;
+    private convertNamed;
+    private convertNullable;
+    private convertDiscriminatedUnion;
+    private convertDiscriminatedUnionProperties;
+    private getBaseFields;
+    private convertEnum;
+    private getEnumValue;
+    private convertObject;
+    private convertUndiscriminatedUnion;
+    private findMatchingUndiscriminatedUnionType;
+    private convertUnknown;
+    private convertPrimitive;
+    private getValueAsNumber;
+    private getValueAsBoolean;
+}
+
+interface FilePropertyInfo {
+    fileFields: swift.FunctionArgument[];
+    bodyPropertyFields: swift.FunctionArgument[];
+}
+declare class FilePropertyMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    getFilePropertyInfo({ fromSymbol, body, value }: {
+        fromSymbol: swift.Symbol;
+        body: FernIr.dynamic.FileUploadRequestBody;
+        value: unknown;
+    }): FilePropertyInfo;
+    private getSingleFileProperty;
+    private getArrayFileProperty;
+    private getBodyProperty;
+}
+
+declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGeneratorContext {
+    ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+    customConfig: BaseSwiftCustomConfigSchema | undefined;
+    dynamicTypeLiteralMapper: DynamicTypeLiteralMapper;
+    filePropertyMapper: FilePropertyMapper;
+    nameRegistry: NameRegistry;
+    constructor({ ir, config, options }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+        options?: Options;
+    });
+    private registerSourceSymbols;
+    getNamedTypeOrThrow(typeId: string): FernIr.dynamic.NamedType;
+    getPropertiesOfDiscriminatedUnionVariant(typeId: string): FernIr.dynamic.NamedParameter[];
+    getSwiftTypeReferenceFromScope(typeReference: FernIr.dynamic.TypeReference, fromSymbol: swift.Symbol): swift.TypeReference;
+    createReferencer(fromSymbol: swift.Symbol): Referencer;
+    clone(): DynamicSnippetsGeneratorContext;
+}
+
+declare class EndpointSnippetGenerator {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    generateSnippet({ endpoint, request, options }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+        options?: Options;
+    }): Promise<string>;
+    generateSnippetSync({ endpoint, request, options }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+        options?: Options;
+    }): string;
+    generateSnippetAst({ endpoint, request, options }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+        options?: Options;
+    }): Promise<AbstractAstNode>;
+    private buildCodeBlock;
+    private generateImportFoundationStatement;
+    private generateImportModuleStatement;
+    private generateMainFunctionDeclarationWithEndpointSnippet;
+    generateRootClientInitializationStatement({ auth, snippet, additionalArgs }: {
+        auth: FernIr.dynamic.Auth | undefined;
+        snippet: FernIr.dynamic.EndpointSnippetRequest;
+        additionalArgs?: swift.FunctionArgument[];
+    }): swift.Statement;
+    private getRootClientBaseURLArg;
+    private getRootClientAuthArgs;
+    private generateEndpointMethodCallStatement;
+    generateEndpointMethodCallExpression({ endpoint, snippet, additionalArguments }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        snippet: FernIr.dynamic.EndpointSnippetRequest;
+        additionalArguments?: swift.FunctionArgument[];
+    }): swift.Expression;
+    private generateMainFunctionInvocationStatement;
+    private getEndpointMethodName;
+    private getEndpointMethodArguments;
+    private getEndpointMethodArgsForInlinedRequest;
+    private getEndpointMethodPathParameters;
+    private getEndpointMethodQueryParameters;
+    private getFilePropertyInfo;
+    private getInlinedRequestArg;
+    private getInlinedRequestBodyObjectFields;
+    private getInlinedRequestBodyPropertyObjectFields;
+    private getReferencedRequestBodyPropertyObjectField;
+    private getReferencedRequestBodyPropertyTypeLiteral;
+    private getBytesBodyRequestArg;
+    private getEndpointMethodArgsForBodyRequest;
+    private getEndpointMethodBodyRequestArg;
+}
+
+declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<DynamicSnippetsGeneratorContext, EndpointSnippetGenerator> {
+    constructor({ ir, config, options }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+        options?: Options;
+    });
+    generate(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): Promise<FernIr.dynamic.EndpointSnippetResponse>;
+    generateSync(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): FernIr.dynamic.EndpointSnippetResponse;
+    generateSnippetAst(request: FernIr.dynamic.EndpointSnippetRequest): Promise<AbstractAstNode>;
+    protected createSnippetGenerator(context: DynamicSnippetsGeneratorContext): EndpointSnippetGenerator;
+}
+
+export { type Config, DynamicSnippetsGenerator, EndpointSnippetGenerator };

package/dist/index.d.ts

@@ -0,0 +1,145 @@
+import { AbstractDynamicSnippetsGeneratorContext, FernGeneratorExec, Options, AbstractAstNode, AbstractDynamicSnippetsGenerator } from '@fern-api/browser-compatible-base-generator';
+import { FernIr } from '@fern-api/dynamic-ir-sdk';
+import { swift, BaseSwiftCustomConfigSchema, NameRegistry, Referencer } from '@fern-api/swift-codegen';
+
+interface Config {
+}
+
+declare namespace DynamicTypeLiteralMapper {
+    interface Args {
+        fromSymbol: swift.Symbol;
+        typeReference: FernIr.dynamic.TypeReference;
+        value: unknown;
+        as?: ConvertedAs;
+    }
+    type ConvertedAs = "mapKey" | "mapValue";
+}
+declare class DynamicTypeLiteralMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    convert(args: DynamicTypeLiteralMapper.Args): swift.Expression;
+    private convertList;
+    private convertMap;
+    private convertNamed;
+    private convertNullable;
+    private convertDiscriminatedUnion;
+    private convertDiscriminatedUnionProperties;
+    private getBaseFields;
+    private convertEnum;
+    private getEnumValue;
+    private convertObject;
+    private convertUndiscriminatedUnion;
+    private findMatchingUndiscriminatedUnionType;
+    private convertUnknown;
+    private convertPrimitive;
+    private getValueAsNumber;
+    private getValueAsBoolean;
+}
+
+interface FilePropertyInfo {
+    fileFields: swift.FunctionArgument[];
+    bodyPropertyFields: swift.FunctionArgument[];
+}
+declare class FilePropertyMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    getFilePropertyInfo({ fromSymbol, body, value }: {
+        fromSymbol: swift.Symbol;
+        body: FernIr.dynamic.FileUploadRequestBody;
+        value: unknown;
+    }): FilePropertyInfo;
+    private getSingleFileProperty;
+    private getArrayFileProperty;
+    private getBodyProperty;
+}
+
+declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGeneratorContext {
+    ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+    customConfig: BaseSwiftCustomConfigSchema | undefined;
+    dynamicTypeLiteralMapper: DynamicTypeLiteralMapper;
+    filePropertyMapper: FilePropertyMapper;
+    nameRegistry: NameRegistry;
+    constructor({ ir, config, options }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+        options?: Options;
+    });
+    private registerSourceSymbols;
+    getNamedTypeOrThrow(typeId: string): FernIr.dynamic.NamedType;
+    getPropertiesOfDiscriminatedUnionVariant(typeId: string): FernIr.dynamic.NamedParameter[];
+    getSwiftTypeReferenceFromScope(typeReference: FernIr.dynamic.TypeReference, fromSymbol: swift.Symbol): swift.TypeReference;
+    createReferencer(fromSymbol: swift.Symbol): Referencer;
+    clone(): DynamicSnippetsGeneratorContext;
+}
+
+declare class EndpointSnippetGenerator {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    generateSnippet({ endpoint, request, options }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+        options?: Options;
+    }): Promise<string>;
+    generateSnippetSync({ endpoint, request, options }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+        options?: Options;
+    }): string;
+    generateSnippetAst({ endpoint, request, options }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        request: FernIr.dynamic.EndpointSnippetRequest;
+        options?: Options;
+    }): Promise<AbstractAstNode>;
+    private buildCodeBlock;
+    private generateImportFoundationStatement;
+    private generateImportModuleStatement;
+    private generateMainFunctionDeclarationWithEndpointSnippet;
+    generateRootClientInitializationStatement({ auth, snippet, additionalArgs }: {
+        auth: FernIr.dynamic.Auth | undefined;
+        snippet: FernIr.dynamic.EndpointSnippetRequest;
+        additionalArgs?: swift.FunctionArgument[];
+    }): swift.Statement;
+    private getRootClientBaseURLArg;
+    private getRootClientAuthArgs;
+    private generateEndpointMethodCallStatement;
+    generateEndpointMethodCallExpression({ endpoint, snippet, additionalArguments }: {
+        endpoint: FernIr.dynamic.Endpoint;
+        snippet: FernIr.dynamic.EndpointSnippetRequest;
+        additionalArguments?: swift.FunctionArgument[];
+    }): swift.Expression;
+    private generateMainFunctionInvocationStatement;
+    private getEndpointMethodName;
+    private getEndpointMethodArguments;
+    private getEndpointMethodArgsForInlinedRequest;
+    private getEndpointMethodPathParameters;
+    private getEndpointMethodQueryParameters;
+    private getFilePropertyInfo;
+    private getInlinedRequestArg;
+    private getInlinedRequestBodyObjectFields;
+    private getInlinedRequestBodyPropertyObjectFields;
+    private getReferencedRequestBodyPropertyObjectField;
+    private getReferencedRequestBodyPropertyTypeLiteral;
+    private getBytesBodyRequestArg;
+    private getEndpointMethodArgsForBodyRequest;
+    private getEndpointMethodBodyRequestArg;
+}
+
+declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<DynamicSnippetsGeneratorContext, EndpointSnippetGenerator> {
+    constructor({ ir, config, options }: {
+        ir: FernIr.dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+        options?: Options;
+    });
+    generate(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): Promise<FernIr.dynamic.EndpointSnippetResponse>;
+    generateSync(request: FernIr.dynamic.EndpointSnippetRequest, options?: Options): FernIr.dynamic.EndpointSnippetResponse;
+    generateSnippetAst(request: FernIr.dynamic.EndpointSnippetRequest): Promise<AbstractAstNode>;
+    protected createSnippetGenerator(context: DynamicSnippetsGeneratorContext): EndpointSnippetGenerator;
+}
+
+export { type Config, DynamicSnippetsGenerator, EndpointSnippetGenerator };