@shopware/api-client - npm Package Compare versions

Comparing version 0.0.3 to 0.1.0

api-types/index.d.ts

@@ -1,1 +0,1 @@
-export * from "./apiTypes-6.5.2.0";
+export * from "./apiTypes-6.5.3.0";

package.json

 {
   "name": "@shopware/api-client",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "Shopware client for API connection.",
@@ -30,11 +30,12 @@ "author": "Shopware",
   "devDependencies": {
-    "@types/prettier": "^2.7.2",
+    "@types/prettier": "^2.7.3",
     "@vitest/coverage-c8": "^0.32.2",
     "prettier": "^2.8.8",
     "vitest": "^0.32.2",
-    "eslint-config-shopware": "0.0.2",
+    "eslint-config-shopware": "0.0.3",
+    "@shopware/api-gen": "0.0.4",
     "tsconfig": "0.0.0"
   },
   "dependencies": {
-    "ofetch": "^1.0.1"
+    "ofetch": "^1.1.1"
   },
@@ -45,3 +46,5 @@ "scripts": {
     "dev": "export NODE_ENV=development && unbuild --stub",
-    "lint": "eslint src/**/*.ts* --fix --max-warnings=0",
+    "generate": "esno ../api-gen/src/cli.ts generate",
+    "lint": "eslint src/**/*.ts* --fix --max-warnings=0 && pnpm run typecheck",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run && pnpm run test:types",
@@ -48,0 +51,0 @@ "test:types": "vitest typecheck --run",

README.md

 # shopware/frontends - api-client
 
-Welcome to `@shopware/api-client` package.
+[![](https://img.shields.io/npm/v/@shopware/api-client?color=blue&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCA0ODggNTUzIiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJNNDM5LjA0MSAxMjkuNTkzTDI1OC43NjkgMzEuMzA3NkMyNDQuOTE1IDIzLjc1NDEgMjI4LjExNiAyNC4wMDkzIDIxNC40OTcgMzEuOTgwMkw0Ny4yNjkgMTI5Ljg1OEMzMy40NzYzIDEzNy45MzEgMjUgMTUyLjcxMyAyNSAxNjguNjk1VjM4OC40NjZDMjUgNDA0LjczMiAzMy43Nzg1IDQxOS43MzIgNDcuOTYwMiA0MjcuNjk5TDIxNS4xNzggNTIxLjYzNkMyMjguNDUxIDUyOS4wOTIgMjQ0LjU5MyA1MjkuMzMyIDI1OC4wODIgNTIyLjI3NEw0MzguMzY0IDQyNy45MzRDNDUzLjIwMSA0MjAuMTcgNDYyLjUgNDA0LjgwOSA0NjIuNSAzODguMDYzVjE2OS4xMDJDNDYyLjUgMTUyLjYzMiA0NTMuNTAyIDEzNy40NzcgNDM5LjA0MSAxMjkuNTkzWiIgc3Ryb2tlPSJ1cmwoI3BhaW50MF9saW5lYXJfMTUzXzY5MjY1KSIgc3Ryb2tlLXdpZHRoPSI1MCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIvPgo8ZGVmcz4KPGxpbmVhckdyYWRpZW50IGlkPSJwYWludDBfbGluZWFyXzE1M182OTI2NSIgeDE9Ii0xNi4yOTg5IiB5MT0iMTY1LjM0OSIgeDI9IjI3Ni40MTIiIHkyPSItODkuMzIzNCIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPgo8c3RvcCBzdG9wLWNvbG9yPSIjMDA4NUZGIi8+CjxzdG9wIG9mZnNldD0iMSIgc3RvcC1jb2xvcj0iI0MwRTJGNSIvPgo8L2xpbmVhckdyYWRpZW50Pgo8L2RlZnM+Cjwvc3ZnPg==)](https://npmjs.com/package/@shopware/api-client)
+[![](https://img.shields.io/github/package-json/v/shopware/frontends?color=blue&filename=packages%2Fapi-client-next%2Fpackage.json&label=frontends/api-client&logo=github)](https://github.com/shopware/frontends/tree/main/packages/api-client-next)
+![](https://img.shields.io/github/license/shopware/frontends?color=blue)
+[![](https://img.shields.io/github/issues/shopware/frontends/api-client?label=package%20issues&logo=github)](https://github.com/shopware/frontends/issues?q=is%3Aopen+is%3Aissue+label%3Aapi-client)
 
-For getting started documentation visit [https://frontends.shopware.com/](https://frontends.shopware.com/)
+Dynamic and fully typed API Client for Shopware 6. Usable in any JavaScript an TypeScript project.
+You can use types generated from your custom API instance to have autocompletion and type safety.
 
-Documentation specific for this package: [api-client](https://frontends.shopware.com/packages/api-client.html)
+## Setup
 
+Install npm package:
+
+```bash
+# Using pnpm
+pnpm add @shopware/api-client
+
+# Using yarn
+yarn add @shopware/api-client
+
+# Using npm
+npm i @shopware/api-client
+```
+
+Recommended practice is to create separate module file. For example `src/apiClient.ts`, and import it whenever you need to use API Client.
+
+```typescript
+import { createAPIClient } from "@shopware/api-client";
+
+// You can pick types of your current API version, the default one:
+import {
+  operationPaths,
+  operations,
+  components,
+} from "@shopware/api-client/api-types";
+// or (specific version):
+import {
+  operationPaths,
+  operations,
+  components,
+} from "@shopware/api-client/api-types/apiTypes-6.4.20.0";
+// or your types generated by @shopware/api-gen CLI:
+import { operationPaths, operations, components } from "./apiTypes";
+
+// you can pick cookies library of your choice
+import Cookies from "js-cookie";
+
+export const apiClient = createAPIClient<operations, operationPaths>({
+  baseURL: "https://demo-frontends.shopware.store/store-api",
+  accessToken: "SWSCBHFSNTVMAWNZDNFKSHLAYW",
+  contextToken: Cookies.get("sw-context-token"),
+  apiType: "store-api",
+  onContextChanged(newContextToken) {
+    Cookies.set("sw-context-token", newContextToken, {
+      expires: 365, // days
+      path: "/",
+      sameSite: "lax",
+    });
+  },
+});
+
+// reimport schemas to use it in application
+export type ApiSchemas = components["schemas"];
+// reimport operations request parameters to use it in application
+export type ApiRequestParams<OPERATION_NAME extends keyof operations> =
+  RequestParameters<OPERATION_NAME, operations>;
+// reimport operations return types to use it in application
+export type ApiReturnType<OPERATION_NAME extends keyof operations> =
+  RequestReturnType<OPERATION_NAME, operations>;
+```
+
+## Basic usage
+
+Take a look at [example project using API Client](https://stackblitz.com/github/shopware/frontends/tree/main/examples/new-api-client).
+
+### Simple invocation
+
+```typescript
+import { apiClient, ApiReturnType } from "./apiClient";
+
+// could be reactive value, you can use ApiReturnType to type it properly
+let productsResponse: ApiReturnType<"readProduct">;
+
+async function loadProducts() {
+  productsResponse = await apiClient.invoke("readProduct post /product", {
+    limit: 2,
+  });
+}
+```
+
+### Predefining methods
+
+If you prefer to add another layer of abstraction you can use created previously types to define your own concept of methods.
+
+```typescript
+// add for example into apiClient.ts file
+const readNavigation = (params: ApiRequestParams<"readNavigation">) =>
+  apiClient.invoke(
+    "readNavigation post /navigation/{activeId}/{rootId} sw-include-seo-urls",
+    {
+      depth: 2,
+      ...params,
+    }
+  );
+
+// in another file you can use it, and depth property will be set to 2 by default
+import { readNavigation } from "./apiClient";
+
+async function loadMainNavigation() {
+  const navigation = await readNavigation({
+    activeId: "main-navigation",
+    rootId: "main-navigation",
+  });
+}
+```
+
+## Links
+
+- [📘 Documentation](https://frontends.shopware.com)
+
+- [👥 Community Slack](https://shopwarecommunity.slack.com) (`#shopware-frontends` channel)
+
 <!-- AUTO GENERATED CHANGELOG -->
@@ -15,6 +130,15 @@
 
-### Latest changes: 0.0.3
+### Latest changes: 0.1.0
 
+### Minor Changes
+
+- [#300](https://github.com/shopware/frontends/pull/300) [`da347b5`](https://github.com/shopware/frontends/commit/da347b548aea93afaab1cc9ebab63f732ecdb964) Thanks [@patzick](https://github.com/patzick)! - Predefining methods: exported `RequestReturnType ` and `RequestParameters` types. You can now create predefined methods:
+
+  ```typescript
+  const readCart = (params: RequestParameters<"readCart", operations>) =>
+    apiInstance.invoke("readCart get /checkout/cart?name", params);
+  ```
+
 ### Patch Changes
 
-- [#290](https://github.com/shopware/frontends/pull/290) [`9562a8a`](https://github.com/shopware/frontends/commit/9562a8add35751093d766017abba474f0ad578f8) Thanks [@patzick](https://github.com/patzick)! - ship api-types with package
+- [#295](https://github.com/shopware/frontends/pull/295) [`23a0a53`](https://github.com/shopware/frontends/commit/23a0a532410990c0075ea7fff622949ccdecfd49) Thanks [@patzick](https://github.com/patzick)! - bump dependencies

Fixed alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

3854888

increased by21.61%

Number of package files

16

increased by14.29%

Lines of code

115528

increased by20.81%

Number of lines in readme file

144

increased by620%

Number of medium supply chain risk alerts

0

decreased by-100%

Worsened metrics

Dev dependency count

7

increased by16.67%

Dependency changes

• Updatedofetch@^1.1.1