passlet 0.2.0 → 0.2.1

package/README.md

@@ -0,0 +1,74 @@
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/oscartrevio/passlet/main/.github/assets/header-dark.svg">
+  <img src="https://raw.githubusercontent.com/oscartrevio/passlet/main/.github/assets/header.svg" alt="Passlet" width="100%">
+</picture>
+
+**[Passlet](https://github.com/oscartrevio/passlet)** is a library for generating Apple Wallet and Google Wallet passes from a single TypeScript API.
+
+[![npm version](https://img.shields.io/npm/v/passlet)](https://www.npmjs.com/package/passlet)
+[![downloads](https://img.shields.io/npm/dm/passlet)](https://www.npmjs.com/package/passlet)
+[![license](https://img.shields.io/npm/l/passlet)](https://www.npmjs.com/package/passlet)
+[![GitHub stars](https://img.shields.io/github/stars/oscartrevio/passlet)](https://github.com/oscartrevio/passlet/stargazers)
+
+## Install
+
+```bash
+npm install passlet
+```
+
+## Quickstart
+
+```ts
+import { Wallet, field } from "passlet";
+
+const wallet = new Wallet({
+  apple: {
+    passTypeIdentifier: process.env.APPLE_PASS_TYPE_ID!,
+    teamId: process.env.APPLE_TEAM_ID!,
+    signerCert: process.env.APPLE_SIGNER_CERT!,
+    signerKey: process.env.APPLE_SIGNER_KEY!,
+    wwdr: process.env.APPLE_WWDR!,
+  },
+  google: {
+    issuerId: process.env.GOOGLE_ISSUER_ID!,
+    clientEmail: process.env.GOOGLE_CLIENT_EMAIL!,
+    privateKey: process.env.GOOGLE_PRIVATE_KEY!,
+  },
+});
+
+const pass = wallet.loyalty({
+  id: "my-rewards",
+  name: "Rewards Card",
+  fields: [
+    field.primary("points", "Points", "1250"),
+    field.secondary("tier", "Tier", "Gold"),
+  ],
+});
+
+const { apple, google } = await pass.create({ serialNumber: "user-123" });
+// apple → Uint8Array (.pkpass file, serve with Content-Type: application/vnd.apple.pkpass)
+// google → JWT string (save link: https://pay.google.com/gp/v/save/<jwt>)
+```
+
+Omit `apple` or `google` from the credentials to skip that provider.
+
+## Pass types
+
+```ts
+wallet.loyalty(config);
+wallet.event(config);
+wallet.flight(config);
+wallet.coupon(config);
+wallet.giftCard(config);
+wallet.generic(config);
+```
+
+## Credentials
+
+**Apple** — requires an Apple Developer account with a Pass Type ID. [Create one in the Developer portal](https://developer.apple.com/account/resources/identifiers/list/passTypeId), then download your signing certificate and convert it to PEM.
+
+**Google** — requires a Google Wallet issuer account. [Set one up in the Pay & Wallet Console](https://pay.google.com/business/console), create a service account, and download the JSON key.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -439,7 +439,7 @@ async function getAccessToken(credentials, privateKey) {
     const text = await response.text();
     throw new WalletError(
       "GOOGLE_API_ERROR",
-      `Failed to obtain access token (${response.status}): ${text}`
+      `Failed to obtain access token (${response.status}): ${extractGoogleDetail(text)}`
     );
   }
   const data = await response.json();
@@ -460,12 +460,23 @@ async function walletRequest(method, path, credentials, privateKey, body) {
     body: body === void 0 ? void 0 : JSON.stringify(body)
   });
 }
+function extractGoogleDetail(text) {
+  try {
+    const body = JSON.parse(text);
+    if (body.error?.message) {
+      return body.error.message;
+    }
+  } catch {
+  }
+  return text;
+}
 async function assertOk(response) {
   if (!response.ok) {
     const text = await response.text();
+    const detail = extractGoogleDetail(text);
     throw new WalletError(
       "GOOGLE_API_ERROR",
-      `Google Wallet API error (${response.status}): ${text}`
+      `Google Wallet API error (${response.status}): ${detail}`
     );
   }
 }
@@ -484,7 +495,7 @@ async function ensureClass(classType, classId, classBody, credentials, privateKe
     const text = await existing.text();
     throw new WalletError(
       "GOOGLE_API_ERROR",
-      `Google Wallet API error (${existing.status}): ${text}`
+      `Google Wallet API error (${existing.status}): ${extractGoogleDetail(text)}`
     );
   }
   await assertOk(