fattureincloud · fattureincloud-bot · Jan 1, 2026
diff --git a/templates/openapi-generator/typescript-axios/README.mustache b/templates/openapi-generator/typescript-axios/README.mustache
@@ -1,113 +1,96 @@
-# FattureInCloud TypeScript SDK
-
-[![NPM](https://img.shields.io/npm/v/@fattureincloud/fattureincloud-ts-sdk?color=g)](https://www.npmjs.com/package/@fattureincloud/fattureincloud-ts-sdk) ![unit tests](https://github.com/fattureincloud/fattureincloud-ts-sdk/actions/workflows/validate.yml/badge.svg)
-
-{{npmName}} - TypeScript/JavaScript client for Fatture in Cloud API.
-
 ## {{npmName}}@{{npmVersion}}
 
-This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
+This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
+
+Environment
+* Node.js
+* Webpack
+* Browserify
 
-- API version: {{appVersion}}
-- Package version: {{npmVersion}}
+Language level
+* ES5 - you must have a Promises/A+ library installed
+* ES6
 
 Module system
 * CommonJS
 * ES6 module system
 
-It can be used in both TypeScript and JavaScript. In TypeScript, the definition should be automatically resolved via `package.json`. ([Reference](http://www.typescriptlang.org/docs/handbook/typings-for-npm-packages.html))
-
-
-{{#infoUrl}}
-    For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
-{{/infoUrl}}
-
-## Installation
-
-### For [Node.js](https://nodejs.org/)
+It can be used in both TypeScript and JavaScript. In TypeScript, the definition will be automatically resolved via `package.json`. ([Reference](https://www.typescriptlang.org/docs/handbook/declaration-files/consumption.html))
 
-Using npm:
+### Building
 
-```shell
-npm install {{{npmName}}}
+To build and compile the typescript sources to javascript use:
 ```
-
-Using yarn:
-
-```shell
-yarn add {{{npmName}}}
+npm install
+npm run build
 ```
 
-## Getting Started
+### Publishing
 
-Please follow the [installation](#installation) instruction and execute the following TS code:
+First build the package then run `npm publish`
 
-```javascript
-import { Configuration, ArchiveApi , CreateArchiveDocumentRequest } from '@fattureincloud/fattureincloud-ts-sdk';
+### Consuming
 
-// Configure OAuth2 access token for authorization:
-const apiConfig = new Configuration({
-  accessToken: "YOUR ACCESS TOKEN"
-});
+navigate to the folder of your consuming project and run one of the following commands.
 
-let apiInstance = new ArchiveApi(apiConfig);
-let companyId = 12345; // Number | The ID of the company.
+_published:_
 
-let createArchiveDocumentRequest: CreateArchiveDocumentRequest = {"data":{"date":"2021-08-20","category":"Altri documenti","description":"spesa 1","attachment_token":"ibfjdbf94ey9w94g3w894qbasrga"}} // CreateArchiveDocumentRequest | The Archive Document.
+```
+npm install {{npmName}}@{{npmVersion}} --save
+```
 
-apiInstance.createArchiveDocument(companyId, createArchiveDocumentRequest).then((data) => {
-  console.log('API called successfully. Returned data: ' + data);
-}, (error) => {
-  console.error(error);
-});
+_unPublished (not recommended):_
+
+```
+npm install PATH_TO_GENERATED_PACKAGE --save
 ```
 
-## Documentation for API Endpoints
+### Documentation for API Endpoints
 
-All URIs are relative to *{{basePath}}*
+All URIs are relative to *{{{basePath}}}*
 
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
-{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**](docs/{{apiDocPath}}{{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{summary}}
+{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{summary}}
 {{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
 
-## Documentation for Models
+### Documentation For Models
 
-{{#models}}{{#model}} - [{{classname}}](docs/{{modelDocPath}}{{classname}}.md)
+{{#models}}{{#model}} - [{{{classname}}}]({{modelDocPath}}{{{classname}}}.md)
 {{/model}}{{/models}}
 
-## Documentation for Authorization
+<a id="documentation-for-authorization"></a>
+## Documentation For Authorization
 
-{{^authMethods}}
-    All endpoints do not require authorization.
-{{/authMethods}}
+{{^authMethods}}Endpoints do not require authorization.{{/authMethods}}
+{{#hasAuthMethods}}Authentication schemes defined for the API:{{/hasAuthMethods}}
 {{#authMethods}}
-    {{#last}} Authentication schemes defined for the API:{{/last}}
-
-    ### {{name}}
-
-    {{#isApiKey}}
-
-        - **Type**: API key
-        - **API key parameter name**: {{keyParamName}}
-        - **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}
-    {{/isApiKey}}
-    {{#isBasic}}
-        {{#isBasicBasic}}
-            - **Type**: HTTP basic authentication
-        {{/isBasicBasic}}
-        {{#isBasicBearer}}
-            - **Type**: Bearer authentication{{#bearerFormat}} ({{{.}}}){{/bearerFormat}}
-        {{/isBasicBearer}}
-    {{/isBasic}}
-    {{#isOAuth}}
-
-        - **Type**: OAuth
-        - **Flow**: {{flow}}
-        - **Authorization URL**: {{authorizationUrl}}
-        - **Scopes**: {{^scopes}}N/A{{/scopes}}
-        {{#scopes}}  - _{{scope}}_: {{description}}
-        {{/scopes}}
-    {{/isOAuth}}
+<a id="{{name}}"></a>
+### {{{name}}}
+
+{{#isApiKey}}
+- **Type**: API key
+- **API key parameter name**: {{{keyParamName}}}
+- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}
+{{/isApiKey}}
+{{#isBasic}}
+{{#isBasicBasic}}
+- **Type**: HTTP basic authentication
+{{/isBasicBasic}}
+{{#isBasicBearer}}
+- **Type**: Bearer authentication{{#bearerFormat}} ({{{.}}}){{/bearerFormat}}
+{{/isBasicBearer}}
+{{#isHttpSignature}}
+- **Type**: HTTP signature authentication
+{{/isHttpSignature}}
+{{/isBasic}}
+{{#isOAuth}}
+- **Type**: OAuth
+- **Flow**: {{{flow}}}
+- **Authorization URL**: {{{authorizationUrl}}}
+- **Scopes**: {{^scopes}}N/A{{/scopes}}
+{{#scopes}} - **{{{scope}}}**: {{{description}}}
+{{/scopes}}
+{{/isOAuth}}
 
 {{/authMethods}}
diff --git a/templates/openapi-generator/typescript-axios/apiInner.mustache b/templates/openapi-generator/typescript-axios/apiInner.mustache
@@ -3,23 +3,26 @@
 /* eslint-disable */
 {{>licenseInfo}}
 
+
 import type { Configuration } from '{{apiRelativeToRoot}}configuration{{importFileExtension}}';
 import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import globalAxios from 'axios';
 {{#withNodeImports}}
 // URLSearchParams not necessarily used
 // @ts-ignore
 import { URL, URLSearchParams } from 'url';
+{{#multipartFormData}}
 import FormData from 'form-data'
+{{/multipartFormData}}
 {{/withNodeImports}}
 // Some imports not used depending on template conditions
 // @ts-ignore
-import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction } from '{{apiRelativeToRoot}}common{{importFileExtension}}';
+import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction{{#withAWSV4Signature}}, setAWS4SignatureInterceptor{{/withAWSV4Signature}} } from '{{apiRelativeToRoot}}common{{importFileExtension}}';
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '{{apiRelativeToRoot}}base{{importFileExtension}}';
 {{#imports}}
 // @ts-ignore
-import type { {{classname}} } from '{{apiRelativeToRoot}}{{tsModelPackage}}{{importFileExtension}}';
+import type { {{classname}} } from '{{apiRelativeToRoot}}{{tsModelPackage}}{{#importFileExtension}}/index{{importFileExtension}}{{/importFileExtension}}';
 {{/imports}}
 {{/withSeparateModelsAndApi}}
 {{^withSeparateModelsAndApi}}
@@ -28,7 +31,6 @@ import type { {{classname}} } from '{{apiRelativeToRoot}}{{tsModelPackage}}{{imp
 /**
  * {{classname}} - axios parameter creator{{#description}}
  * {{&description}}{{/description}}
- * @export
  */
 export const {{classname}}AxiosParamCreator = function (configuration?: Configuration) {
     return {
@@ -69,6 +71,10 @@ export const {{classname}}AxiosParamCreator = function (configuration?: Configur
     {{#authMethods}}
             // authentication {{name}} required
             {{#isApiKey}}
+            {{#withAWSV4Signature}}
+            // aws v4 signature authentication required
+            await setAWS4SignatureInterceptor(globalAxios, configuration)
+            {{/withAWSV4Signature}}
             {{#isKeyInHeader}}
             await setApiKeyToObject(localVarHeaderParameter, "{{keyParamName}}", configuration)
             {{/isKeyInHeader}}
@@ -180,21 +186,30 @@ export const {{classname}}AxiosParamCreator = function (configuration?: Configur
                 localVarFormParams.append('{{baseName}}', {{paramName}} as any);{{/isEnumRef}}{{^isEnumRef}}
                 localVarFormParams.append('{{baseName}}', new Blob([JSON.stringify({{paramName}})], { type: "application/json", }));{{/isEnumRef}}{{/isPrimitiveType}}{{/multipartFormData}}
             }{{/isArray}}
-    {{/formParams}}{{/vendorExtensions}}
-    {{#vendorExtensions}}{{#hasFormParams}}{{^multipartFormData}}
-            localVarHeaderParameter['Content-Type'] = 'application/x-www-form-urlencoded';{{/multipartFormData}}{{#multipartFormData}}
-            localVarHeaderParameter['Content-Type'] = 'multipart/form-data';{{/multipartFormData}}
-    {{/hasFormParams}}{{/vendorExtensions}}
+    {{/formParams}}
+    {{/vendorExtensions}}
+    {{#vendorExtensions}}
+    {{#hasFormParams}}
+    {{^multipartFormData}}
+            localVarHeaderParameter['Content-Type'] = 'application/x-www-form-urlencoded';
+    {{/multipartFormData}}
+    {{#multipartFormData}}
+            localVarHeaderParameter['Content-Type'] = 'multipart/form-data';
+    {{/multipartFormData}}
+    {{/hasFormParams}}
+    {{/vendorExtensions}}
     {{#bodyParam}}
             {{^consumes}}
             localVarHeaderParameter['Content-Type'] = 'application/json';
             {{/consumes}}
             {{#consumes.0}}
             localVarHeaderParameter['Content-Type'] = '{{{mediaType}}}';
             {{/consumes.0}}
-            localVarHeaderParameter['User-Agent'] = 'FattureInCloud/{{{npmVersion}}}/TypeScript-SDK';
-
     {{/bodyParam}}
+    {{#hasProduces}}
+            localVarHeaderParameter['Accept'] = '{{#produces}}{{{mediaType}}}{{^-last}},{{/-last}}{{/produces}}';
+    {{/hasProduces}}
+
     {{#headerParams}}
             {{#isArray}}
             if ({{paramName}}) {
@@ -244,7 +259,6 @@ export const {{classname}}AxiosParamCreator = function (configuration?: Configur
 /**
  * {{classname}} - functional programming interface{{#description}}
  * {{{.}}}{{/description}}
- * @export
  */
 export const {{classname}}Fp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = {{classname}}AxiosParamCreator(configuration)
@@ -275,7 +289,6 @@ export const {{classname}}Fp = function(configuration?: Configuration) {
 /**
  * {{classname}} - factory interface{{#description}}
  * {{&description}}{{/description}}
- * @export
  */
 export const {{classname}}Factory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = {{classname}}Fp(configuration)
@@ -318,8 +331,6 @@ export const {{classname}}Factory = function (configuration?: Configuration, bas
 /**
  * {{classname}} - interface{{#description}}
  * {{&description}}{{/description}}
- * @export
- * @interface {{classname}}
  */
 export interface {{classname}}Interface {
 {{#operation}}
@@ -341,7 +352,6 @@ export interface {{classname}}Interface {
      * @param {*} [options] Override http request option.{{#isDeprecated}}
      * @deprecated{{/isDeprecated}}
      * @throws {RequiredError}
-     * @memberof {{classname}}Interface
      */
     {{#useSingleRequestParameter}}
     {{nickname}}({{#allParams.0}}requestParameters{{^hasRequiredParams}}?{{/hasRequiredParams}}: {{classname}}{{operationIdCamelCase}}Request, {{/allParams.0}}options?: RawAxiosRequestConfig): AxiosPromise<{{{returnType}}}{{^returnType}}void{{/returnType}}>;
@@ -359,16 +369,14 @@ export interface {{classname}}Interface {
 {{#allParams.0}}
 /**
  * Request parameters for {{nickname}} operation in {{classname}}.
- * @export
- * @interface {{classname}}{{operationIdCamelCase}}Request
  */
 export interface {{classname}}{{operationIdCamelCase}}Request {
     {{#allParams}}
+    {{#description}}
     /**
      * {{description}}
-     * @type {{=<% %>=}}{<%&dataType%>}<%={{ }}=%>
-     * @memberof {{classname}}{{operationIdCamelCase}}
      */
+    {{/description}}
     readonly {{paramName}}{{^required}}?{{/required}}: {{#isEnum}}{{{datatypeWithEnum}}}{{/isEnum}}{{^isEnum}}{{{dataType}}}{{#isNullable}} | null{{/isNullable}}{{/isEnum}}
     {{^-last}}
 
@@ -382,9 +390,6 @@ export interface {{classname}}{{operationIdCamelCase}}Request {
 /**
  * {{classname}} - object-oriented interface{{#description}}
  * {{{.}}}{{/description}}
- * @export
- * @class {{classname}}
- * @extends {BaseAPI}
  */
 {{#withInterfaces}}
 export class {{classname}} extends BaseAPI implements {{classname}}Interface {
@@ -411,7 +416,6 @@ export class {{classname}} extends BaseAPI {
      * @param {*} [options] Override http request option.{{#isDeprecated}}
      * @deprecated{{/isDeprecated}}
      * @throws {RequiredError}
-     * @memberof {{classname}}
      */
     {{#useSingleRequestParameter}}
     public {{nickname}}({{#allParams.0}}requestParameters: {{classname}}{{operationIdCamelCase}}Request{{^hasRequiredParams}} = {}{{/hasRequiredParams}}, {{/allParams.0}}options?: RawAxiosRequestConfig) {
@@ -435,10 +439,6 @@ export class {{classname}} extends BaseAPI {
 {{#allParams}}
 {{#isEnum}}
 {{#stringEnums}}
-/**
-  * @export
-  * @enum {string}
-  */
 export enum {{operationIdCamelCase}}{{enumName}} {
 {{#allowableValues}}
     {{#enumVars}}
@@ -448,9 +448,6 @@ export enum {{operationIdCamelCase}}{{enumName}} {
 }
 {{/stringEnums}}
 {{^stringEnums}}
-/**
- * @export
- */
 export const {{operationIdCamelCase}}{{enumName}} = {
 {{#allowableValues}}
     {{#enumVars}}

diff --git a/templates/openapi-generator/typescript-axios/index.mustache b/templates/openapi-generator/typescript-axios/index.mustache
@@ -2,8 +2,7 @@
 /* eslint-disable */
 {{>licenseInfo}}
 
-export * from "./src/filter";
-export * from "./src/oauth2";
+
 export * from "./api{{importFileExtension}}";
 export * from "./configuration{{importFileExtension}}";
-{{#withSeparateModelsAndApi}}export * from "./{{tsModelPackage}}{{importFileExtension}}";{{/withSeparateModelsAndApi}}
+{{#withSeparateModelsAndApi}}export * from "./{{tsModelPackage}}{{#importFileExtension}}/index{{importFileExtension}}{{/importFileExtension}}";{{/withSeparateModelsAndApi}}