@ophelio/sdk 0.3.2 → 0.5.0

package/dist/index.d.cts

@@ -659,6 +659,38 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/v1/target-codes": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get: operations["TargetCodesController_list"];
+    put?: never;
+    post: operations["TargetCodesController_create"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/target-codes/{id}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get: operations["TargetCodesController_get"];
+    put?: never;
+    post?: never;
+    delete: operations["TargetCodesController_delete"];
+    options?: never;
+    head?: never;
+    patch: operations["TargetCodesController_update"];
+    trace?: never;
+  };
   "/api/v1/member-roles": {
     parameters: {
       query?: never;
@@ -1075,38 +1107,6 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/api/v1/target-codes": {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    get: operations["TargetCodesController_list"];
-    put?: never;
-    post: operations["TargetCodesController_create"];
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  "/api/v1/target-codes/{id}": {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    get: operations["TargetCodesController_get"];
-    put?: never;
-    post?: never;
-    delete: operations["TargetCodesController_delete"];
-    options?: never;
-    head?: never;
-    patch: operations["TargetCodesController_update"];
-    trace?: never;
-  };
   "/api/inngest": {
     parameters: {
       query?: never;
@@ -1173,6 +1173,7 @@ interface components {
       timezone?: string | null;
       default_currency?: string | null; /** @enum {string|null} */
       display_locale?: "de-DE" | "en-GB" | "en-US" | "es-ES" | "fr-FR" | "it-IT" | "nl-NL" | null;
+      require_target_context?: boolean | null;
     };
     CreateOrganizationDto: {
       slug: string;
@@ -1509,6 +1510,7 @@ interface components {
       entitlement_code: string;
       members: string[];
       used_time?: string;
+      target?: string;
       context: {
         [key: string]: unknown;
       };
@@ -1519,6 +1521,7 @@ interface components {
       member_id: string;
       plan_entitlement_id: string; /** Format: date-time */
       used_time: string;
+      target: string | null;
       context: {
         [key: string]: unknown;
       } | null;
@@ -1539,6 +1542,49 @@ interface components {
       display_name: string;
       description: string;
     };
+    EntitlementValidityWindow: {
+      /**
+       * @description First calendar day the rule covers, as `YYYY-MM-DD` in the project timezone. Null means the window is open-ended at the start.
+       * @example 2026-01-01
+       */
+      date_from: string | null;
+      /**
+       * @description Last calendar day the rule covers, inclusive, as `YYYY-MM-DD` in the project timezone. Null means the window is open-ended at the end.
+       * @example 2026-03-31
+       */
+      date_until: string | null;
+      /**
+       * @description Weekdays the rule covers, in ISO-8601 numbering: 1 = Monday … 7 = Sunday. An empty array means every day.
+       * @example [
+       *       1,
+       *       2,
+       *       3,
+       *       4
+       *     ]
+       */
+      days_of_week: number[];
+    };
+    MemberEntitlement: {
+      /** @description When the entitlement is valid, taken from the availability rules that matched. Only matched rules are listed. Omitted entirely when nothing restricts the entitlement by date. */valid_on?: components["schemas"]["EntitlementValidityWindow"][];
+      /**
+       * @description Where the entitlement is valid, taken from the availability rows that matched. Only matched rows are listed. Omitted entirely when nothing restricts the entitlement by target.
+       * @example [
+       *       "coffee_shop",
+       *       "venue_a"
+       *     ]
+       */
+      valid_at?: string[];
+      code: string; /** @enum {string} */
+      type: "discount" | "early_access" | "free_entry" | "guest_pass";
+      display_name: string;
+      plan_entitlement_id: string;
+      discount_percentage: number | null;
+      quota_limit: number | null; /** @enum {string} */
+      quota_period: "day" | "month" | "week" | "year";
+      requires_member_present: boolean;
+      early_access_days: number | null;
+      active_during_grace: boolean;
+    };
     SyncMember: {
       member_id: string;
       card_id: string | null;
@@ -1547,6 +1593,7 @@ interface components {
       pricing_group_code: string | null; /** @enum {string} */
       membership_status: "active" | "grace_period" | "past_due"; /** Format: date-time */
       end_time: string | null;
+      entitlements: components["schemas"]["MemberEntitlement"][];
     };
     MemberSyncResponse: {
       members: components["schemas"]["SyncMember"][]; /** @example 2026-06-11T12:00:00.000Z */
@@ -1577,18 +1624,6 @@ interface components {
       role: components["schemas"]["MemberRoleSummary"] | null;
       membership: components["schemas"]["MemberMembershipSummary"] | null;
     };
-    MemberEntitlement: {
-      code: string; /** @enum {string} */
-      type: "discount" | "early_access" | "free_entry" | "guest_pass";
-      display_name: string;
-      plan_entitlement_id: string;
-      discount_percentage: number | null;
-      quota_limit: number | null; /** @enum {string} */
-      quota_period: "day" | "month" | "week" | "year";
-      requires_member_present: boolean;
-      early_access_days: number | null;
-      active_during_grace: boolean;
-    };
     ListMemberEntitlementsResponse: {
       entitlements: components["schemas"]["MemberEntitlement"][];
     };
@@ -1608,6 +1643,7 @@ interface components {
       role_code: string;
     };
     AdmitResult: {
+      /** @description Whether the entitlements were filtered by a target context the request supplied. False means no target context was given and they are unfiltered by target. */target_context_applied: boolean;
       actions: ({
         /** @enum {string} */type: "renew_at_desk"; /** Format: uuid */
         membership_id: string;
@@ -1616,7 +1652,7 @@ interface components {
         reason: string;
       })[];
       admitted: boolean; /** @enum {string|null} */
-      deny_reason: "card_not_found" | "member_removed" | "membership_cancelled" | "membership_expired" | "membership_incomplete" | "payment_overdue" | null;
+      deny_reason: "card_not_found" | "free_entry_not_granted" | "free_entry_unavailable" | "member_removed" | "membership_cancelled" | "membership_expired" | "membership_incomplete" | "payment_overdue" | null;
       member: components["schemas"]["AdmitMember"] | null;
       membership_id: string | null; /** @enum {string|null} */
       membership_status: "active" | "cancelled" | "expired" | "grace_period" | "incomplete" | "past_due" | null;
@@ -1624,6 +1660,45 @@ interface components {
       pricing_group: string | null;
       entitlements: components["schemas"]["MemberEntitlement"][];
     };
+    TargetCode: {
+      /**
+       * @description Machine identifier a gate sends. Lowercase letters, numbers and single underscores; immutable once created, and matched exactly, never normalised.
+       * @example venue_a
+       */
+      code: string; /** @example Venue A */
+      display_name: string;
+      /**
+       * @description How many plan entitlements restrict availability to this target. Populated only when `view=full`.
+       * @example 3
+       */
+      plan_entitlement_count?: number;
+      id: string;
+      description: string | null; /** Format: date-time */
+      create_time: string; /** Format: date-time */
+      update_time: string;
+    };
+    ListTargetCodesResponse: {
+      /**
+       * @description Opaque token for the next page; empty string on the last page.
+       * @example
+       */
+      next_page_token: string;
+      /**
+       * @description Total number of results across all pages.
+       * @example 42
+       */
+      total_size: number;
+      target_codes: components["schemas"]["TargetCode"][];
+    };
+    CreateTargetCodeDto: {
+      /** @example venue_a */code: string;
+      display_name: string;
+      description?: string | null;
+    };
+    UpdateTargetCodeDto: {
+      display_name?: string;
+      description?: string | null;
+    };
     MemberRole: {
       id: string;
       code: string;
@@ -2087,45 +2162,6 @@ interface components {
       total_size: number;
       memberships: components["schemas"]["Membership"][];
     };
-    TargetCode: {
-      /**
-       * @description Machine identifier a gate sends. Lowercase letters, numbers and single underscores; immutable once created, and matched exactly, never normalised.
-       * @example venue_a
-       */
-      code: string; /** @example Venue A */
-      display_name: string;
-      /**
-       * @description How many plan entitlements restrict availability to this target. Populated only when `view=full`.
-       * @example 3
-       */
-      plan_entitlement_count?: number;
-      id: string;
-      description: string | null; /** Format: date-time */
-      create_time: string; /** Format: date-time */
-      update_time: string;
-    };
-    ListTargetCodesResponse: {
-      /**
-       * @description Opaque token for the next page; empty string on the last page.
-       * @example
-       */
-      next_page_token: string;
-      /**
-       * @description Total number of results across all pages.
-       * @example 42
-       */
-      total_size: number;
-      target_codes: components["schemas"]["TargetCode"][];
-    };
-    CreateTargetCodeDto: {
-      /** @example venue_a */code: string;
-      display_name: string;
-      description?: string | null;
-    };
-    UpdateTargetCodeDto: {
-      display_name?: string;
-      description?: string | null;
-    };
   };
   responses: never;
   parameters: never;
@@ -3293,6 +3329,14 @@ interface operations {
           "application/json": components["schemas"]["ErrorResponse"];
         };
       };
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
     };
   };
   PlanEntitlementAvailabilitiesController_get: {
@@ -3386,6 +3430,14 @@ interface operations {
           "application/json": components["schemas"]["ErrorResponse"];
         };
       };
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
     };
   };
   PlanPricingGroupMappingsController_delete: {
@@ -3635,6 +3687,7 @@ interface operations {
   MembersController_sync: {
     parameters: {
       query?: {
+        /** @description Registered target codes of the place this roster is for, sent comma-separated (`?targets=venue_a,coffee_shop`). Each member's entitlements are then narrowed to those usable there. Codes are matched exactly; an unregistered code is refused. Omit the parameter to receive the whole roster, with entitlements narrowed by date alone. Sending it with nothing in it (`?targets=`) is an error here, unlike on `GET /admit` and `GET /members/:id/entitlements`, where it means the caller named no place: this roster is used during an outage without being checked again, so an empty value would leave a gate short of entitlements it would not discover until the outage it kept the roster for. */targets?: string[];
         since?: string;
       };
       header?: never;
@@ -3651,6 +3704,14 @@ interface operations {
           "application/json": components["schemas"]["MemberSyncResponse"];
         };
       };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
     };
   };
   MembersController_get: {
@@ -3739,6 +3800,7 @@ interface operations {
   MembersController_listEntitlements: {
     parameters: {
       query?: {
+        /** @description Registered target codes the request is being made at, sent comma-separated (`?targets=venue_a,coffee_shop`). Codes are matched exactly; an unregistered code is refused. Omit for no target context; send it empty to name no targets. */targets?: string[];
         type?: "discount" | "early_access" | "free_entry" | "guest_pass";
       };
       header?: never;
@@ -3755,6 +3817,14 @@ interface operations {
           "application/json": components["schemas"]["ListMemberEntitlementsResponse"];
         };
       };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
       404: {
         headers: {
           [name: string]: unknown;
@@ -3834,6 +3904,7 @@ interface operations {
   AdmitController_check: {
     parameters: {
       query: {
+        /** @description Registered target codes the request is being made at, sent comma-separated (`?targets=venue_a,coffee_shop`). Codes are matched exactly; an unregistered code is refused. Omit for no target context; send it empty to name no targets. */targets?: string[];
         card: string;
       };
       header?: never;
@@ -3850,6 +3921,14 @@ interface operations {
           "application/json": components["schemas"]["AdmitResult"];
         };
       };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
       404: {
         headers: {
           [name: string]: unknown;
@@ -3860,9 +3939,13 @@ interface operations {
       };
     };
   };
-  MemberRolesController_list: {
+  TargetCodesController_list: {
     parameters: {
-      query?: never;
+      query?: {
+        page_size?: number;
+        page_token?: string; /** @description Response detail level; `full` populates `plan_entitlement_count`. */
+        view?: "basic" | "full";
+      };
       header?: never;
       path?: never;
       cookie?: never;
@@ -3874,12 +3957,12 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ListMemberRolesResponse"];
+          "application/json": components["schemas"]["ListTargetCodesResponse"];
         };
       };
     };
   };
-  MemberRolesController_create: {
+  TargetCodesController_create: {
     parameters: {
       query?: never;
       header?: never;
@@ -3888,7 +3971,7 @@ interface operations {
     };
     requestBody: {
       content: {
-        "application/json": components["schemas"]["CreateMemberRoleDto"];
+        "application/json": components["schemas"]["CreateTargetCodeDto"];
       };
     };
     responses: {
@@ -3897,29 +3980,190 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["MemberRole"];
+          "application/json": components["schemas"]["TargetCode"];
         };
       };
-    };
-  };
-  MemberRolesController_get: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      200: {
+      400: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["MemberRole"];
+          "application/json": components["schemas"]["ErrorResponse"];
         };
       };
-      404: {
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  TargetCodesController_get: {
+    parameters: {
+      query?: {
+        /** @description Response detail level; `full` populates `plan_entitlement_count`. */view?: "basic" | "full";
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TargetCode"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  TargetCodesController_delete: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": Record<string, never>;
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  TargetCodesController_update: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["UpdateTargetCodeDto"];
+      };
+    };
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TargetCode"];
+        };
+      };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  MemberRolesController_list: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ListMemberRolesResponse"];
+        };
+      };
+    };
+  };
+  MemberRolesController_create: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["CreateMemberRoleDto"];
+      };
+    };
+    responses: {
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["MemberRole"];
+        };
+      };
+    };
+  };
+  MemberRolesController_get: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["MemberRole"];
+        };
+      };
+      404: {
         headers: {
           [name: string]: unknown;
         };
@@ -4549,6 +4793,14 @@ interface operations {
           "application/json": components["schemas"]["ErrorResponse"];
         };
       };
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
     };
   };
   CalendarRulesController_update: {
@@ -5258,171 +5510,6 @@ interface operations {
       };
     };
   };
-  TargetCodesController_list: {
-    parameters: {
-      query?: {
-        page_size?: number;
-        page_token?: string; /** @description Response detail level; `full` populates `plan_entitlement_count`. */
-        view?: "basic" | "full";
-      };
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ListTargetCodesResponse"];
-        };
-      };
-    };
-  };
-  TargetCodesController_create: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        "application/json": components["schemas"]["CreateTargetCodeDto"];
-      };
-    };
-    responses: {
-      201: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["TargetCode"];
-        };
-      };
-      400: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-      409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-    };
-  };
-  TargetCodesController_get: {
-    parameters: {
-      query?: {
-        /** @description Response detail level; `full` populates `plan_entitlement_count`. */view?: "basic" | "full";
-      };
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["TargetCode"];
-        };
-      };
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-    };
-  };
-  TargetCodesController_delete: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": Record<string, never>;
-        };
-      };
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-      409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-    };
-  };
-  TargetCodesController_update: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        "application/json": components["schemas"]["UpdateTargetCodeDto"];
-      };
-    };
-    responses: {
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["TargetCode"];
-        };
-      };
-      400: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["ErrorResponse"];
-        };
-      };
-    };
-  };
   InngestController_handle_get: {
     parameters: {
       query?: never;
@@ -5592,6 +5679,8 @@ type PlanChangeResult = Schemas['PlanChangeResponseDto'];
 type MemberSyncResponse = Schemas['MemberSyncResponse'];
 type RedeemEntitlementResponse = Schemas['RedeemEntitlementResponseDto'];
 type CustomerView = 'basic' | 'full';
+type CalendarView = 'basic' | 'full';
+type TargetCodeView = 'basic' | 'full';
 interface PageParams {
   /** Rows per page. Server default 50; capped at 250. */
   page_size?: number;
@@ -5655,9 +5744,25 @@ declare class APIResource {
 //#endregion
 //#region src/resources/admit.d.ts
 declare class AdmitResource extends APIResource {
-  /** Gate admission check: `GET /admit?card=<cardId>`. */
+  /**
+   * Gate admission check: `GET /admit?card=<cardId>`.
+   *
+   * `targets` names the venue, zone, shop or gate the request is being made
+   * at, and is the context the entitlements are judged in — a benefit
+   * restricted to somewhere else drops out of `entitlements`. Three states,
+   * and they are answered differently: omit it and every target restriction
+   * is treated as satisfied; pass `[]` and only benefits valid anywhere
+   * survive; pass codes and a benefit needs one of them. Read
+   * `target_context_applied` on the result to tell the first apart from the
+   * other two.
+   *
+   * Codes are matched exactly, so send them back verbatim from
+   * `targetCodes.list()` — an unregistered or miscased code is refused with
+   * a 400 rather than quietly ignored.
+   */
   check(params: {
     card: string;
+    targets?: string[];
   }, options?: RequestOptions): Promise<AdmitResult>;
 }
 //#endregion
@@ -5679,7 +5784,7 @@ declare class BillingOptionsResource extends APIResource {
 //#endregion
 //#region src/resources/calendar-rules.d.ts
 /**
- * A calendar rule is one row of a calendar's date vocabulary. Conditions AND
+ * A calendar rule is one row of a calendar's set of dates. Conditions AND
  * within a rule and rules OR across a calendar, so "weekends in August" is a
  * single rule rather than two.
  *
@@ -5695,14 +5800,25 @@ declare class CalendarRulesResource extends APIResource {
 //#endregion
 //#region src/resources/calendars.d.ts
 /**
- * Calendars are named, reusable date vocabularies ("Peak 2026", "Weekends").
+ * Calendars are named, reusable sets of dates ("Peak 2026", "Weekends").
  * The dates themselves live in the rules attached to them.
  *
  * A calendar containing no rules is valid for **all** dates, not none.
  */
 declare class CalendarsResource extends APIResource {
-  list(params?: PageParams, options?: RequestOptions): Promise<Page<Calendar>>;
-  get(id: string, options?: RequestOptions): Promise<Calendar>;
+  /**
+   * Pass `view: 'full'` to include `plan_entitlement_count` on every
+   * calendar.
+   */
+  list(params?: PageParams & {
+    view?: CalendarView;
+  }, options?: RequestOptions): Promise<Page<Calendar>>;
+  /**
+   * Pass `view: 'full'` to include `plan_entitlement_count`.
+   */
+  get(id: string, params?: {
+    view?: CalendarView;
+  }, options?: RequestOptions): Promise<Calendar>;
   create(params: CreateCalendarParams, options?: RequestOptions): Promise<Calendar>;
   update(id: string, params: UpdateCalendarParams, options?: RequestOptions): Promise<Calendar>;
   delete(id: string, options?: RequestOptions): Promise<void>;
@@ -5741,6 +5857,14 @@ declare class EntitlementsResource extends APIResource {
   /**
    * Fire-and-forget batch usage reporting (one row per member). Idempotent
    * per (key, member). Returns the recorded usage rows.
+   *
+   * `target` is the single registered code for the venue, zone, shop or gate
+   * the usage happened at — one event, one place, which is why it is
+   * singular here where the reads take `targets`. It is both the context the
+   * entitlement is judged in and a column on the row that comes back, so it
+   * is queryable in a way the free-form `context` is not. It is part of the
+   * idempotency fingerprint: a replay of the same key at a different target
+   * is refused rather than silently returning the original row.
    */
   recordUsage(params: RecordUsageParams, options?: IdempotentRequestOptions): Promise<EntitlementUsage[]>;
   list(options?: RequestOptions): Promise<Entitlement[]>;
@@ -5769,8 +5893,24 @@ declare class MembersResource extends APIResource {
     since?: string;
   }, options?: RequestOptions): Promise<MemberSyncResponse>;
   get(id: string, options?: RequestOptions): Promise<Member>;
+  /**
+   * The entitlements a member can use right now.
+   *
+   * `targets` filters the result down to the benefits valid at the venue,
+   * zone, shop or gate it names — the same codes `admit.check` takes, but
+   * read as a filter here rather than as the context a gate decision is made
+   * in. Three states: omit it and nothing is filtered by target; pass `[]`
+   * and only benefits valid anywhere come back; pass codes and a benefit
+   * needs one of them. Codes are matched exactly, so send them back verbatim
+   * from `targetCodes.list()` — an unregistered one is refused with a 400.
+   *
+   * Each entitlement carries `valid_on` and `valid_at` when something
+   * restricts it by date or by target; both list only what it matched, never
+   * what it failed.
+   */
   listEntitlements(id: string, params?: {
     type?: EntitlementType;
+    targets?: string[];
   }, options?: RequestOptions): Promise<MemberEntitlement[]>;
   /**
    * Updates a member's details. Accepts `name`, `date_of_birth` and `role`
@@ -5921,13 +6061,24 @@ declare class SalesChannelsResource extends APIResource {
 //#endregion
 //#region src/resources/target-codes.d.ts
 /**
- * The registered vocabulary of locations a gate can report (`venue_a`,
- * `coffee_shop`). Codes are matched exactly — list them and send values back
- * verbatim rather than constructing or case-folding them.
+ * The registered code for each venue, zone, shop or gate a request can name
+ * (`venue_a`, `coffee_shop`). Codes are matched exactly — list them and send
+ * values back verbatim rather than constructing or case-folding them.
  */
 declare class TargetCodesResource extends APIResource {
-  list(params?: PageParams, options?: RequestOptions): Promise<Page<TargetCode>>;
-  get(id: string, options?: RequestOptions): Promise<TargetCode>;
+  /**
+   * Pass `view: 'full'` to include `plan_entitlement_count` on every target
+   * code.
+   */
+  list(params?: PageParams & {
+    view?: TargetCodeView;
+  }, options?: RequestOptions): Promise<Page<TargetCode>>;
+  /**
+   * Pass `view: 'full'` to include `plan_entitlement_count`.
+   */
+  get(id: string, params?: {
+    view?: TargetCodeView;
+  }, options?: RequestOptions): Promise<TargetCode>;
   /**
    * `code` is lowercase letters and digits with single underscores between
    * segments, at least one letter, 2–64 characters. Anything else is refused
@@ -6106,4 +6257,4 @@ declare function paginate<T>(fetchPage: (params: PageParams) => Promise<Page<T>>
  */
 declare function collect<T>(fetchPage: (params: PageParams) => Promise<Page<T>>, params?: PageParams): Promise<T[]>;
 //#endregion
-export { AddMemberParams, AdmitResult, AlreadyExistsError, BillingOption, BillingOptionSalesChannel, Calendar, CalendarRule, CancelMembershipParams, CreateBillingOptionParams, CreateBillingOptionSalesChannelParams, CreateCalendarParams, CreateCalendarRuleParams, CreateCustomerParams, CreateEntitlementParams, CreateMemberRoleParams, CreateMembershipParams, CreatePlanEntitlementAvailabilityParams, CreatePlanEntitlementParams, CreatePlanLinkParams, CreatePlanParams, CreatePlanPricingGroupMappingParams, CreatePricingGroupParams, CreateSalesChannelParams, CreateTargetCodeParams, CreateTransactionParams, CreateWebhookSubscriptionParams, Customer, CustomerMembershipSummary, CustomerView, DEFAULT_BASE_URL, Entitlement, EntitlementType, EntitlementUsage, type IdempotentRequestOptions, InternalError, InvalidArgumentError, Member, MemberEntitlement, MemberRole, MemberSyncResponse, Membership, MembershipTerm, NotFoundError, Ophelio, OphelioConnectionError, OphelioError, type OphelioOptions, OphelioTimeoutError, type OphelioWebhookEvent, Page, PageParams, PermissionDeniedError, Plan, PlanChangeParams, PlanChangeResult, PlanEntitlement, PlanEntitlementAvailability, PlanLink, PlanLinkView, PlanPricingGroupMapping, PricingGroup, RecordUsageParams, RedeemEntitlementParams, RedeemEntitlementResponse, ReissueCardParams, RenewMembershipParams, type RequestOptions, ResourceExhaustedError, SalesChannel, ScheduledChange, SyncMember, TargetCode, Transaction, UnauthenticatedError, UnavailableError, UnimplementedError, UpdateBillingOptionParams, UpdateCalendarParams, UpdateCalendarRuleParams, UpdateCustomerParams, UpdateEntitlementParams, UpdateMemberParams, UpdateMemberRoleParams, UpdateMembershipParams, UpdatePlanEntitlementAvailabilityParams, UpdatePlanEntitlementParams, UpdatePlanParams, UpdatePricingGroupParams, UpdateSalesChannelParams, UpdateTargetCodeParams, UpdateWebhookSubscriptionParams, WEBHOOK_EVENT_CODES, WebhookDelivery, type WebhookEventCode, WebhookSignatureVerificationError, WebhookSubscription, collect, type components, constructEvent, type operations, paginate, type paths, verifyWebhookSignature };
+export { AddMemberParams, AdmitResult, AlreadyExistsError, BillingOption, BillingOptionSalesChannel, Calendar, CalendarRule, CalendarView, CancelMembershipParams, CreateBillingOptionParams, CreateBillingOptionSalesChannelParams, CreateCalendarParams, CreateCalendarRuleParams, CreateCustomerParams, CreateEntitlementParams, CreateMemberRoleParams, CreateMembershipParams, CreatePlanEntitlementAvailabilityParams, CreatePlanEntitlementParams, CreatePlanLinkParams, CreatePlanParams, CreatePlanPricingGroupMappingParams, CreatePricingGroupParams, CreateSalesChannelParams, CreateTargetCodeParams, CreateTransactionParams, CreateWebhookSubscriptionParams, Customer, CustomerMembershipSummary, CustomerView, DEFAULT_BASE_URL, Entitlement, EntitlementType, EntitlementUsage, type IdempotentRequestOptions, InternalError, InvalidArgumentError, Member, MemberEntitlement, MemberRole, MemberSyncResponse, Membership, MembershipTerm, NotFoundError, Ophelio, OphelioConnectionError, OphelioError, type OphelioOptions, OphelioTimeoutError, type OphelioWebhookEvent, Page, PageParams, PermissionDeniedError, Plan, PlanChangeParams, PlanChangeResult, PlanEntitlement, PlanEntitlementAvailability, PlanLink, PlanLinkView, PlanPricingGroupMapping, PricingGroup, RecordUsageParams, RedeemEntitlementParams, RedeemEntitlementResponse, ReissueCardParams, RenewMembershipParams, type RequestOptions, ResourceExhaustedError, SalesChannel, ScheduledChange, SyncMember, TargetCode, TargetCodeView, Transaction, UnauthenticatedError, UnavailableError, UnimplementedError, UpdateBillingOptionParams, UpdateCalendarParams, UpdateCalendarRuleParams, UpdateCustomerParams, UpdateEntitlementParams, UpdateMemberParams, UpdateMemberRoleParams, UpdateMembershipParams, UpdatePlanEntitlementAvailabilityParams, UpdatePlanEntitlementParams, UpdatePlanParams, UpdatePricingGroupParams, UpdateSalesChannelParams, UpdateTargetCodeParams, UpdateWebhookSubscriptionParams, WEBHOOK_EVENT_CODES, WebhookDelivery, type WebhookEventCode, WebhookSignatureVerificationError, WebhookSubscription, collect, type components, constructEvent, type operations, paginate, type paths, verifyWebhookSignature };