@ophelio/sdk 0.3.1 → 0.4.0

package/dist/index.d.cts

@@ -27,10 +27,15 @@ interface IdempotentRequestOptions extends RequestOptions {
    */
   idempotencyKey?: string;
 }
+/**
+ * A query parameter value. An array is multi-valued: it goes on the wire
+ * comma-separated (`?status=pending,failed`), the form the API parses.
+ */
+type QueryValue = string | string[] | undefined;
 interface RequestParams {
   method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
   path: string;
-  query?: Record<string, string | undefined>;
+  query?: Record<string, QueryValue>;
   body?: unknown;
   idempotencyKey?: string;
   /**
@@ -446,6 +451,38 @@ interface paths {
     patch: operations["PlanEntitlementsController_update"];
     trace?: never;
   };
+  "/api/v1/plan-entitlements/{id}/availabilities": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get: operations["PlanEntitlementsController_listAvailabilities"];
+    put?: never;
+    post: operations["PlanEntitlementsController_createAvailability"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/plan-entitlement-availabilities/{id}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get: operations["PlanEntitlementAvailabilitiesController_get"];
+    put?: never;
+    post?: never;
+    delete: operations["PlanEntitlementAvailabilitiesController_delete"];
+    options?: never;
+    head?: never;
+    patch: operations["PlanEntitlementAvailabilitiesController_update"];
+    trace?: never;
+  };
   "/api/v1/plan-pricing-group-mappings/{id}": {
     parameters: {
       query?: never;
@@ -622,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;
@@ -1038,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;
@@ -1136,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;
@@ -1274,12 +1312,27 @@ interface components {
       create_time: string; /** Format: date-time */
       update_time: string;
     };
+    PlanEntitlementAvailability: {
+      /** @description Calendar the row is restricted to. Null means the row places no date restriction. */calendar_id: string | null;
+      /**
+       * @description Registered target codes the row is restricted to. An empty array means anywhere.
+       * @example [
+       *       "venue_a"
+       *     ]
+       */
+      targets: string[];
+      id: string;
+      plan_entitlement_id: string; /** Format: date-time */
+      create_time: string; /** Format: date-time */
+      update_time: string;
+    };
     PlanEntitlementDefinition: {
       code: string; /** @enum {string} */
       type: "discount" | "early_access" | "free_entry" | "guest_pass";
       display_name: string;
     };
     PlanEntitlement: {
+      /** @description When and where the entitlement applies. Rows are alternatives: the entitlement matches if any one of them does. An empty array means it is unrestricted. */availabilities: components["schemas"]["PlanEntitlementAvailability"][];
       id: string;
       plan_id: string;
       entitlement_id: string;
@@ -1383,12 +1436,58 @@ interface components {
       early_access_days: number;
       active_during_grace: boolean;
     };
+    ListPlanEntitlementAvailabilitiesResponse: {
+      /**
+       * @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;
+      availabilities: components["schemas"]["PlanEntitlementAvailability"][];
+    };
+    CreatePlanEntitlementAvailabilityDto: {
+      /**
+       * @description Registered target codes the row is restricted to. Omit or send an empty
+       *     array for anywhere. Every code must already exist in the project's target
+       *     code vocabulary.
+       * @example [
+       *       "venue_a"
+       *     ]
+       */
+      targets?: string[];
+      /**
+       * Format: uuid
+       * @description Calendar the row is restricted to. Omit or send null for a row that places
+       *     no date restriction.
+       */
+      calendar_id?: string | null;
+    };
+    UpdatePlanEntitlementAvailabilityDto: {
+      /**
+       * @description Registered target codes the row is restricted to. Omit or send an empty
+       *     array for anywhere. Every code must already exist in the project's target
+       *     code vocabulary.
+       * @example [
+       *       "venue_a"
+       *     ]
+       */
+      targets?: string[];
+      /**
+       * Format: uuid
+       * @description Calendar the row is restricted to. Omit or send null for a row that places
+       *     no date restriction.
+       */
+      calendar_id?: string | null;
+    };
     Entitlement: {
       id: string;
       code: string;
       display_name: string; /** @enum {string} */
       type: "discount" | "early_access" | "free_entry" | "guest_pass";
-      target: string | null;
       description: string | null; /** Format: date-time */
       create_time: string; /** Format: date-time */
       update_time: string;
@@ -1411,6 +1510,7 @@ interface components {
       entitlement_code: string;
       members: string[];
       used_time?: string;
+      target?: string;
       context: {
         [key: string]: unknown;
       };
@@ -1421,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;
@@ -1434,15 +1535,56 @@ interface components {
       code: string;
       display_name: string; /** @enum {string} */
       type: "discount" | "early_access" | "free_entry" | "guest_pass";
-      target: string;
       description: string;
     };
     UpdateEntitlementDto: {
       code: string;
       display_name: string;
-      target: 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;
@@ -1451,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 */
@@ -1481,19 +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";
-      target: string | null;
-      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"][];
     };
@@ -1513,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;
@@ -1529,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;
@@ -1627,6 +1797,11 @@ interface components {
       description: string;
     };
     Calendar: {
+      /**
+       * @description How many plan entitlements restrict availability to this calendar. Populated only when `view=full`.
+       * @example 3
+       */
+      plan_entitlement_count?: number;
       id: string; /** @description Stable identifier for the calendar, unique within a project. */
       code: string; /** @description Human-readable name, e.g. "Peak 2026". */
       display_name: string;
@@ -1987,40 +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;
-      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;
@@ -3121,9 +3262,12 @@ interface operations {
       };
     };
   };
-  PlanPricingGroupMappingsController_delete: {
+  PlanEntitlementsController_listAvailabilities: {
     parameters: {
-      query?: never;
+      query?: {
+        page_size?: number;
+        page_token?: string;
+      };
       header?: never;
       path?: never;
       cookie?: never;
@@ -3135,7 +3279,7 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": Record<string, never>;
+          "application/json": components["schemas"]["ListPlanEntitlementAvailabilitiesResponse"];
         };
       };
       404: {
@@ -3148,33 +3292,192 @@ interface operations {
       };
     };
   };
-  EntitlementsController_list: {
+  PlanEntitlementsController_createAvailability: {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
-    requestBody?: never;
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["CreatePlanEntitlementAvailabilityDto"];
+      };
+    };
     responses: {
-      200: {
+      201: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ListEntitlementsResponse"];
+          "application/json": components["schemas"]["PlanEntitlementAvailability"];
         };
       };
-    };
-  };
-  EntitlementsController_create: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody: {
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  PlanEntitlementAvailabilitiesController_get: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["PlanEntitlementAvailability"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  PlanEntitlementAvailabilitiesController_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"];
+        };
+      };
+    };
+  };
+  PlanEntitlementAvailabilitiesController_update: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["UpdatePlanEntitlementAvailabilityDto"];
+      };
+    };
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["PlanEntitlementAvailability"];
+        };
+      };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  PlanPricingGroupMappingsController_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"];
+        };
+      };
+    };
+  };
+  EntitlementsController_list: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ListEntitlementsResponse"];
+        };
+      };
+    };
+  };
+  EntitlementsController_create: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
       content: {
         "application/json": components["schemas"]["CreateEntitlementDto"];
       };
@@ -3422,23 +3725,219 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      204: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      404: {
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  MembersController_update: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["UpdateMemberDto"];
+      };
+    };
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["Member"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  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;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ListMemberEntitlementsResponse"];
+        };
+      };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  MembersController_setPrimary: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["Member"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  MembersController_reissueCard: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["ReissueCardDto"];
+      };
+    };
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["Member"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  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;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["AdmitResult"];
+        };
+      };
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+    };
+  };
+  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"]["ErrorResponse"];
+          "application/json": components["schemas"]["ListTargetCodesResponse"];
         };
       };
     };
   };
-  MembersController_update: {
+  TargetCodesController_create: {
     parameters: {
       query?: never;
       header?: never;
@@ -3447,19 +3946,27 @@ interface operations {
     };
     requestBody: {
       content: {
-        "application/json": components["schemas"]["UpdateMemberDto"];
+        "application/json": components["schemas"]["CreateTargetCodeDto"];
       };
     };
     responses: {
-      200: {
+      201: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["Member"];
+          "application/json": components["schemas"]["TargetCode"];
         };
       };
-      404: {
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorResponse"];
+        };
+      };
+      409: {
         headers: {
           [name: string]: unknown;
         };
@@ -3469,10 +3976,10 @@ interface operations {
       };
     };
   };
-  MembersController_listEntitlements: {
+  TargetCodesController_get: {
     parameters: {
       query?: {
-        type?: "discount" | "early_access" | "free_entry" | "guest_pass";
+        /** @description Response detail level; `full` populates `plan_entitlement_count`. */view?: "basic" | "full";
       };
       header?: never;
       path?: never;
@@ -3485,7 +3992,7 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ListMemberEntitlementsResponse"];
+          "application/json": components["schemas"]["TargetCode"];
         };
       };
       404: {
@@ -3498,7 +4005,7 @@ interface operations {
       };
     };
   };
-  MembersController_setPrimary: {
+  TargetCodesController_delete: {
     parameters: {
       query?: never;
       header?: never;
@@ -3512,7 +4019,7 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["Member"];
+          "application/json": Record<string, never>;
         };
       };
       404: {
@@ -3533,7 +4040,7 @@ interface operations {
       };
     };
   };
-  MembersController_reissueCard: {
+  TargetCodesController_update: {
     parameters: {
       query?: never;
       header?: never;
@@ -3542,7 +4049,7 @@ interface operations {
     };
     requestBody: {
       content: {
-        "application/json": components["schemas"]["ReissueCardDto"];
+        "application/json": components["schemas"]["UpdateTargetCodeDto"];
       };
     };
     responses: {
@@ -3551,10 +4058,10 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["Member"];
+          "application/json": components["schemas"]["TargetCode"];
         };
       };
-      404: {
+      400: {
         headers: {
           [name: string]: unknown;
         };
@@ -3562,27 +4069,6 @@ interface operations {
           "application/json": components["schemas"]["ErrorResponse"];
         };
       };
-    };
-  };
-  AdmitController_check: {
-    parameters: {
-      query: {
-        card: string;
-      };
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": components["schemas"]["AdmitResult"];
-        };
-      };
       404: {
         headers: {
           [name: string]: unknown;
@@ -4008,7 +4494,8 @@ interface operations {
     parameters: {
       query?: {
         page_size?: number;
-        page_token?: string;
+        page_token?: string; /** @description Response detail level; `full` populates `plan_entitlement_count`. */
+        view?: "basic" | "full";
       };
       header?: never;
       path?: never;
@@ -4059,7 +4546,9 @@ interface operations {
   };
   CalendarsController_get: {
     parameters: {
-      query?: never;
+      query?: {
+        /** @description Response detail level; `full` populates `plan_entitlement_count`. */view?: "basic" | "full";
+      };
       header?: never;
       path?: never;
       cookie?: never;
@@ -4988,168 +5477,6 @@ interface operations {
       };
     };
   };
-  TargetCodesController_list: {
-    parameters: {
-      query?: {
-        page_size?: number;
-        page_token?: string;
-      };
-      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?: never;
-      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;
@@ -5297,6 +5624,7 @@ type Member = Schemas['Member'];
 type SyncMember = Schemas['SyncMember'];
 type MemberEntitlement = Schemas['MemberEntitlement'];
 type PlanEntitlement = Schemas['PlanEntitlement'];
+type PlanEntitlementAvailability = Schemas['PlanEntitlementAvailability'];
 type Transaction = Schemas['Transaction'];
 type EntitlementUsage = Schemas['EntitlementUsage'];
 type AdmitResult = Schemas['AdmitResult'];
@@ -5318,6 +5646,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;
@@ -5363,6 +5693,8 @@ type UpdateEntitlementParams = Schemas['UpdateEntitlementDto'];
 type CreatePlanLinkParams = Schemas['CreatePlanLinkDto'];
 type CreatePlanEntitlementParams = Schemas['CreatePlanEntitlementDto'];
 type UpdatePlanEntitlementParams = Schemas['UpdatePlanEntitlementDto'];
+type CreatePlanEntitlementAvailabilityParams = Schemas['CreatePlanEntitlementAvailabilityDto'];
+type UpdatePlanEntitlementAvailabilityParams = Schemas['UpdatePlanEntitlementAvailabilityDto'];
 type CreatePlanPricingGroupMappingParams = Schemas['CreatePlanPricingGroupMappingDto'];
 type CreateBillingOptionSalesChannelParams = Schemas['CreateBillingOptionSalesChannelDto'];
 type CreateWebhookSubscriptionParams = Schemas['CreateWebhookSubscriptionDto'];
@@ -5379,9 +5711,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
@@ -5403,7 +5751,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.
  *
@@ -5419,14 +5767,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>;
@@ -5465,6 +5824,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[]>;
@@ -5493,8 +5860,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`
@@ -5569,12 +5952,31 @@ declare class MembershipsResource extends APIResource {
   listTermTransactions(id: string, termId: string, params?: PageParams, options?: RequestOptions): Promise<Page<Transaction>>;
 }
 //#endregion
+//#region src/resources/plan-entitlement-availabilities.d.ts
+/**
+ * An availability row says when and where one plan entitlement applies: a
+ * calendar (null = any date) and a set of registered target codes (empty =
+ * anywhere). Rows OR, and a plan entitlement with no rows at all is
+ * unrestricted.
+ *
+ * Rows are created and listed through their plan entitlement
+ * (`ophelio.planEntitlements.createAvailability` / `listAvailabilities`); this
+ * resource addresses an individual row.
+ */
+declare class PlanEntitlementAvailabilitiesResource extends APIResource {
+  get(id: string, options?: RequestOptions): Promise<PlanEntitlementAvailability>;
+  update(id: string, params: UpdatePlanEntitlementAvailabilityParams, options?: RequestOptions): Promise<PlanEntitlementAvailability>;
+  delete(id: string, options?: RequestOptions): Promise<void>;
+}
+//#endregion
 //#region src/resources/plan-entitlements.d.ts
 declare class PlanEntitlementsResource extends APIResource {
   get(id: string, options?: RequestOptions): Promise<PlanEntitlement>;
   update(id: string, params: UpdatePlanEntitlementParams, options?: RequestOptions): Promise<PlanEntitlement>;
   /** Detach an entitlement from its plan. Attach via plans.createEntitlement(). */
   delete(id: string, options?: RequestOptions): Promise<void>;
+  listAvailabilities(id: string, params?: PageParams, options?: RequestOptions): Promise<Page<PlanEntitlementAvailability>>;
+  createAvailability(id: string, params: CreatePlanEntitlementAvailabilityParams, options?: RequestOptions): Promise<PlanEntitlementAvailability>;
 }
 //#endregion
 //#region src/resources/plan-links.d.ts
@@ -5626,13 +6028,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
@@ -5728,6 +6141,7 @@ declare class Ophelio {
   readonly calendars: CalendarsResource;
   readonly calendarRules: CalendarRulesResource;
   readonly planEntitlements: PlanEntitlementsResource;
+  readonly planEntitlementAvailabilities: PlanEntitlementAvailabilitiesResource;
   readonly planLinks: PlanLinksResource;
   readonly planPricingGroupMappings: PlanPricingGroupMappingsResource;
   readonly billingOptionSalesChannels: BillingOptionSalesChannelsResource;
@@ -5810,4 +6224,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, 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, 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, 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 };