@fern-api/go-dynamic-snippets 0.0.7 → 0.0.8

package/{index.d.ts → cjs/index.d.cts}

@@ -1,6 +1,6 @@
 export { DynamicSnippetsGenerator } from './DynamicSnippetsGenerator.cjs';
 import '@fern-api/browser-compatible-base-generator';
-import './DynamicSnippetsGeneratorContext-BBnUUv3r.cjs';
+import './DynamicSnippetsGeneratorContext-DuDerGxa.cjs';
 import '@fern-api/go-ast';
 import '@fern-fern/ir-sdk/api';
 import './TypeInstance.cjs';

package/esm/DiscriminatedUnionTypeInstance.d.ts

@@ -0,0 +1,12 @@
+import { NameAndWireValue, dynamic } from '@fern-fern/ir-sdk/api';
+
+/**
+ * A discriminated union type instance that can be converted into a language-specific AST node.
+ */
+interface DiscriminatedUnionTypeInstance {
+    discriminantValue: NameAndWireValue;
+    singleDiscriminatedUnionType: dynamic.SingleDiscriminatedUnionType;
+    value: unknown;
+}
+
+export type { DiscriminatedUnionTypeInstance };

package/esm/DynamicSnippetsGenerator.d.ts

@@ -0,0 +1,20 @@
+import { AbstractDynamicSnippetsGenerator, FernGeneratorExec, AbstractFormatter } from '@fern-api/browser-compatible-base-generator';
+import { D as DynamicSnippetsGeneratorContext } from './DynamicSnippetsGeneratorContext-DKWsHJSo.js';
+import { dynamic } from '@fern-fern/ir-sdk/api';
+import '@fern-api/go-ast';
+import './TypeInstance.js';
+import './DiscriminatedUnionTypeInstance.js';
+import './context/ErrorReporter.js';
+
+declare class DynamicSnippetsGenerator extends AbstractDynamicSnippetsGenerator<dynamic.DynamicIntermediateRepresentation, DynamicSnippetsGeneratorContext, dynamic.EndpointSnippetRequest, dynamic.EndpointSnippetResponse> {
+    private formatter;
+    constructor({ ir, config, formatter }: {
+        ir: dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+        formatter?: AbstractFormatter;
+    });
+    generate(request: dynamic.EndpointSnippetRequest): Promise<dynamic.EndpointSnippetResponse>;
+    generateSync(request: dynamic.EndpointSnippetRequest): dynamic.EndpointSnippetResponse;
+}
+
+export { DynamicSnippetsGenerator };

package/esm/DynamicSnippetsGenerator.js

@@ -0,0 +1 @@
+import{a}from"./chunk-4PKXKUYU.js";import"./chunk-KJOW5AZT.js";import"./chunk-COBOWL3P.js";import"./chunk-ZYGZ4VN4.js";import"./chunk-UVYC4FWB.js";import"./chunk-IQODEXPX.js";import"./chunk-ZQRLKIRW.js";import"./chunk-BC35GX6S.js";import"./chunk-VAYOWHUI.js";import"./chunk-5XUC5IOB.js";import"./chunk-6JCPJA27.js";export{a as DynamicSnippetsGenerator};

package/esm/DynamicSnippetsGeneratorContext-DKWsHJSo.d.ts

@@ -0,0 +1,143 @@
+import { AbstractDynamicSnippetsGeneratorContext, FernGeneratorExec } from '@fern-api/browser-compatible-base-generator';
+import { go, BaseGoCustomConfigSchema } from '@fern-api/go-ast';
+import { dynamic, TypeId, Name, FernFilepath } from '@fern-fern/ir-sdk/api';
+import { TypeInstance } from './TypeInstance.js';
+import { DiscriminatedUnionTypeInstance } from './DiscriminatedUnionTypeInstance.js';
+import { ErrorReporter } from './context/ErrorReporter.js';
+
+declare namespace DynamicTypeMapper {
+    interface Args {
+        typeReference: dynamic.TypeReference;
+    }
+}
+declare class DynamicTypeMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    convert(args: DynamicTypeMapper.Args): go.Type;
+    private convertLiteral;
+    private convertNamed;
+    private convertUnknown;
+    private convertPrimitive;
+}
+
+declare namespace DynamicTypeInstantiationMapper {
+    interface Args {
+        typeReference: dynamic.TypeReference;
+        value: unknown;
+        as?: ConvertedAs;
+    }
+    type ConvertedAs = "key";
+}
+declare class DynamicTypeInstantiationMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    convert(args: DynamicTypeInstantiationMapper.Args): go.TypeInstantiation;
+    private convertList;
+    private convertMap;
+    private convertNamed;
+    private convertDiscriminatedUnion;
+    private getBaseFields;
+    private convertObject;
+    private convertEnum;
+    private getEnumValueName;
+    private convertUndicriminatedUnion;
+    private findMatchingUndiscriminatedUnionType;
+    private getUndiscriminatedUnionFieldName;
+    private getUndiscriminatedUnionFieldNameForList;
+    private getUndiscriminatedUnionFieldNameForMap;
+    private getUndiscriminatedUnionFieldNameForOptional;
+    private getUndiscriminatedUnionFieldNameForSet;
+    private getUndiscriminatedUnionFieldNameForLiteral;
+    private getUndiscriminatedUnionFieldNameForPrimitive;
+    private convertUnknown;
+    private convertPrimitive;
+    private getValueAsNumber;
+    private getValueAsBoolean;
+    private getValueAsString;
+    private newTypeMismatchError;
+}
+
+interface FilePropertyInfo {
+    fileFields: go.StructField[];
+    bodyPropertyFields: go.StructField[];
+}
+declare class FilePropertyMapper {
+    private context;
+    constructor({ context }: {
+        context: DynamicSnippetsGeneratorContext;
+    });
+    getFilePropertyInfo({ body, value }: {
+        body: dynamic.FileUploadRequestBody;
+        value: unknown;
+    }): FilePropertyInfo;
+    private getSingleFileProperty;
+    private getArrayFileProperty;
+    private getBodyProperty;
+}
+
+declare class DynamicSnippetsGeneratorContext extends AbstractDynamicSnippetsGeneratorContext<dynamic.DynamicIntermediateRepresentation> {
+    customConfig: BaseGoCustomConfigSchema | undefined;
+    errors: ErrorReporter;
+    dynamicTypeMapper: DynamicTypeMapper;
+    dynamicTypeInstantiationMapper: DynamicTypeInstantiationMapper;
+    filePropertyMapper: FilePropertyMapper;
+    rootImportPath: string;
+    private httpEndpointReferenceParser;
+    constructor({ ir, config }: {
+        ir: dynamic.DynamicIntermediateRepresentation;
+        config: FernGeneratorExec.GeneratorConfig;
+    });
+    clone(): DynamicSnippetsGeneratorContext;
+    associateQueryParametersByWireValue({ parameters, values }: {
+        parameters: dynamic.NamedParameter[];
+        values: dynamic.Values;
+    }): TypeInstance[];
+    associateByWireValue({ parameters, values, ignoreMissingParameters }: {
+        parameters: dynamic.NamedParameter[];
+        values: dynamic.Values;
+        ignoreMissingParameters?: boolean;
+    }): TypeInstance[];
+    isFileUploadRequestBody(body: dynamic.InlinedRequestBody): body is dynamic.InlinedRequestBody.FileUpload;
+    needsRequestParameter({ request }: {
+        request: dynamic.InlinedRequest;
+    }): boolean;
+    includePathParametersInWrappedRequest({ request }: {
+        request: dynamic.InlinedRequest;
+    }): boolean;
+    private includeRequestBodyInWrappedRequest;
+    private includeFileUploadBodyInWrappedRequest;
+    private fileUploadHasBodyProperties;
+    private fileUploadHasFileProperties;
+    getRecord(value: unknown): Record<string, unknown> | undefined;
+    resolveNamedType({ typeId }: {
+        typeId: TypeId;
+    }): dynamic.NamedType | undefined;
+    resolveDiscriminatedUnionTypeInstance({ discriminatedUnion, value }: {
+        discriminatedUnion: dynamic.DiscriminatedUnionType;
+        value: unknown;
+    }): DiscriminatedUnionTypeInstance | undefined;
+    getMethodName(name: Name): string;
+    getTypeName(name: Name): string;
+    getImportPath(fernFilepath: FernFilepath): string;
+    getContextTypeReference(): go.TypeReference;
+    getContextTodoFunctionInvocation(): go.FuncInvocation;
+    getIoReaderTypeReference(): go.TypeReference;
+    getNewStringsReaderFunctionInvocation(s: string): go.FuncInvocation;
+    getClientConstructorName(): string;
+    getClientImportPath(): string;
+    getOptionImportPath(): string;
+    resolveEndpointOrThrow(rawEndpoint: string): dynamic.Endpoint[];
+    resolveEndpointLocationOrThrow(location: dynamic.EndpointLocation): dynamic.Endpoint[];
+    getGoTypeReferenceFromDeclaration({ declaration }: {
+        declaration: dynamic.Declaration;
+    }): go.TypeReference;
+    newParameterNotRecognizedError(parameterName: string): Error;
+    private isListTypeReference;
+    private parsedEndpointMatches;
+}
+
+export { DynamicSnippetsGeneratorContext as D, type FilePropertyInfo as F, DynamicTypeMapper as a, DynamicTypeInstantiationMapper as b, FilePropertyMapper as c };

package/esm/EndpointSnippetGenerator.d.ts

@@ -0,0 +1,52 @@
+import { AbstractFormatter } from '@fern-api/browser-compatible-base-generator';
+import { D as DynamicSnippetsGeneratorContext } from './DynamicSnippetsGeneratorContext-DKWsHJSo.js';
+import { dynamic } from '@fern-fern/ir-sdk/api';
+import '@fern-api/go-ast';
+import './TypeInstance.js';
+import './DiscriminatedUnionTypeInstance.js';
+import './context/ErrorReporter.js';
+
+declare class EndpointSnippetGenerator {
+    private context;
+    private formatter;
+    constructor({ context, formatter }: {
+        context: DynamicSnippetsGeneratorContext;
+        formatter?: AbstractFormatter;
+    });
+    generateSnippet({ endpoint, request }: {
+        endpoint: dynamic.Endpoint;
+        request: dynamic.EndpointSnippetRequest;
+    }): Promise<string>;
+    generateSnippetSync({ endpoint, request }: {
+        endpoint: dynamic.Endpoint;
+        request: dynamic.EndpointSnippetRequest;
+    }): string;
+    private buildCodeBlock;
+    private constructClient;
+    private callMethod;
+    private getConstructorArgs;
+    private getConstructorAuthArg;
+    private getConstructorBasicAuthArg;
+    private getConstructorBearerAuthArg;
+    private getConstructorHeaderAuthArg;
+    private getConstructorHeaderArgs;
+    private getConstructorHeaderArg;
+    private getMethodArgs;
+    private getMethodArgsForBodyRequest;
+    private getBodyRequestArg;
+    private getBytesBodyRequestArg;
+    private getMethodArgsForInlinedRequest;
+    private getFilePropertyInfo;
+    private getInlinedRequestArg;
+    private getInlinedRequestBodyStructFields;
+    private getFileUploadRequestBodyStructFields;
+    private getReferencedRequestBodyPropertyStructField;
+    private getReferencedRequestBodyPropertyTypeInstantiation;
+    private getInlinedRequestBodyPropertyStructFields;
+    private getPathParameters;
+    private getMethod;
+    private getRootClientFuncInvocation;
+    private newAuthMismatchError;
+}
+
+export { EndpointSnippetGenerator };

package/esm/EndpointSnippetGenerator.js

@@ -0,0 +1 @@
+import{a}from"./chunk-KJOW5AZT.js";import"./chunk-ZYGZ4VN4.js";import"./chunk-VAYOWHUI.js";import"./chunk-5XUC5IOB.js";import"./chunk-6JCPJA27.js";export{a as EndpointSnippetGenerator};

package/esm/Result.d.ts

@@ -0,0 +1,23 @@
+import { D as DynamicSnippetsGeneratorContext } from './DynamicSnippetsGeneratorContext-DKWsHJSo.js';
+import { ErrorReporter } from './context/ErrorReporter.js';
+import { dynamic } from '@fern-fern/ir-sdk/api';
+import '@fern-api/browser-compatible-base-generator';
+import '@fern-api/go-ast';
+import './TypeInstance.js';
+import './DiscriminatedUnionTypeInstance.js';
+
+declare class Result {
+    reporter: ErrorReporter | undefined;
+    snippet: string | undefined;
+    err: Error | undefined;
+    constructor();
+    update({ context, snippet }: {
+        context: DynamicSnippetsGeneratorContext;
+        snippet: string;
+    }): void;
+    getResponseOrThrow({ endpoint }: {
+        endpoint: dynamic.EndpointLocation;
+    }): dynamic.EndpointSnippetResponse;
+}
+
+export { Result };

package/esm/Result.js

@@ -0,0 +1 @@
+import{a}from"./chunk-COBOWL3P.js";import"./chunk-6JCPJA27.js";export{a as Result};

package/esm/Scope.d.ts

@@ -0,0 +1,9 @@
+declare const Scope: {
+    readonly PathParameters: "pathParameters";
+    readonly QueryParameters: "queryParameters";
+    readonly Headers: "headers";
+    readonly RequestBody: "requestBody";
+};
+declare type Scope = typeof Scope[keyof typeof Scope];
+
+export { Scope };

package/esm/Scope.js

@@ -0,0 +1 @@
+import{a}from"./chunk-ZYGZ4VN4.js";import"./chunk-6JCPJA27.js";export{a as Scope};

package/esm/TypeInstance.d.ts

@@ -0,0 +1,15 @@
+import { NameAndWireValue, dynamic } from '@fern-fern/ir-sdk/api';
+
+/**
+ * A type instance that can be converted into a language-specific AST node.
+ *
+ * The 'type' and 'value' are used to convert the AST node itself, and the name
+ * is (optionally) used within the dynamic snippet, e.g. for named fields.
+ */
+interface TypeInstance {
+    name: NameAndWireValue;
+    typeReference: dynamic.TypeReference;
+    value: unknown;
+}
+
+export type { TypeInstance };

package/esm/chunk-4PKXKUYU.js

@@ -0,0 +1 @@
+import{a as s}from"./chunk-KJOW5AZT.js";import{a}from"./chunk-COBOWL3P.js";import{a as m,b as d}from"./chunk-UVYC4FWB.js";import{i as c}from"./chunk-6JCPJA27.js";var f=class extends m{constructor({ir:t,config:r,formatter:n}){super(new d({ir:t,config:r}));c(this,"formatter");this.formatter=n}async generate(t){let r=this.context.resolveEndpointLocationOrThrow(t.endpoint);if(r.length===0)throw new Error(`No endpoints found that match "${t.endpoint.method} ${t.endpoint.path}"`);let n=new a;for(let i of r){let o=this.context.clone(),p=new s({context:o,formatter:this.formatter});try{let e=await p.generateSnippet({endpoint:i,request:t});if(o.errors.empty())return{snippet:e,errors:void 0};n.update({context:o,snippet:e})}catch(e){n.err==null&&(n.err=e)}}return n.getResponseOrThrow({endpoint:t.endpoint})}generateSync(t){let r=this.context.resolveEndpointLocationOrThrow(t.endpoint);if(r.length===0)throw new Error(`No endpoints found that match "${t.endpoint.method} ${t.endpoint.path}"`);let n=new a;for(let i of r){let o=this.context.clone(),p=new s({context:o,formatter:this.formatter});try{let e=p.generateSnippetSync({endpoint:i,request:t});if(o.errors.empty())return{snippet:e,errors:void 0};n.update({context:o,snippet:e})}catch(e){n.err==null&&(n.err=e)}}return n.getResponseOrThrow({endpoint:t.endpoint})}};export{f as a};

package/esm/chunk-5XUC5IOB.js

@@ -0,0 +1 @@
+import{a as o,b as s,i}from"./chunk-6JCPJA27.js";var n={Critical:"CRITICAL",Warning:"WARNING"},p=class a{constructor(){i(this,"errors");i(this,"path");this.errors=[],this.path=[]}add(r){this.errors.push(s(o({},r),{path:[...this.path]}))}scope(r){this.path.push(r)}unscope(){this.path.pop()}getBySeverity(r){return this.errors.filter(e=>e.severity===r)}empty(){return this.errors.length===0}size(){return this.errors.length}clone(){let r=new a;return r.errors=[...this.errors],r.path=[...this.path],r}reset(){this.errors=[],this.path=[]}toDynamicSnippetErrors(){return this.errors.map(r=>({severity:r.severity,path:r.path!=null?this.pathToStringArray(r.path):void 0,message:r.message}))}pathToStringArray(r){let e=[];for(let t of r){if(typeof t=="string"){e.push(t);continue}e[e.length-1]+=`[${t.index}]`}return e}};export{n as a,p as b};

package/esm/chunk-6JCPJA27.js

@@ -0,0 +1 @@
+var k=Object.create;var g=Object.defineProperty,l=Object.defineProperties,m=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyDescriptors,o=Object.getOwnPropertyNames,f=Object.getOwnPropertySymbols,p=Object.getPrototypeOf,i=Object.prototype.hasOwnProperty,j=Object.prototype.propertyIsEnumerable;var h=(a,b,c)=>b in a?g(a,b,{enumerable:!0,configurable:!0,writable:!0,value:c}):a[b]=c,r=(a,b)=>{for(var c in b||(b={}))i.call(b,c)&&h(a,c,b[c]);if(f)for(var c of f(b))j.call(b,c)&&h(a,c,b[c]);return a},s=(a,b)=>l(a,n(b));var t=(a=>typeof require!="undefined"?require:typeof Proxy!="undefined"?new Proxy(a,{get:(b,c)=>(typeof require!="undefined"?require:b)[c]}):a)(function(a){if(typeof require!="undefined")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var u=a=>typeof a=="symbol"?a:a+"",v=(a,b)=>{var c={};for(var d in a)i.call(a,d)&&b.indexOf(d)<0&&(c[d]=a[d]);if(a!=null&&f)for(var d of f(a))b.indexOf(d)<0&&j.call(a,d)&&(c[d]=a[d]);return c};var w=(a,b)=>()=>(b||a((b={exports:{}}).exports,b),b.exports),x=(a,b)=>{for(var c in b)g(a,c,{get:b[c],enumerable:!0})},q=(a,b,c,d)=>{if(b&&typeof b=="object"||typeof b=="function")for(let e of o(b))!i.call(a,e)&&e!==c&&g(a,e,{get:()=>b[e],enumerable:!(d=m(b,e))||d.enumerable});return a};var y=(a,b,c)=>(c=a!=null?k(p(a)):{},q(b||!a||!a.__esModule?g(c,"default",{value:a,enumerable:!0}):c,a));var z=(a,b,c)=>h(a,typeof b!="symbol"?b+"":b,c);export{r as a,s as b,t as c,u as d,v as e,w as f,x as g,y as h,z as i};

package/esm/chunk-BC35GX6S.js

@@ -0,0 +1 @@
+import{a as y,c as r}from"./chunk-VAYOWHUI.js";import{a as s}from"./chunk-5XUC5IOB.js";import{i as p}from"./chunk-6JCPJA27.js";var l=class{constructor({context:t}){p(this,"context");this.context=t}getFilePropertyInfo({body:t,value:i}){var n;let e={fileFields:[],bodyPropertyFields:[]},a=(n=this.context.getRecord(i))!=null?n:{};for(let o of t.properties)switch(o.type){case"file":e.fileFields.push({name:this.context.getTypeName(o.name),value:this.getSingleFileProperty({property:o,record:a})});break;case"fileArray":e.fileFields.push({name:this.context.getTypeName(o.name),value:this.getArrayFileProperty({property:o,record:a})});break;case"bodyProperty":e.bodyPropertyFields.push({name:this.context.getTypeName(o.name.name),value:this.getBodyProperty({property:o,record:a})});break;default:y(o)}return e}getSingleFileProperty({property:t,record:i}){let e=i[t.wireValue];return e==null?r.TypeInstantiation.nop():typeof e!="string"?(this.context.errors.add({severity:s.Critical,message:`Expected file value to be a string, got ${typeof e}`}),r.TypeInstantiation.nop()):r.TypeInstantiation.reference(this.context.getNewStringsReaderFunctionInvocation(e))}getArrayFileProperty({property:t,record:i}){let e=i[t.wireValue];if(e==null)return r.TypeInstantiation.nop();if(!Array.isArray(e))return this.context.errors.add({severity:s.Critical,message:`Expected file array value to be an array of strings, got ${typeof e}`}),r.TypeInstantiation.nop();let a=[];for(let n of e)typeof n!="string"&&this.context.errors.add({severity:s.Critical,message:`Expected file array value to be an array of strings, got ${typeof n}`}),a.push(n);return r.TypeInstantiation.slice({valueType:r.Type.reference(this.context.getIoReaderTypeReference()),values:a.map(n=>r.TypeInstantiation.reference(this.context.getNewStringsReaderFunctionInvocation(n)))})}getBodyProperty({property:t,record:i}){let e=i[t.name.wireValue];return e==null?r.TypeInstantiation.nop():this.context.dynamicTypeInstantiationMapper.convert({typeReference:t.typeReference,value:e})}};export{l as a};

package/esm/chunk-COBOWL3P.js

@@ -0,0 +1 @@
+import{i as t}from"./chunk-6JCPJA27.js";var i=class{constructor(){t(this,"reporter");t(this,"snippet");t(this,"err");this.snippet=void 0,this.reporter=void 0,this.err=void 0}update({context:r,snippet:e}){(this.reporter==null||this.reporter.size()>r.errors.size())&&(this.reporter=r.errors.clone(),this.snippet=e)}getResponseOrThrow({endpoint:r}){var e;if(this.snippet!=null&&this.reporter!=null)return{snippet:this.snippet,errors:this.reporter.toDynamicSnippetErrors()};throw(e=this.err)!=null?e:new Error(`Failed to generate snippet for endpoint "${r.method} ${r.path}"`)}};export{i as a};