How to issue hotel key cards with an API

1// npm install seam
2// Set SEAM_API_KEY and SEAM_ACS_ENTRANCE_ID for a supported entrance.
3// Set SEAM_ACS_SYSTEM_ID and SEAM_ACS_ENCODER_ID for your front desk.
4import { Seam } from "seam"
5
6const seam = new Seam()
7const entranceId = process.env.SEAM_ACS_ENTRANCE_ID
8if (!entranceId) throw new Error("Set SEAM_ACS_ENTRANCE_ID")
9const startsAt = new Date()
10const endsAt = new Date(startsAt.getTime() + 2 * 24 * 60 * 60 * 1000)
11
12const accessGrant = await seam.accessGrants.create({
13  user_identity: { full_name: "Jane Doe", email_address: "jane@example.com" },
14  acs_entrance_ids: [entranceId],
15  requested_access_methods: [{ mode: "card" }],
16  starts_at: startsAt.toISOString(),
17  ends_at: endsAt.toISOString(),
18})
19
20// Poll at two-second intervals, at most 30 times.
21let cardMethod
22for (let attempt = 0; attempt < 30; attempt++) {
23  const methods = await seam.accessMethods.list({
24    access_grant_id: accessGrant.access_grant_id,
25  })
26  cardMethod = methods.find((method) => method.mode === "card")
27  if (cardMethod?.is_ready_for_encoding) break
28  await new Promise((resolve) => setTimeout(resolve, 2000))
29}
30if (!cardMethod?.is_ready_for_encoding) {
31  throw new Error("Access method is not ready for encoding yet. Check its errors and retry later.")
32}
33
34// Choose the encoder where the blank card is placed.
35const encoderId = process.env.SEAM_ACS_ENCODER_ID
36if (!encoderId) throw new Error("Set SEAM_ACS_ENCODER_ID for this desk")
37const encoders = await seam.acs.encoders.list({
38  acs_system_id: process.env.SEAM_ACS_SYSTEM_ID,
39})
40const frontDesk = encoders.find((encoder) => encoder.acs_encoder_id === encoderId)
41if (!frontDesk) throw new Error("Configured encoder was not found on this system")
42
43// Place the blank card on the selected encoder before running this call.
44await seam.accessMethods.encode({
45  access_method_id: cardMethod.access_method_id,
46  acs_encoder_id: frontDesk.acs_encoder_id,
47})
48
49for (let attempt = 0; attempt < 30; attempt++) {
50  cardMethod = await seam.accessMethods.get({ access_method_id: cardMethod.access_method_id })
51  if (cardMethod.is_issued) break
52  await new Promise((resolve) => setTimeout(resolve, 2000))
53}
54if (!cardMethod.is_issued) throw new Error("Card is not issued yet; check errors before handing it over")