@openapi-qraft/tanstack-query-react-plugin 2.0.0-next.7 → 2.0.0-next.9

package/dist/ts-factory/tsdoc/createUseIsFetchingOperationTSDocExample.js

@@ -0,0 +1,41 @@
+import camelcase from 'camelcase';
+import ts from 'typescript';
+import { astToString } from '../astToString.js';
+import { createOperationMethodExampleNodes } from './lib/createOperationMethodExampleNodes.js';
+import { createOperationMethodParametersExampleNodes } from './lib/createOperationMethodParametersExampleNodes.js';
+export const createUseIsFetchingOperationTSDocExample = (operation, serviceVariableName) => {
+    const example = [
+        'Monitors the number of queries currently fetching, matching the provided filters.',
+        'Useful for creating loading indicators or performing actions based on active requests.',
+        '',
+        '@see {@link https://openapi-qraft.github.io/openapi-qraft/docs/hooks/useIsFetching|`useIsFetching(...)` documentation}',
+        '@example Checks the total number of queries fetching from the specified service method,',
+        'both normal and infinite. If no parameters are provided, no filtering is applied.',
+        '```ts',
+        ...(`const ${camelcase(operation.name + '-total')} = ` +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useIsFetching',
+            }, undefined)))
+            .trim()
+            .split('\n'),
+        '```',
+    ];
+    if (operation.parameters?.length) {
+        const factory = ts.factory;
+        example.push('@example Checks the number of normal queries fetching with the specified parameters.', '```ts', ...(`const ${camelcase(operation.name + '-by-parameters-total')} = ` +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useIsFetching',
+            }, [
+                factory.createObjectLiteralExpression([
+                    factory.createPropertyAssignment(factory.createIdentifier('infinite'), factory.createFalse()),
+                    factory.createPropertyAssignment(factory.createIdentifier('parameters'), factory.createObjectLiteralExpression(createOperationMethodParametersExampleNodes(operation), true)),
+                ], true),
+            ])))
+            .trim()
+            .split('\n'), '```');
+    }
+    return example;
+};
+//# sourceMappingURL=createUseIsFetchingOperationTSDocExample.js.map

package/dist/ts-factory/tsdoc/createUseIsFetchingOperationTSDocExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseIsFetchingOperationTSDocExample.js","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseIsFetchingOperationTSDocExample.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,EAAE,2CAA2C,EAAE,MAAM,sDAAsD,CAAC;AAEnH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CACtD,SAA2B,EAC3B,mBAA2B,EAC3B,EAAE;IACF,MAAM,OAAO,GAAa;QACxB,mFAAmF;QACnF,wFAAwF;QACxF,EAAE;QACF,wHAAwH;QACxH,yFAAyF;QACzF,mFAAmF;QACnF,OAAO;QACP,GAAG,CACD,SAAS,SAAS,CAAC,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK;YAClD,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,eAAe;aACrC,EACD,SAAS,CACV,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;QACd,KAAK;KACN,CAAC;IAEF,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;QAE3B,OAAO,CAAC,IAAI,CACV,sFAAsF,EACtF,OAAO,EACP,GAAG,CACD,SAAS,SAAS,CAAC,SAAS,CAAC,IAAI,GAAG,sBAAsB,CAAC,KAAK;YAChE,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,eAAe;aACrC,EACD;gBACE,OAAO,CAAC,6BAA6B,CACnC;oBACE,OAAO,CAAC,wBAAwB,CAC9B,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACpC,OAAO,CAAC,WAAW,EAAE,CACtB;oBACD,OAAO,CAAC,wBAAwB,CAC9B,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,6BAA6B,CACnC,2CAA2C,CAAC,SAAS,CAAC,EACtD,IAAI,CACL,CACF;iBACF,EACD,IAAI,CACL;aACF,CACF,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC,EACd,KAAK,CACN,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/ts-factory/tsdoc/createUseIsMutatingOperationTSDocExample.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceOperation } from '@openapi-qraft/plugin/lib/open-api/getServices';
+export declare const createUseIsMutatingOperationTSDocExample: (operation: ServiceOperation, serviceVariableName: string) => string[];
+//# sourceMappingURL=createUseIsMutatingOperationTSDocExample.d.ts.map

package/dist/ts-factory/tsdoc/createUseIsMutatingOperationTSDocExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseIsMutatingOperationTSDocExample.d.ts","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseIsMutatingOperationTSDocExample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAQvF,eAAO,MAAM,wCAAwC,cACxC,gBAAgB,uBACN,MAAM,aA+D5B,CAAC"}

package/dist/ts-factory/tsdoc/createUseIsMutatingOperationTSDocExample.js

@@ -0,0 +1,41 @@
+import camelcase from 'camelcase';
+import ts from 'typescript';
+import { createOperationCommonTSDoc } from '../../lib/createOperationCommonTSDoc.js';
+import { astToString } from '../astToString.js';
+import { createOperationMethodExampleNodes } from './lib/createOperationMethodExampleNodes.js';
+import { createOperationMethodParametersExampleNodes } from './lib/createOperationMethodParametersExampleNodes.js';
+export const createUseIsMutatingOperationTSDocExample = (operation, serviceVariableName) => {
+    const factory = ts.factory;
+    const example = [
+        'Returns the count of currently in-progress mutations.',
+        '',
+        ...createOperationCommonTSDoc(operation),
+        '@see {@link https://openapi-qraft.github.io/openapi-qraft/docs/hooks/useIsMutating|`useIsMutating(...)` documentation}',
+        '@example Check how many mutations are currently in progress for the specified service method.',
+        '```ts',
+        ...(`const ${camelcase(operation.name + '-total')} = ` +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useIsMutating',
+            }, undefined)))
+            .trim()
+            .split('\n'),
+        '```',
+        '@example Check how many mutations are currently in progress with the specified parameters.',
+        '```ts',
+        ...(`const ${camelcase(operation.name + '-total')} = ` +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useIsMutating',
+            }, [
+                factory.createObjectLiteralExpression([
+                    factory.createPropertyAssignment(factory.createIdentifier('parameters'), factory.createObjectLiteralExpression(createOperationMethodParametersExampleNodes(operation), true)),
+                ], true),
+            ])))
+            .trim()
+            .split('\n'),
+        '```',
+    ];
+    return example;
+};
+//# sourceMappingURL=createUseIsMutatingOperationTSDocExample.js.map

package/dist/ts-factory/tsdoc/createUseIsMutatingOperationTSDocExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseIsMutatingOperationTSDocExample.js","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseIsMutatingOperationTSDocExample.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,EAAE,2CAA2C,EAAE,MAAM,sDAAsD,CAAC;AAEnH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CACtD,SAA2B,EAC3B,mBAA2B,EAC3B,EAAE;IACF,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;IAE3B,MAAM,OAAO,GAAa;QACxB,uDAAuD;QACvD,EAAE;QACF,GAAG,0BAA0B,CAAC,SAAS,CAAC;QACxC,wHAAwH;QAExH,+FAA+F;QAC/F,OAAO;QACP,GAAG,CACD,SAAS,SAAS,CAAC,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK;YAClD,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,eAAe;aACrC,EACD,SAAS,CACV,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;QACd,KAAK;QAEL,4FAA4F;QAC5F,OAAO;QACP,GAAG,CACD,SAAS,SAAS,CAAC,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK;YAClD,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,eAAe;aACrC,EACD;gBACE,OAAO,CAAC,6BAA6B,CACnC;oBACE,OAAO,CAAC,wBAAwB,CAC9B,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,6BAA6B,CACnC,2CAA2C,CAAC,SAAS,CAAC,EACtD,IAAI,CACL,CACF;iBACF,EACD,IAAI,CACL;aACF,CACF,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;QACd,KAAK;KACN,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/ts-factory/tsdoc/createUseMutationOperationTSDocExample.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceOperation } from '@openapi-qraft/plugin/lib/open-api/getServices';
+export declare const createUseMutationOperationTSDocExample: (operation: ServiceOperation, serviceVariableName: string) => string[];
+//# sourceMappingURL=createUseMutationOperationTSDocExample.d.ts.map

package/dist/ts-factory/tsdoc/createUseMutationOperationTSDocExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseMutationOperationTSDocExample.d.ts","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseMutationOperationTSDocExample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAMvF,eAAO,MAAM,sCAAsC,cACtC,gBAAgB,uBACN,MAAM,aA+E5B,CAAC"}

package/dist/ts-factory/tsdoc/createUseMutationOperationTSDocExample.js

@@ -0,0 +1,44 @@
+import ts from 'typescript';
+import { astToString } from '../astToString.js';
+import { createOperationMethodExampleNodes } from './lib/createOperationMethodExampleNodes.js';
+import { createOperationMethodParametersExampleNodes } from './lib/createOperationMethodParametersExampleNodes.js';
+export const createUseMutationOperationTSDocExample = (operation, serviceVariableName) => {
+    const factory = ts.factory;
+    const example = [
+        'Enables performing asynchronous data mutation operations such as POST, PUT, PATCH, or DELETE requests.',
+        'Handles loading state, optimistic updates, and error handling.',
+        '',
+        '@see {@link https://openapi-qraft.github.io/openapi-qraft/docs/hooks/useMutation|`useMutation(...)` documentation}',
+        '@example Mutation with predefined parameters, e.g., for updating',
+        '```ts',
+        ...('const { mutate, isPending } = ' +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useMutation',
+            }, [
+                factory.createObjectLiteralExpression(createOperationMethodParametersExampleNodes(operation), true),
+            ])))
+            .trim()
+            .split('\n'),
+        'mutate(body);',
+        '```',
+    ];
+    example.push('@example Mutation without predefined parameters, e.g., for creating', '```ts', ...('const { mutate, isPending } = ' +
+        astToString(createOperationMethodExampleNodes(operation, {
+            serviceVariableName,
+            operationMethodName: 'useMutation',
+        }, undefined)))
+        .trim()
+        .split('\n'), ...astToString([
+        factory.createExpressionStatement(factory.createCallExpression(factory.createIdentifier('mutate'), undefined, [
+            factory.createObjectLiteralExpression([
+                factory.createPropertyAssignment(factory.createIdentifier('body'), factory.createIdentifier('bodyPayload')),
+                ...createOperationMethodParametersExampleNodes(operation),
+            ], true),
+        ])),
+    ])
+        .trim()
+        .split('\n'), '```');
+    return example;
+};
+//# sourceMappingURL=createUseMutationOperationTSDocExample.js.map

package/dist/ts-factory/tsdoc/createUseMutationOperationTSDocExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseMutationOperationTSDocExample.js","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseMutationOperationTSDocExample.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,EAAE,2CAA2C,EAAE,MAAM,sDAAsD,CAAC;AAEnH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CACpD,SAA2B,EAC3B,mBAA2B,EAC3B,EAAE;IACF,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;IAE3B,MAAM,OAAO,GAAa;QACxB,wGAAwG;QACxG,gEAAgE;QAChE,EAAE;QACF,oHAAoH;QACpH,kEAAkE;QAClE,OAAO;QACP,GAAG,CACD,gCAAgC;YAChC,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,aAAa;aACnC,EACD;gBACE,OAAO,CAAC,6BAA6B,CACnC,2CAA2C,CAAC,SAAS,CAAC,EACtD,IAAI,CACL;aACF,CACF,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;QACd,eAAe;QACf,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,IAAI,CACV,qEAAqE,EACrE,OAAO,EACP,GAAG,CACD,gCAAgC;QAChC,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;YACE,mBAAmB;YACnB,mBAAmB,EAAE,aAAa;SACnC,EACD,SAAS,CACV,CACF,CACF;SACE,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC,EACd,GAAG,WAAW,CAAC;QACb,OAAO,CAAC,yBAAyB,CAC/B,OAAO,CAAC,oBAAoB,CAC1B,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAClC,SAAS,EACT;YACE,OAAO,CAAC,6BAA6B,CACnC;gBACE,OAAO,CAAC,wBAAwB,CAC9B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAChC,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CACxC;gBACD,GAAG,2CAA2C,CAAC,SAAS,CAAC;aAC1D,EACD,IAAI,CACL;SACF,CACF,CACF;KACF,CAAC;SACC,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC,EACd,KAAK,CACN,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/ts-factory/tsdoc/createUseQueryOperationTSDocExample.d.ts

@@ -0,0 +1,3 @@
+import { ServiceOperation } from '@openapi-qraft/plugin/lib/open-api/getServices';
+export declare const createUseQueryOperationTSDocExample: (operation: ServiceOperation, serviceVariableName: string) => string[];
+//# sourceMappingURL=createUseQueryOperationTSDocExample.d.ts.map

package/dist/ts-factory/tsdoc/createUseQueryOperationTSDocExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseQueryOperationTSDocExample.d.ts","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseQueryOperationTSDocExample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAOlF,eAAO,MAAM,mCAAmC,cACnC,gBAAgB,uBACN,MAAM,aAkE5B,CAAC"}

package/dist/ts-factory/tsdoc/createUseQueryOperationTSDocExample.js

@@ -0,0 +1,37 @@
+import ts from 'typescript';
+import { createOperationCommonTSDoc } from '../../lib/createOperationCommonTSDoc.js';
+import { astToString } from '../astToString.js';
+import { createOperationMethodExampleNodes } from './lib/createOperationMethodExampleNodes.js';
+import { createOperationMethodParametersExampleNodes } from './lib/createOperationMethodParametersExampleNodes.js';
+export const createUseQueryOperationTSDocExample = (operation, serviceVariableName) => {
+    const example = [
+        'Performs asynchronous data fetching, manages loading states and error handling.',
+        '',
+        ...createOperationCommonTSDoc(operation),
+        '@see {@link https://openapi-qraft.github.io/openapi-qraft/docs/hooks/useQuery|`useQuery(...)` documentation}',
+    ];
+    if (!operation.parameters?.length ||
+        operation.parameters.every((parameter) => !parameter.required)) {
+        example.push('@example Query without parameters', '```ts', ...('const { data, isLoading } = ' +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useQuery',
+            }, undefined)))
+            .trim()
+            .split('\n'), '```');
+    }
+    if (operation.parameters?.length) {
+        const factory = ts.factory;
+        example.push('@example Query with parameters', '```ts', ...('const { data, isLoading } = ' +
+            astToString(createOperationMethodExampleNodes(operation, {
+                serviceVariableName,
+                operationMethodName: 'useQuery',
+            }, [
+                factory.createObjectLiteralExpression(createOperationMethodParametersExampleNodes(operation), true),
+            ])))
+            .trim()
+            .split('\n'), '```');
+    }
+    return example;
+};
+//# sourceMappingURL=createUseQueryOperationTSDocExample.js.map

package/dist/ts-factory/tsdoc/createUseQueryOperationTSDocExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseQueryOperationTSDocExample.js","sourceRoot":"","sources":["../../../src/ts-factory/tsdoc/createUseQueryOperationTSDocExample.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,EAAE,2CAA2C,EAAE,MAAM,sDAAsD,CAAC;AAEnH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CACjD,SAA2B,EAC3B,mBAA2B,EAC3B,EAAE;IACF,MAAM,OAAO,GAAa;QACxB,iFAAiF;QACjF,EAAE;QACF,GAAG,0BAA0B,CAAC,SAAS,CAAC;QACxC,8GAA8G;KAC/G,CAAC;IAEF,IACE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM;QAC7B,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,EAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CACV,mCAAmC,EACnC,OAAO,EACP,GAAG,CACD,8BAA8B;YAC9B,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,UAAU;aAChC,EACD,SAAS,CACV,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC,EACd,KAAK,CACN,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;QAE3B,OAAO,CAAC,IAAI,CACV,gCAAgC,EAChC,OAAO,EACP,GAAG,CACD,8BAA8B;YAC9B,WAAW,CACT,iCAAiC,CAC/B,SAAS,EACT;gBACE,mBAAmB;gBACnB,mBAAmB,EAAE,UAAU;aAChC,EACD;gBACE,OAAO,CAAC,6BAA6B,CACnC,2CAA2C,CAAC,SAAS,CAAC,EACtD,IAAI,CACL;aACF,CACF,CACF,CACF;aACE,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC,EACd,KAAK,CACN,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/ts-factory/tsdoc/lib/createOperationMethodExampleNodes.d.ts

@@ -0,0 +1,7 @@
+import { ServiceOperation } from '@openapi-qraft/plugin/lib/open-api/getServices';
+import ts from 'typescript';
+export declare const createOperationMethodExampleNodes: (operation: ServiceOperation, { serviceVariableName, operationMethodName, }: {
+    serviceVariableName: string;
+    operationMethodName: string;
+}, nodes: ts.Expression[] | undefined) => ts.ExpressionStatement[];
+//# sourceMappingURL=createOperationMethodExampleNodes.d.ts.map

package/dist/ts-factory/tsdoc/lib/createOperationMethodExampleNodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOperationMethodExampleNodes.d.ts","sourceRoot":"","sources":["../../../../src/ts-factory/tsdoc/lib/createOperationMethodExampleNodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,eAAO,MAAM,iCAAiC,cACjC,gBAAgB,iDAIxB;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,SACxD,EAAE,CAAC,UAAU,EAAE,GAAG,SAAS,6BAsBnC,CAAC"}

package/dist/ts-factory/tsdoc/lib/createOperationMethodExampleNodes.js

@@ -0,0 +1,8 @@
+import ts from 'typescript';
+export const createOperationMethodExampleNodes = (operation, { serviceVariableName, operationMethodName, }, nodes) => {
+    const factory = ts.factory;
+    return [
+        factory.createExpressionStatement(factory.createCallExpression(factory.createPropertyAccessExpression(factory.createPropertyAccessExpression(factory.createPropertyAccessExpression(factory.createIdentifier('qraft'), factory.createIdentifier(serviceVariableName)), factory.createIdentifier(operation.name)), factory.createIdentifier(operationMethodName)), undefined, nodes)),
+    ];
+};
+//# sourceMappingURL=createOperationMethodExampleNodes.js.map

package/dist/ts-factory/tsdoc/lib/createOperationMethodExampleNodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOperationMethodExampleNodes.js","sourceRoot":"","sources":["../../../../src/ts-factory/tsdoc/lib/createOperationMethodExampleNodes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,SAA2B,EAC3B,EACE,mBAAmB,EACnB,mBAAmB,GAC0C,EAC/D,KAAkC,EAClC,EAAE;IACF,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;IAE3B,OAAO;QACL,OAAO,CAAC,yBAAyB,CAC/B,OAAO,CAAC,oBAAoB,CAC1B,OAAO,CAAC,8BAA8B,CACpC,OAAO,CAAC,8BAA8B,CACpC,OAAO,CAAC,8BAA8B,CACpC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,EACjC,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAC9C,EACD,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CACzC,EACD,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAC9C,EACD,SAAS,EACT,KAAK,CACN,CACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/ts-factory/tsdoc/lib/createOperationMethodParametersExampleNodes.d.ts

@@ -0,0 +1,4 @@
+import { ServiceOperation } from '@openapi-qraft/plugin/lib/open-api/getServices';
+import ts from 'typescript';
+export declare const createOperationMethodParametersExampleNodes: (operation: ServiceOperation, transformOperationParameterIdentifier?: (operationParameter: NonNullable<ServiceOperation["parameters"]>[number]) => string) => ts.PropertyAssignment[];
+//# sourceMappingURL=createOperationMethodParametersExampleNodes.d.ts.map

package/dist/ts-factory/tsdoc/lib/createOperationMethodParametersExampleNodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOperationMethodParametersExampleNodes.d.ts","sourceRoot":"","sources":["../../../../src/ts-factory/tsdoc/lib/createOperationMethodParametersExampleNodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAElF,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,eAAO,MAAM,2CAA2C,cAC3C,gBAAgB,0CACa,CACtC,kBAAkB,EAAE,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,KACpE,MAAM,KACV,EAAE,CAAC,kBAAkB,EAwDvB,CAAC"}

package/dist/ts-factory/tsdoc/lib/createOperationMethodParametersExampleNodes.js

@@ -0,0 +1,31 @@
+import camelcase from 'camelcase';
+import ts from 'typescript';
+export const createOperationMethodParametersExampleNodes = (operation, transformOperationParameterIdentifier) => {
+    if (!operation.parameters)
+        return [];
+    const parametersTypeList = operation.parameters
+        .map((parameter) => parameter.in)
+        .filter((parameterKind, index, array) => array.indexOf(parameterKind) === index);
+    const operationRequiredParameters = operation.parameters.filter((parameter) => parameter.required);
+    return parametersTypeList.reduce((acc, parameterKind) => {
+        let operationParameters = operationRequiredParameters.filter((parameter) => parameter.in === parameterKind);
+        if (!operationParameters.length) {
+            const operationParameter = operation.parameters?.find((parameter) => parameter.in === parameterKind);
+            if (operationParameter) {
+                operationParameters = [operationParameter];
+            }
+        }
+        if (!operationParameters.length)
+            return acc;
+        const factory = ts.factory;
+        return [
+            ...acc,
+            factory.createPropertyAssignment(factory.createIdentifier(parameterKind), factory.createObjectLiteralExpression(operationParameters.map((parameter) => factory.createPropertyAssignment(factory.createStringLiteral(parameter.name), parameter.example // todo:: add example type inferring
+                ? factory.createStringLiteral(parameter.example)
+                : factory.createIdentifier(transformOperationParameterIdentifier
+                    ? transformOperationParameterIdentifier(parameter)
+                    : camelcase(parameter.name)))), true)),
+        ];
+    }, []);
+};
+//# sourceMappingURL=createOperationMethodParametersExampleNodes.js.map

package/dist/ts-factory/tsdoc/lib/createOperationMethodParametersExampleNodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOperationMethodParametersExampleNodes.js","sourceRoot":"","sources":["../../../../src/ts-factory/tsdoc/lib/createOperationMethodParametersExampleNodes.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,2CAA2C,GAAG,CACzD,SAA2B,EAC3B,qCAEW,EACc,EAAE;IAC3B,IAAI,CAAC,SAAS,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,kBAAkB,GAAG,SAAS,CAAC,UAAU;SAC5C,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;SAChC,MAAM,CACL,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,KAAK,CACxE,CAAC;IAEJ,MAAM,2BAA2B,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAC7D,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAClC,CAAC;IAEF,OAAO,kBAAkB,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE;QACrB,IAAI,mBAAmB,GAAG,2BAA2B,CAAC,MAAM,CAC1D,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,aAAa,CAC9C,CAAC;QAEF,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,kBAAkB,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,CACnD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,aAAa,CAC9C,CAAC;YACF,IAAI,kBAAkB,EAAE,CAAC;gBACvB,mBAAmB,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,MAAM;YAAE,OAAO,GAAG,CAAC;QAE5C,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;QAE3B,OAAO;YACL,GAAG,GAAG;YACN,OAAO,CAAC,wBAAwB,CAC9B,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,OAAO,CAAC,6BAA6B,CACnC,mBAAmB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACpC,OAAO,CAAC,wBAAwB,CAC9B,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,EAC3C,SAAS,CAAC,OAAO,CAAC,oCAAoC;gBACpD,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC;gBAChD,CAAC,CAAC,OAAO,CAAC,gBAAgB,CACtB,qCAAqC;oBACnC,CAAC,CAAC,qCAAqC,CAAC,SAAS,CAAC;oBAClD,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAC9B,CACN,CACF,EACD,IAAI,CACL,CACF;SACF,CAAC;IACJ,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@openapi-qraft/tanstack-query-react-plugin",
-  "version": "2.0.0-next.7",
+  "version": "2.0.0-next.9",
   "type": "module",
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
+    "codegen": "yarn exec ./generate-ts-factory.mjs",
     "dev": "yarn build --watch --noEmitOnError false",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
@@ -26,16 +27,18 @@
     }
   },
   "dependencies": {
-    "@openapi-qraft/plugin": "^2.0.0-next.7",
-    "typescript": "^5.5.4"
+    "@openapi-qraft/plugin": "^2.0.0-next.9",
+    "typescript": "^5.6.2"
   },
   "devDependencies": {
     "@openapi-qraft/eslint-config": "1.0.0",
     "@openapi-qraft/test-fixtures": "1.0.0",
-    "eslint": "^9.0.0",
-    "memfs": "^4.9.2",
+    "@openapi-qraft/ts-factory-code-generator": "1.0.0",
+    "camelcase": "^8.0.0",
+    "eslint": "^9.10.0",
+    "memfs": "^4.11.1",
     "rimraf": "^5.0.10",
-    "vitest": "^1.4.0"
+    "vitest": "^1.6.0"
   },
   "files": [
     "dist",

package/src/lib/createOperationCommonTSDoc.ts

@@ -0,0 +1,11 @@
+import { ServiceOperation } from '@openapi-qraft/plugin/lib/open-api/getServices';
+
+export const createOperationCommonTSDoc = (operation: ServiceOperation) => {
+  return [
+    operation.deprecated ? '@deprecated' : null,
+    operation.summary ? `@summary ${operation.summary}` : null,
+    operation.description ? `@description ${operation.description}` : null,
+  ].filter((comment): comment is NonNullable<typeof comment> =>
+    Boolean(comment)
+  );
+};

package/src/plugin.ts

@@ -26,17 +26,11 @@ export const plugin: QraftCommandPlugin = {
           return arg?.toLowerCase() !== 'false';
         }
       )
-      .option(
-        '--operation-generics-import-path <path>',
-        'Path to operation generics file',
-        '@openapi-qraft/react'
-      )
       .action(async ({ spinner, output, args, services, schema }, resolve) => {
         return void (await generateCode({
           spinner,
           services,
           serviceImports: {
-            operationGenericsImportPath: args.operationGenericsImportPath,
             openapiTypesImportPath: args.openapiTypesImportPath,
           },
           output: {