@conduit-client/generator-ts 3.19.0 → 3.19.2

package/dist/types/v1/generators/aura-command-generator.d.ts

@@ -11,6 +11,7 @@ import { HttpCommandGenerator } from './http-command-generator';
  */
 export declare class AuraCommandGenerator extends HttpCommandGenerator {
     commandBaseClass: ImportableTypeReference;
+    protected get hasSemanticNullResponses(): boolean;
     get commandGeneratedClass(): ImportableTypeReference;
     /**
      * Constructs and returns an array of code blocks that form the body of the Aura-specific command class.

package/dist/types/v1/generators/http-command-generator.d.ts

@@ -13,12 +13,15 @@ export declare const MEDIATYPE_APP_JSON = "application/json";
 export declare class HttpCommandGenerator extends CommandGenerator {
     commandBaseClass: ImportableTypeReference;
     get commandGeneratedClass(): ImportableTypeReference;
+    protected get hasSemanticNullResponses(): boolean;
+    protected buildCommandTypeGenerics(): Code;
     /**
      * Constructs and returns an array of code blocks that form the body of the HTTP command class.
      * Includes methods for generating fetch parameters and error coercion logic.
      * @returns {Code[]} An array of code snippets that define the command class body for HTTP operations.
      */
     get classBody(): Code[];
+    protected generateAdditionalNullResponses(): Code[];
     /**
      * Generates a code block for fetch parameters based on the command model's configuration.
      * Constructs a detailed setup for fetch operations including method, headers, body, and cache settings.

package/dist/types/v1/model/base-command-model.d.ts

@@ -108,6 +108,7 @@ export type ICommandModel = {
     serverUrlPath: string;
     endpointUrlPath: string;
     invalidationConfigs: InvalidationConfig[];
+    semanticNullStatusCodes: readonly number[];
 };
 /**
  * Base abstract class for command models that encapsulates the common functionality required by all command models.
@@ -173,6 +174,7 @@ export declare abstract class BaseCommandModel implements ICommandModel {
     get serverUrlPath(): string;
     get endpointUrlPath(): string;
     get request(): import("@conduit-client/model/v1").Request<Type>;
+    get semanticNullStatusCodes(): readonly number[];
     get invalidationConfigs(): InvalidationConfig[];
     protected buildBody(): {
         content: ContentModel;

package/dist/v1/index.js

@@ -2579,13 +2579,39 @@ class HttpCommandGenerator extends CommandGenerator {
   get commandGeneratedClass() {
     return GENERATED_FETCH_NETWORK_COMMAND;
   }
+  get hasSemanticNullResponses() {
+    var _a;
+    return (((_a = this.commandModel.semanticNullStatusCodes) == null ? void 0 : _a.length) ?? 0) > 0;
+  }
+  buildCommandTypeGenerics() {
+    var _a;
+    const extraServicesCode = this.buildExtraServices();
+    const responseType = this.services.typeDefinition.build(
+      (_a = this.commandModel.responseType) == null ? void 0 : _a.default[MEDIATYPE_APP_JSON]
+    );
+    const dataType = this.hasSemanticNullResponses ? code`${responseType} | null` : responseType;
+    return code`${dataType}${extraServicesCode ? code`, ${extraServicesCode}` : ""}`;
+  }
   /**
    * Constructs and returns an array of code blocks that form the body of the HTTP command class.
    * Includes methods for generating fetch parameters and error coercion logic.
    * @returns {Code[]} An array of code snippets that define the command class body for HTTP operations.
    */
   get classBody() {
-    return [code`${this.generateFetchParams()}`, this.generateCoerceError()];
+    return [
+      code`${this.generateFetchParams()}`,
+      this.generateCoerceError(),
+      ...this.generateAdditionalNullResponses()
+    ];
+  }
+  generateAdditionalNullResponses() {
+    const codes = this.commandModel.semanticNullStatusCodes ?? [];
+    if (codes.length === 0) {
+      return [];
+    }
+    return [
+      code`protected readonly additionalNullResponses:ReadonlyArray<number>=[${codes.join(",")}];`
+    ];
   }
   /**
    * Generates a code block for fetch parameters based on the command model's configuration.
@@ -2755,6 +2781,9 @@ class AuraCommandGenerator extends HttpCommandGenerator {
     super(...arguments);
     this.commandBaseClass = AURA_COMMAND_BASE_CLASS;
   }
+  get hasSemanticNullResponses() {
+    return false;
+  }
   get commandGeneratedClass() {
     return GENERATED_AURA_NETWORK_COMMAND;
   }
@@ -2999,10 +3028,11 @@ class ImperativeAdapterBindingGenerator {
     return code`${DEFAULT_IMPERATIVE_RETURN_SHAPE}`;
   }
   get responseTypeCode() {
-    var _a;
-    return this.services.typeDefinition.build(
+    var _a, _b;
+    const baseType = this.services.typeDefinition.build(
       (_a = this.commandModel.responseType) == null ? void 0 : _a.default["application/json"]
     );
+    return this.commandModel.transportType === "http" && (((_b = this.commandModel.semanticNullStatusCodes) == null ? void 0 : _b.length) ?? 0) > 0 ? code`${baseType} | null` : baseType;
   }
   get invoker() {
     if (this.isSubscribable()) {
@@ -3071,10 +3101,11 @@ class ImperativeAdapterLegacyBindingGenerator {
     };
   }
   get responseTypeCode() {
-    var _a;
-    return this.services.typeDefinition.build(
+    var _a, _b;
+    const baseType = this.services.typeDefinition.build(
       (_a = this.commandModel.responseType) == null ? void 0 : _a.default["application/json"]
     );
+    return this.commandModel.transportType === "http" && (((_b = this.commandModel.semanticNullStatusCodes) == null ? void 0 : _b.length) ?? 0) > 0 ? code`${baseType} | null` : baseType;
   }
   buildDeclaration() {
     return code`let ${this.binding.identifier}:${LEGACY_IMPERATIVE_RETURN_SHAPE}<${this.commandConfigTypeImport},${this.responseTypeCode}>;`;
@@ -3188,10 +3219,11 @@ class WireAdapterBindingGenerator {
     };
   }
   get responseTypeCode() {
-    var _a;
-    return this.services.typeDefinition.build(
+    var _a, _b;
+    const baseType = this.services.typeDefinition.build(
       (_a = this.commandModel.responseType) == null ? void 0 : _a.default["application/json"]
     );
+    return this.commandModel.transportType === "http" && (((_b = this.commandModel.semanticNullStatusCodes) == null ? void 0 : _b.length) ?? 0) > 0 ? code`${baseType} | null` : baseType;
   }
   buildDeclaration() {
     return code`let ${this.binding.identifier}:${WIRE_ADAPTER_CONSTRUCTOR$1}<${this.commandConfigTypeImport}, ${WIRE_ADAPTER_RESULT$1}<${this.responseTypeCode}>, {}>;`;
@@ -4738,6 +4770,12 @@ class BaseCommandModel {
   get request() {
     return this.operation.requests[0];
   }
+  get semanticNullStatusCodes() {
+    return this.operation.responses.filter((res) => {
+      const code2 = parseInt(res.statusCode, 10);
+      return code2 >= 200 && code2 < 300 && res.payloads.length === 0;
+    }).map((res) => parseInt(res.statusCode, 10));
+  }
   get invalidationConfigs() {
     return this.operation.responses.filter((res) => {
       return res.invalidation !== void 0;