@pagopa/io-react-native-wallet 0.11.1 → 0.13.0

package/lib/typescript/wallet-instance-attestation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/wallet-instance-attestation/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA2BzB,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAC;AACF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAC;AACF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BvC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/wallet-instance-attestation/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA2BzB,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAC;AACF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAC;AACF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagopa/io-react-native-wallet",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "Provide data structures, helpers and API for IO Wallet",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -34,7 +34,9 @@
     "release": "release-it",
     "example": "yarn --cwd example",
     "bootstrap": "yarn example && yarn install",
-    "code-review": "yarn lint && yarn typecheck && yarn test"
+    "code-review": "yarn generate && yarn lint && yarn typecheck && yarn test",
+    "generate-wallet-provider-client": "typed-openapi openapi/wallet-provider.yaml -o src/client/generated/wallet-provider.ts -r zod",
+    "generate": "yarn generate-wallet-provider-client"
   },
   "keywords": [
     "react-native",
@@ -53,8 +55,8 @@
   "devDependencies": {
     "@pagopa/eslint-config": "^3.0.0",
     "@pagopa/io-react-native-crypto": "^0.2.3",
-    "@pagopa/io-react-native-jwt": "^1.0.0",
-    "@react-native-community/eslint-config": "^3.2.0",
+    "@pagopa/io-react-native-jwt": "^1.2.0",
+    "@react-native/eslint-config": "^0.72.2",
     "@rushstack/eslint-patch": "^1.3.2",
     "@types/jest": "^28.1.2",
     "@types/react": "~17.0.21",
@@ -66,8 +68,9 @@
     "pod-install": "^0.1.0",
     "prettier": "^2.0.5",
     "react": "18.2.0",
-    "react-native": "0.71.8",
+    "react-native": "0.72.14",
     "react-native-builder-bob": "^0.20.0",
+    "typed-openapi": "^0.4.1",
     "typescript": "^5.0.2"
   },
   "resolutions": {
@@ -105,6 +108,7 @@
     ]
   },
   "dependencies": {
+    "parse-url": "^9.2.0",
     "react-native-url-polyfill": "^2.0.0",
     "react-native-uuid": "^2.0.1",
     "zod": "^3.21.4"

package/src/client/generated/wallet-provider.ts

@@ -0,0 +1,173 @@
+import z from "zod";
+
+export type NonceDetailView = z.infer<typeof NonceDetailView>;
+export const NonceDetailView = z.object({
+  nonce: z.string(),
+});
+
+export type WalletAttestationView = z.infer<typeof WalletAttestationView>;
+export const WalletAttestationView = z.string();
+
+export type CreateWalletInstanceBody = z.infer<typeof CreateWalletInstanceBody>;
+export const CreateWalletInstanceBody = z.object({
+  challenge: z.string(),
+  key_attestation: z.string(),
+  hardware_key_tag: z.string(),
+});
+
+export type CreateWalletAttestationBody = z.infer<typeof CreateWalletAttestationBody>;
+export const CreateWalletAttestationBody = z.object({
+  grant_type: z.literal("urn:ietf:params:oauth:grant-type:jwt-bearer"),
+  assertion: z.string(),
+});
+
+export type ProblemDetail = z.infer<typeof ProblemDetail>;
+export const ProblemDetail = z.object({
+  type: z.string().optional(),
+  title: z.string().optional(),
+  status: z.number().optional(),
+  detail: z.string().optional(),
+  instance: z.string().optional(),
+});
+
+export type FiscalCode = z.infer<typeof FiscalCode>;
+export const FiscalCode = z.string();
+
+export type Id = z.infer<typeof Id>;
+export const Id = z.string();
+
+export type get_GetNonce = typeof get_GetNonce;
+export const get_GetNonce = {
+  method: z.literal("GET"),
+  path: z.literal("/nonce"),
+  parameters: z.never(),
+  response: NonceDetailView,
+};
+
+export type post_CreateWalletInstance = typeof post_CreateWalletInstance;
+export const post_CreateWalletInstance = {
+  method: z.literal("POST"),
+  path: z.literal("/wallet-instances"),
+  parameters: z.object({
+    body: CreateWalletInstanceBody,
+  }),
+  response: z.unknown(),
+};
+
+export type post_CreateWalletAttestation = typeof post_CreateWalletAttestation;
+export const post_CreateWalletAttestation = {
+  method: z.literal("POST"),
+  path: z.literal("/token"),
+  parameters: z.object({
+    body: CreateWalletAttestationBody,
+  }),
+  response: z.unknown(),
+};
+
+// <EndpointByMethod>
+export const EndpointByMethod = {
+  get: {
+    "/nonce": get_GetNonce,
+  },
+  post: {
+    "/wallet-instances": post_CreateWalletInstance,
+    "/token": post_CreateWalletAttestation,
+  },
+};
+export type EndpointByMethod = typeof EndpointByMethod;
+// </EndpointByMethod>
+
+// <EndpointByMethod.Shorthands>
+export type GetEndpoints = EndpointByMethod["get"];
+export type PostEndpoints = EndpointByMethod["post"];
+export type AllEndpoints = EndpointByMethod[keyof EndpointByMethod];
+// </EndpointByMethod.Shorthands>
+
+// <ApiClientTypes>
+export type EndpointParameters = {
+  body?: unknown;
+  query?: Record<string, unknown>;
+  header?: Record<string, unknown>;
+  path?: Record<string, unknown>;
+};
+
+export type MutationMethod = "post" | "put" | "patch" | "delete";
+export type Method = "get" | "head" | MutationMethod;
+
+export type DefaultEndpoint = {
+  parameters?: EndpointParameters | undefined;
+  response: unknown;
+};
+
+export type Endpoint<TConfig extends DefaultEndpoint = DefaultEndpoint> = {
+  operationId: string;
+  method: Method;
+  path: string;
+  parameters?: TConfig["parameters"];
+  meta: {
+    alias: string;
+    hasParameters: boolean;
+    areParametersRequired: boolean;
+  };
+  response: TConfig["response"];
+};
+
+type Fetcher = (
+  method: Method,
+  url: string,
+  parameters?: EndpointParameters | undefined,
+) => Promise<Endpoint["response"]>;
+
+type RequiredKeys<T> = {
+  [P in keyof T]-?: undefined extends T[P] ? never : P;
+}[keyof T];
+
+type MaybeOptionalArg<T> = RequiredKeys<T> extends never ? [config?: T] : [config: T];
+
+// </ApiClientTypes>
+
+// <ApiClient>
+export class ApiClient {
+  baseUrl: string = "";
+
+  constructor(public fetcher: Fetcher) {}
+
+  setBaseUrl(baseUrl: string) {
+    this.baseUrl = baseUrl;
+    return this;
+  }
+
+  // <ApiClient.get>
+  get<Path extends keyof GetEndpoints, TEndpoint extends GetEndpoints[Path]>(
+    path: Path,
+    ...params: MaybeOptionalArg<z.infer<TEndpoint["parameters"]>>
+  ): Promise<z.infer<TEndpoint["response"]>> {
+    return this.fetcher("get", this.baseUrl + path, params[0]) as Promise<z.infer<TEndpoint["response"]>>;
+  }
+  // </ApiClient.get>
+
+  // <ApiClient.post>
+  post<Path extends keyof PostEndpoints, TEndpoint extends PostEndpoints[Path]>(
+    path: Path,
+    ...params: MaybeOptionalArg<z.infer<TEndpoint["parameters"]>>
+  ): Promise<z.infer<TEndpoint["response"]>> {
+    return this.fetcher("post", this.baseUrl + path, params[0]) as Promise<z.infer<TEndpoint["response"]>>;
+  }
+  // </ApiClient.post>
+}
+
+export function createApiClient(fetcher: Fetcher, baseUrl?: string) {
+  return new ApiClient(fetcher).setBaseUrl(baseUrl ?? "");
+}
+
+/**
+ Example usage:
+ const api = createApiClient((method, url, params) =>
+   fetch(url, { method, body: JSON.stringify(params) }).then((res) => res.json()),
+ );
+ api.get("/users").then((users) => console.log(users));
+ api.post("/users", { body: { name: "John" } }).then((user) => console.log(user));
+ api.put("/users/:id", { path: { id: 1 }, body: { name: "John" } }).then((user) => console.log(user));
+*/
+
+// </ApiClient

package/src/client/index.ts

@@ -0,0 +1,53 @@
+import { WalletProviderResponseError } from "../utils/errors";
+import {
+  ProblemDetail,
+  createApiClient as createWalletProviderApiClient,
+} from "./generated/wallet-provider";
+import { ApiClient as WalletProviderApiClient } from "./generated/wallet-provider";
+
+export type WalletProviderClient = WalletProviderApiClient;
+
+const validateResponse = async (response: Response) => {
+  if (!response.ok) {
+    let problemDetail: ProblemDetail = {};
+    try {
+      problemDetail = ProblemDetail.parse(await response.json());
+    } catch {
+      problemDetail = {
+        title: "Invalid response from Wallet Provider",
+      };
+    }
+
+    throw new WalletProviderResponseError(
+      problemDetail.title ?? "Invalid response from Wallet Provider",
+      problemDetail.type,
+      problemDetail.detail,
+      response.status
+    );
+  }
+  return response;
+};
+
+export const getWalletProviderClient = (context: {
+  walletProviderBaseUrl: string;
+  appFetch?: GlobalFetch["fetch"];
+}) => {
+  const { walletProviderBaseUrl, appFetch = fetch } = context;
+
+  return createWalletProviderApiClient(
+    (method, url, params) =>
+      appFetch(url, {
+        method,
+        body: params ? JSON.stringify(params.body) : undefined,
+      })
+        .then(validateResponse)
+        .then((res) => {
+          const contentType = res.headers.get("content-type");
+          if (contentType === "application/json") {
+            return res.json();
+          }
+          return res.text();
+        }),
+    walletProviderBaseUrl
+  );
+};

package/src/credential/issuance/01-start-flow.ts

@@ -1,4 +1,5 @@
 /**
+ * WARNING: This is the first function to be called in the issuing flow. The next function to be called is {@link evaluateIssuerTrust}.
  * The beginning of the issuing flow.
  * To be implemented accordind to the user touchpoint
  *

package/src/credential/issuance/02-evaluate-issuer-trust.ts

@@ -13,10 +13,11 @@ export type EvaluateIssuerTrust = (
 }>;
 
 /**
+ * WARNING: This function must be called after {@link startFlow}. The next function to be called is {@link startUserAuthorization}.
  * The Issuer trust evaluation phase.
  * Fetch the Issuer's configuration and verify trust.
  *
- * @param issuerUrl The base url of the Issuer
+ * @param issuerUrl The base url of the Issuer returned by {@link startFlow}
  * @param context.appFetch (optional) fetch api implementation. Default: built-in fetch
  * @returns The Issuer's configuration
  */