passkit-wallet 0.1.1 → 0.2.1

package/README.md

@@ -12,6 +12,14 @@ npm install passkit-wallet
 
 React components are optional — if you only use the backend helpers, React is not required.
 
+## Examples
+
+The [`examples/`](./examples) directory has full, runnable examples:
+
+- **Pass & Order Creation** — [Apple Pass](./examples/apple-pass-creation.ts) · [Apple Order](./examples/apple-order-creation.ts) · [Google Wallet](./examples/google-wallet.ts)
+- **Web Service Handlers** — [Express](./examples/express.ts) · [Hono](./examples/hono.ts) · [Elysia](./examples/elysia.ts)
+- **Store Adapters** — [Drizzle ORM](./examples/store-drizzle.ts) · [In-Memory](./examples/store-in-memory.ts)
+
 ## Quick Start
 
 ### Apple Wallet
@@ -139,6 +147,98 @@ function WalletButtons({ pkpassUrl, googleSaveUrl }) {
 }
 ```
 
+## Handlers (Web Service Protocol)
+
+The `handlers` module implements Apple's web service protocol so you don't have to. Provide a "store" object with async callbacks for your DB, and get back plain `{ status, headers, body }` handler functions you can wire into any framework.
+
+### Apple Pass Handlers
+
+```typescript
+import { createApplePassHandlers } from 'passkit-wallet/handlers'
+
+const handlers = createApplePassHandlers({
+  authenticationToken: 'your-auth-token',
+  store: {
+    getPass: async (serialNumber) => {
+      const pass = await db.findPass(serialNumber)
+      return pass ? { updatedAt: pass.updatedAt } : null
+    },
+    registerDevice: async (deviceLibId, pushToken, serialNumber) => {
+      const existed = await db.upsertRegistration(deviceLibId, pushToken, serialNumber)
+      return existed ? 'already_registered' : 'created'
+    },
+    unregisterDevice: async (deviceLibId, serialNumber) => {
+      await db.deleteRegistration(deviceLibId, serialNumber)
+    },
+    getRegistrations: async (passTypeId, deviceLibId, updatedSince) => {
+      return db.findRegistrations(passTypeId, deviceLibId, updatedSince)
+    },
+    getPassData: async (serialNumber) => {
+      return db.getPassFields(serialNumber)
+    },
+  },
+  buildPass: async (passData) => {
+    // Use your template to build the .pkpass buffer
+    const template = await apple.loadPassTemplate()
+    const pass = template.createPass()
+    // ... set fields from passData
+    return pass.getAsBuffer()
+  },
+  onLog: (logs) => console.log('Apple Wallet logs:', logs),
+})
+
+// Wire into any framework (Express example):
+app.post('/v1/devices/:did/registrations/:ptid/:sn', async (req, res) => {
+  const result = await handlers.registerDevice({
+    deviceLibraryIdentifier: req.params.did,
+    passTypeIdentifier: req.params.ptid,
+    serialNumber: req.params.sn,
+    pushToken: req.body.pushToken,
+    authorization: req.headers.authorization,
+  })
+  res.status(result.status).json(result.body)
+})
+```
+
+### Apple Order Handlers
+
+```typescript
+import { createAppleOrderHandlers } from 'passkit-wallet/handlers'
+
+const orderHandlers = createAppleOrderHandlers({
+  authenticationToken: 'your-order-auth-token',
+  store: {
+    getOrder: async (orderIdentifier) => {
+      const order = await db.findOrder(orderIdentifier)
+      return order ? { updatedAt: order.updatedAt } : null
+    },
+    registerDevice: async (deviceId, pushToken, orderIdentifier) => {
+      const existed = await db.upsertOrderRegistration(deviceId, pushToken, orderIdentifier)
+      return existed ? 'already_registered' : 'created'
+    },
+    unregisterDevice: async (deviceId, orderIdentifier) => {
+      await db.deleteOrderRegistration(deviceId, orderIdentifier)
+    },
+    getRegistrations: async (orderTypeId, deviceId, modifiedSince) => {
+      return db.findOrderRegistrations(orderTypeId, deviceId, modifiedSince)
+    },
+  },
+  buildOrder: async (orderIdentifier) => {
+    // Build and sign the .order buffer
+    const orderBody = apple.mountOrderInstance({ /* ... */ })
+    return apple.generateOrder(orderBody)
+  },
+})
+```
+
+### Handler Methods
+
+**Pass handlers:** `registerDevice`, `unregisterDevice`, `getSerialNumbers`, `getLatestPass`, `log`
+
+**Order handlers:** `registerDevice`, `unregisterDevice`, `getOrderIdentifiers`, `getLatestOrder`, `log`
+
+All handlers return `{ status: number, headers?: Record<string, string>, body?: unknown }`.
+
 ## Apple Certificate Setup
 
 1. Create a Pass Type ID and Order Type ID in the [Apple Developer Portal](https://developer.apple.com/account/resources/identifiers/list/passTypeId).
@@ -180,6 +280,11 @@ function WalletButtons({ pkpassUrl, googleSaveUrl }) {
 - `getClass` / `createClass` / `updateClass` / `updateObject` — CRUD operations on wallet classes and objects.
 - `sendObjectMessage(client, type, resourceId, message)` — attach a message to a wallet object.
 
+### Handlers
+
+- `createApplePassHandlers(config)` — returns handler functions for Apple Pass web service endpoints.
+- `createAppleOrderHandlers(config)` — returns handler functions for Apple Order web service endpoints.
+
 ### React
 
 - `<AddToAppleWallet url={string} />` — Apple Wallet badge link.

package/dist/handlers/apple-order.d.ts

@@ -0,0 +1,39 @@
+import type { HandlerResponse, AppleOrderHandlersConfig, AppleOrderDeviceRequest, AppleOrderIdentifiersRequest, AppleOrderLatestRequest, AppleLogRequest } from "./types.js";
+/**
+ * Create framework-agnostic handler functions for the Apple Order web service
+ * protocol. Each handler accepts a plain request object and returns a plain
+ * `{ status, headers, body }` response.
+ */
+export declare const createAppleOrderHandlers: (config: AppleOrderHandlersConfig) => {
+    /**
+     * `POST /v1/devices/:did/registrations/:otid/:oid`
+     *
+     * Register a device to receive push notifications for an order.
+     */
+    registerDevice(req: AppleOrderDeviceRequest): Promise<HandlerResponse>;
+    /**
+     * `DELETE /v1/devices/:did/registrations/:otid/:oid`
+     *
+     * Unregister a device from an order.
+     */
+    unregisterDevice(req: AppleOrderDeviceRequest): Promise<HandlerResponse>;
+    /**
+     * `GET /v1/devices/:did/registrations/:otid`
+     *
+     * Return order identifiers registered to a device.
+     */
+    getOrderIdentifiers(req: AppleOrderIdentifiersRequest): Promise<HandlerResponse>;
+    /**
+     * `GET /v1/orders/:otid/:oid`
+     *
+     * Return the latest version of an order as a signed `.order` buffer.
+     */
+    getLatestOrder(req: AppleOrderLatestRequest): Promise<HandlerResponse>;
+    /**
+     * `POST /v1/log`
+     *
+     * Accept log messages from Apple Wallet.
+     */
+    log(req: AppleLogRequest): Promise<HandlerResponse>;
+};
+//# sourceMappingURL=apple-order.d.ts.map

package/dist/handlers/apple-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-order.d.ts","sourceRoot":"","sources":["../../src/handlers/apple-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,eAAe,EAChB,MAAM,YAAY,CAAA;AAWnB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,wBAAwB;IAIrE;;;;OAIG;wBACuB,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB5E;;;;OAIG;0BACyB,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IAa9E;;;;OAIG;6BAC4B,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BtF;;;;OAIG;wBACuB,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+B5E;;;;OAIG;aACY,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAO5D,CAAA"}

package/dist/handlers/apple-order.js

@@ -0,0 +1,110 @@
+function validateAuth(authorization, expectedToken) {
+    if (!authorization)
+        return false;
+    const token = authorization.replace(/^AppleOrder\s+/i, "").trim();
+    return token === expectedToken;
+}
+/**
+ * Create framework-agnostic handler functions for the Apple Order web service
+ * protocol. Each handler accepts a plain request object and returns a plain
+ * `{ status, headers, body }` response.
+ */
+export const createAppleOrderHandlers = (config) => {
+    const { authenticationToken, store } = config;
+    return {
+        /**
+         * `POST /v1/devices/:did/registrations/:otid/:oid`
+         *
+         * Register a device to receive push notifications for an order.
+         */
+        async registerDevice(req) {
+            if (!validateAuth(req.authorization, authenticationToken)) {
+                return { status: 401 };
+            }
+            if (!req.pushToken) {
+                return { status: 400, body: { message: "pushToken is required" } };
+            }
+            const order = await store.getOrder(req.orderIdentifier);
+            if (!order) {
+                return { status: 404 };
+            }
+            const result = await store.registerDevice(req.deviceIdentifier, req.pushToken, req.orderIdentifier);
+            return { status: result === "created" ? 201 : 200 };
+        },
+        /**
+         * `DELETE /v1/devices/:did/registrations/:otid/:oid`
+         *
+         * Unregister a device from an order.
+         */
+        async unregisterDevice(req) {
+            if (!validateAuth(req.authorization, authenticationToken)) {
+                return { status: 401 };
+            }
+            await store.unregisterDevice(req.deviceIdentifier, req.orderIdentifier);
+            return { status: 200 };
+        },
+        /**
+         * `GET /v1/devices/:did/registrations/:otid`
+         *
+         * Return order identifiers registered to a device.
+         */
+        async getOrderIdentifiers(req) {
+            const registrations = await store.getRegistrations(req.orderTypeIdentifier, req.deviceIdentifier, req.ordersModifiedSince);
+            if (registrations.length === 0) {
+                return { status: 204 };
+            }
+            const sorted = registrations.sort((a, b) => a.updatedAt.getTime() - b.updatedAt.getTime());
+            const lastModified = sorted[sorted.length - 1].updatedAt.toISOString();
+            return {
+                status: 200,
+                body: {
+                    orderIdentifiers: sorted.map((r) => r.orderIdentifier),
+                    lastModified,
+                },
+            };
+        },
+        /**
+         * `GET /v1/orders/:otid/:oid`
+         *
+         * Return the latest version of an order as a signed `.order` buffer.
+         */
+        async getLatestOrder(req) {
+            if (!validateAuth(req.authorization, authenticationToken)) {
+                return { status: 401 };
+            }
+            const order = await store.getOrder(req.orderIdentifier);
+            if (!order) {
+                return { status: 404 };
+            }
+            // Return 304 if the order hasn't been modified since the client's copy
+            if (req.ifModifiedSince) {
+                const clientDate = new Date(req.ifModifiedSince);
+                if (order.updatedAt <= clientDate) {
+                    return { status: 304 };
+                }
+            }
+            const orderBuffer = await config.buildOrder(req.orderIdentifier);
+            return {
+                status: 200,
+                headers: {
+                    "Content-Type": "application/vnd.apple.order",
+                    "Content-Disposition": `attachment; filename="${req.orderIdentifier}.order"`,
+                    "Last-Modified": order.updatedAt.toUTCString(),
+                },
+                body: orderBuffer,
+            };
+        },
+        /**
+         * `POST /v1/log`
+         *
+         * Accept log messages from Apple Wallet.
+         */
+        async log(req) {
+            if (config.onLog) {
+                await config.onLog(req.logs);
+            }
+            return { status: 200 };
+        },
+    };
+};
+//# sourceMappingURL=apple-order.js.map

package/dist/handlers/apple-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-order.js","sourceRoot":"","sources":["../../src/handlers/apple-order.ts"],"names":[],"mappings":"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"}

package/dist/handlers/apple-pass.d.ts

@@ -0,0 +1,39 @@
+import type { HandlerResponse, ApplePassHandlersConfig, ApplePassDeviceRequest, ApplePassSerialNumbersRequest, ApplePassLatestRequest, AppleLogRequest } from "./types.js";
+/**
+ * Create framework-agnostic handler functions for the Apple Pass web service
+ * protocol. Each handler accepts a plain request object and returns a plain
+ * `{ status, headers, body }` response.
+ */
+export declare const createApplePassHandlers: (config: ApplePassHandlersConfig) => {
+    /**
+     * `POST /v1/devices/:did/registrations/:ptid/:sn`
+     *
+     * Register a device to receive push notifications for a pass.
+     */
+    registerDevice(req: ApplePassDeviceRequest): Promise<HandlerResponse>;
+    /**
+     * `DELETE /v1/devices/:did/registrations/:ptid/:sn`
+     *
+     * Unregister a device from a pass.
+     */
+    unregisterDevice(req: ApplePassDeviceRequest): Promise<HandlerResponse>;
+    /**
+     * `GET /v1/devices/:did/registrations/:ptid`
+     *
+     * Return serial numbers of passes registered to a device.
+     */
+    getSerialNumbers(req: ApplePassSerialNumbersRequest): Promise<HandlerResponse>;
+    /**
+     * `GET /v1/passes/:ptid/:sn`
+     *
+     * Return the latest version of a pass as a `.pkpass` buffer.
+     */
+    getLatestPass(req: ApplePassLatestRequest): Promise<HandlerResponse>;
+    /**
+     * `POST /v1/log`
+     *
+     * Accept log messages from Apple Wallet.
+     */
+    log(req: AppleLogRequest): Promise<HandlerResponse>;
+};
+//# sourceMappingURL=apple-pass.d.ts.map

package/dist/handlers/apple-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-pass.d.ts","sourceRoot":"","sources":["../../src/handlers/apple-pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,eAAe,EAChB,MAAM,YAAY,CAAA;AAWnB;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,uBAAuB;IAInE;;;;OAIG;wBACuB,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB3E;;;;OAIG;0BACyB,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAa7E;;;;OAIG;0BACyB,6BAA6B,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BpF;;;;OAIG;uBACsB,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoC1E;;;;OAIG;aACY,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAO5D,CAAA"}

package/dist/handlers/apple-pass.js

@@ -0,0 +1,114 @@
+function validateAuth(authorization, expectedToken) {
+    if (!authorization)
+        return false;
+    const token = authorization.replace(/^ApplePass\s+/i, "").trim();
+    return token === expectedToken;
+}
+/**
+ * Create framework-agnostic handler functions for the Apple Pass web service
+ * protocol. Each handler accepts a plain request object and returns a plain
+ * `{ status, headers, body }` response.
+ */
+export const createApplePassHandlers = (config) => {
+    const { authenticationToken, store } = config;
+    return {
+        /**
+         * `POST /v1/devices/:did/registrations/:ptid/:sn`
+         *
+         * Register a device to receive push notifications for a pass.
+         */
+        async registerDevice(req) {
+            if (!validateAuth(req.authorization, authenticationToken)) {
+                return { status: 401 };
+            }
+            if (!req.pushToken) {
+                return { status: 400, body: { message: "pushToken is required" } };
+            }
+            const pass = await store.getPass(req.serialNumber);
+            if (!pass) {
+                return { status: 404 };
+            }
+            const result = await store.registerDevice(req.deviceLibraryIdentifier, req.pushToken, req.serialNumber);
+            return { status: result === "created" ? 201 : 200 };
+        },
+        /**
+         * `DELETE /v1/devices/:did/registrations/:ptid/:sn`
+         *
+         * Unregister a device from a pass.
+         */
+        async unregisterDevice(req) {
+            if (!validateAuth(req.authorization, authenticationToken)) {
+                return { status: 401 };
+            }
+            await store.unregisterDevice(req.deviceLibraryIdentifier, req.serialNumber);
+            return { status: 200 };
+        },
+        /**
+         * `GET /v1/devices/:did/registrations/:ptid`
+         *
+         * Return serial numbers of passes registered to a device.
+         */
+        async getSerialNumbers(req) {
+            const registrations = await store.getRegistrations(req.passTypeIdentifier, req.deviceLibraryIdentifier, req.passesUpdatedSince);
+            if (registrations.length === 0) {
+                return { status: 204 };
+            }
+            const sorted = registrations.sort((a, b) => a.updatedAt.getTime() - b.updatedAt.getTime());
+            const lastUpdated = sorted[sorted.length - 1].updatedAt.toISOString();
+            return {
+                status: 200,
+                body: {
+                    serialNumbers: sorted.map((r) => r.serialNumber),
+                    lastUpdated,
+                },
+            };
+        },
+        /**
+         * `GET /v1/passes/:ptid/:sn`
+         *
+         * Return the latest version of a pass as a `.pkpass` buffer.
+         */
+        async getLatestPass(req) {
+            if (!validateAuth(req.authorization, authenticationToken)) {
+                return { status: 401 };
+            }
+            const pass = await store.getPass(req.serialNumber);
+            if (!pass) {
+                return { status: 404 };
+            }
+            // Return 304 if the pass hasn't been modified since the client's copy
+            if (req.ifModifiedSince) {
+                const clientDate = new Date(req.ifModifiedSince);
+                if (pass.updatedAt <= clientDate) {
+                    return { status: 304 };
+                }
+            }
+            const passData = await store.getPassData(req.serialNumber);
+            if (!passData) {
+                return { status: 404 };
+            }
+            const pkpassBuffer = await config.buildPass(passData);
+            return {
+                status: 200,
+                headers: {
+                    "Content-Type": "application/vnd.apple.pkpass",
+                    "Content-Disposition": `attachment; filename="${req.serialNumber}.pkpass"`,
+                    "Last-Modified": pass.updatedAt.toUTCString(),
+                },
+                body: pkpassBuffer,
+            };
+        },
+        /**
+         * `POST /v1/log`
+         *
+         * Accept log messages from Apple Wallet.
+         */
+        async log(req) {
+            if (config.onLog) {
+                await config.onLog(req.logs);
+            }
+            return { status: 200 };
+        },
+    };
+};
+//# sourceMappingURL=apple-pass.js.map

package/dist/handlers/apple-pass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-pass.js","sourceRoot":"","sources":["../../src/handlers/apple-pass.ts"],"names":[],"mappings":"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"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,4 @@
+export { createApplePassHandlers } from "./apple-pass.js";
+export { createAppleOrderHandlers } from "./apple-order.js";
+export type { HandlerResponse, ApplePassStore, ApplePassDeviceRequest, ApplePassSerialNumbersRequest, ApplePassLatestRequest, ApplePassHandlersConfig, AppleOrderStore, AppleOrderDeviceRequest, AppleOrderIdentifiersRequest, AppleOrderLatestRequest, AppleOrderHandlersConfig, AppleLogRequest, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAA"}

package/dist/handlers/index.js

@@ -0,0 +1,3 @@
+export { createApplePassHandlers } from "./apple-pass.js";
+export { createAppleOrderHandlers } from "./apple-order.js";
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/handlers/types.d.ts

@@ -0,0 +1,133 @@
+/** Plain HTTP response object — framework-agnostic. */
+export interface HandlerResponse {
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+/** Async callbacks for Apple Pass database operations. */
+export interface ApplePassStore {
+    /** Look up a pass by serial number. Return null if not found. */
+    getPass(serialNumber: string): Promise<{
+        updatedAt: Date;
+    } | null>;
+    /**
+     * Register a device to receive push updates for a pass.
+     * Return `"created"` for new registrations or `"already_registered"` if the
+     * device was already registered for this pass.
+     */
+    registerDevice(deviceLibraryIdentifier: string, pushToken: string, serialNumber: string): Promise<"created" | "already_registered">;
+    /** Unregister a device from a pass. */
+    unregisterDevice(deviceLibraryIdentifier: string, serialNumber: string): Promise<void>;
+    /**
+     * Return all passes registered to a device, optionally filtered by
+     * modification date.
+     */
+    getRegistrations(passTypeIdentifier: string, deviceLibraryIdentifier: string, updatedSince?: string): Promise<{
+        serialNumber: string;
+        updatedAt: Date;
+    }[]>;
+    /**
+     * Return the data needed to build a `.pkpass` file for the given serial
+     * number. The shape of the returned object is up to you — the handler will
+     * pass it through to your `buildPass` callback.
+     */
+    getPassData(serialNumber: string): Promise<Record<string, unknown> | null>;
+}
+/** Request data for pass device registration / unregistration. */
+export interface ApplePassDeviceRequest {
+    deviceLibraryIdentifier: string;
+    passTypeIdentifier: string;
+    serialNumber: string;
+    authorization?: string;
+    pushToken?: string;
+}
+/** Request data for fetching serial numbers. */
+export interface ApplePassSerialNumbersRequest {
+    deviceLibraryIdentifier: string;
+    passTypeIdentifier: string;
+    passesUpdatedSince?: string;
+}
+/** Request data for fetching the latest pass. */
+export interface ApplePassLatestRequest {
+    passTypeIdentifier: string;
+    serialNumber: string;
+    authorization?: string;
+    ifModifiedSince?: string;
+}
+/** Request data for the log endpoint. */
+export interface AppleLogRequest {
+    logs: string[];
+}
+/** Options for `createApplePassHandlers`. */
+export interface ApplePassHandlersConfig {
+    /** The authentication token configured in pass.json. */
+    authenticationToken: string;
+    /** Store adapter with async callbacks for DB operations. */
+    store: ApplePassStore;
+    /**
+     * Build a signed `.pkpass` buffer from the pass data returned by
+     * `store.getPassData`. This is where you call your template logic.
+     */
+    buildPass(passData: Record<string, unknown>): Promise<Buffer>;
+    /** Optional log callback. */
+    onLog?(logs: string[]): void | Promise<void>;
+}
+/** Async callbacks for Apple Order database operations. */
+export interface AppleOrderStore {
+    /** Look up an order by identifier. Return null if not found. */
+    getOrder(orderIdentifier: string): Promise<{
+        updatedAt: Date;
+    } | null>;
+    /**
+     * Register a device to receive push updates for an order.
+     * Return `"created"` for new registrations or `"already_registered"` if the
+     * device was already registered for this order.
+     */
+    registerDevice(deviceIdentifier: string, pushToken: string, orderIdentifier: string): Promise<"created" | "already_registered">;
+    /** Unregister a device from an order. */
+    unregisterDevice(deviceIdentifier: string, orderIdentifier: string): Promise<void>;
+    /**
+     * Return all orders registered to a device, optionally filtered by
+     * modification date.
+     */
+    getRegistrations(orderTypeIdentifier: string, deviceIdentifier: string, modifiedSince?: string): Promise<{
+        orderIdentifier: string;
+        updatedAt: Date;
+    }[]>;
+}
+/** Request data for order device registration / unregistration. */
+export interface AppleOrderDeviceRequest {
+    deviceIdentifier: string;
+    orderTypeIdentifier: string;
+    orderIdentifier: string;
+    authorization?: string;
+    pushToken?: string;
+}
+/** Request data for fetching order identifiers. */
+export interface AppleOrderIdentifiersRequest {
+    deviceIdentifier: string;
+    orderTypeIdentifier: string;
+    ordersModifiedSince?: string;
+}
+/** Request data for fetching the latest order. */
+export interface AppleOrderLatestRequest {
+    orderTypeIdentifier: string;
+    orderIdentifier: string;
+    authorization?: string;
+    ifModifiedSince?: string;
+}
+/** Options for `createAppleOrderHandlers`. */
+export interface AppleOrderHandlersConfig {
+    /** The authentication token configured for orders. */
+    authenticationToken: string;
+    /** Store adapter with async callbacks for DB operations. */
+    store: AppleOrderStore;
+    /**
+     * Build a signed `.order` buffer for the given order identifier.
+     * This is where you call your order generation logic.
+     */
+    buildOrder(orderIdentifier: string): Promise<Buffer>;
+    /** Optional log callback. */
+    onLog?(logs: string[]): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/handlers/types.ts"],"names":[],"mappings":"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"}

package/dist/handlers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/handlers/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export { translateOrderStatus } from "./common/types.js";
 export type { OrderStatus, CouponPassData, OrderData } from "./common/types.js";
 export type { OrderInstance, Merchant, Payment, MoneyAmount, SummaryItem, LineItem, Fulfillment, AppleCouponPassOptions, AppleOrderOptions, ApplePushOptions, } from "./apple/types.js";
 export type { GoogleReviewStatus, GoogleObjectState, GoogleClassType, GoogleObjectType, GoogleSaveType, GoogleOfferClassOptions, GoogleOfferObjectOptions, GoogleOrderClassOptions, GoogleOrderObjectOptions, } from "./google/types.js";
+export { createApplePassHandlers, createAppleOrderHandlers } from "./handlers/index.js";
+export type { HandlerResponse, ApplePassStore, ApplePassDeviceRequest, ApplePassSerialNumbersRequest, ApplePassLatestRequest, ApplePassHandlersConfig, AppleOrderStore, AppleOrderDeviceRequest, AppleOrderIdentifiersRequest, AppleOrderLatestRequest, AppleOrderHandlersConfig, AppleLogRequest, } from "./handlers/index.js";
 import type { ApplePassConfig, AppleOrderConfig, GoogleClientConfig } from "./common/config.js";
 /**
  * Create a configured Apple Wallet client with convenience methods.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAG/E,YAAY,EACV,aAAa,EACb,QAAQ,EACR,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAK1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAM/F;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ;IAC9C,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB;IAKG,uDAAuD;;IAKvD,sDAAsD;;IAKtD,sEAAsE;mCACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,MAAM,EAAE;IAIzE,8DAA8D;kCAChC,OAAO,kBAAkB,EAAE,iBAAiB;IAI1E,qCAAqC;uCACF,MAAM,GAAG,MAAM,EAAE,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;CAYtE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,kBAAkB;;;;;;;;;;;;IAO/D,8CAA8C;yBAEtC,OAAO,mBAAmB,EAAE,cAAc,gBAClC,MAAM,eACP,MAAM;CAGxB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAG/E,YAAY,EACV,aAAa,EACb,QAAQ,EACR,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AACvF,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAK5B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAM/F;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ;IAC9C,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB;IAKG,uDAAuD;;IAKvD,sDAAsD;;IAKtD,sEAAsE;mCACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,MAAM,EAAE;IAIzE,8DAA8D;kCAChC,OAAO,kBAAkB,EAAE,iBAAiB;IAI1E,qCAAqC;uCACF,MAAM,GAAG,MAAM,EAAE,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;CAYtE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,kBAAkB;;;;;;;;;;;;IAO/D,8CAA8C;yBAEtC,OAAO,mBAAmB,EAAE,cAAc,gBAClC,MAAM,eACP,MAAM;CAGxB,CAAA"}

package/dist/index.js

@@ -6,6 +6,8 @@ export { loadClient, getClass, createClass, updateClass, updateObject, getSigned
 export { applePassConfigSchema, appleOrderConfigSchema, appleClientConfigSchema, googleClientConfigSchema, } from "./common/config.js";
 // ── Common Types ────────────────────────────────────────────────────────
 export { translateOrderStatus } from "./common/types.js";
+// ── Handlers ─────────────────────────────────────────────────────────────
+export { createApplePassHandlers, createAppleOrderHandlers } from "./handlers/index.js";
 // ── Factory helpers ─────────────────────────────────────────────────────
 import { applePassConfigSchema, appleOrderConfigSchema, googleClientConfigSchema } from "./common/config.js";
 import { loadPassTemplate as _loadPassTemplate } from "./apple/pass.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "passkit-wallet",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Apple Wallet + Google Wallet pass generation made easy",
   "license": "MIT",
   "repository": {
@@ -11,6 +11,21 @@
   "bugs": {
     "url": "https://github.com/dmvvilela/passkit-wallet/issues"
   },
+  "keywords": [
+    "apple-wallet",
+    "google-wallet",
+    "passkit",
+    "pkpass",
+    "wallet-pass",
+    "coupon",
+    "order",
+    "passbook",
+    "apple-pay",
+    "google-pay",
+    "wallet",
+    "pass",
+    "typescript"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,6 +42,10 @@
       "types": "./dist/google/index.d.ts",
       "import": "./dist/google/index.js"
     },
+    "./handlers": {
+      "types": "./dist/handlers/index.d.ts",
+      "import": "./dist/handlers/index.js"
+    },
     "./react": {
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"