@getmicdrop/venue-calendar 4.3.138 → 4.3.139

package/dist/api/client.d.ts

@@ -24,12 +24,10 @@ export interface ApiRequestOptions extends RequestInit {
      * Skip the global `onError` handler for this call.
      *
      * For endpoints where a non-2xx is an EXPECTED, handled answer rather than a
-     * fault — /tax-preview's 422 "this venue has no tax address, show $0" is the
-     * live example. Without this the caller has to bypass the whole api-client
-     * with a raw `fetch` just to avoid emitting API-error noise on the happy
-     * path, which is how the hardcoded `https://get-micdrop.com` tax-preview URL
-     * in CartView survived (and broke every venue-hosted embed, which cannot
-     * reach a URL pinned to our own origin under its own CSP/consent rules).
+     * fault. Without this the caller has to bypass the whole api-client with a
+     * raw `fetch` just to avoid emitting API-error noise on the happy path — and a
+     * raw `fetch` pinned to our own origin breaks every venue-hosted embed, which
+     * cannot reach it under its own CSP/consent rules.
      */
     suppressOnError?: boolean;
 }
@@ -122,53 +120,6 @@ export declare function apiGet<T>(endpoint: string, options?: ApiRequestOptions)
 export declare function apiPost<T>(endpoint: string, body?: unknown, options?: ApiRequestOptions): Promise<ApiResult<T>>;
 export declare function apiPut<T>(endpoint: string, body?: unknown, options?: ApiRequestOptions): Promise<ApiResult<T>>;
 export declare function apiDelete<T>(endpoint: string, options?: ApiRequestOptions): Promise<ApiResult<T>>;
-/** One priced line in a tax quote. `amountCents` is the LINE total, not unit. */
-export interface TaxPreviewLineItem {
-    amountCents: number;
-    reference: string;
-    quantity: number;
-}
-export interface TaxPreviewRequest {
-    venueId: number;
-    /** WHICH SHOW the quote is for — honours a per-event tax exemption (MIC-2606). */
-    eventId?: number;
-    lineItems: TaxPreviewLineItem[];
-    /** Order-level promo discount in integer cents (MIC-2567). */
-    discountCents?: number;
-    /** Ask the server for the authoritative service fee alongside the tax. */
-    computeServiceFee?: boolean;
-}
-/** Both fields are integer CENTS, and both are contract-optional. */
-export interface TaxPreviewResponse {
-    taxTotal?: number;
-    serviceFeeCents?: number;
-}
-/**
- * Server-authoritative tax (and, optionally, service fee) quote.
- *
- * Exists so the cart summary does not have to bypass this client to get one.
- * The raw `fetch` it replaces hardcoded `https://get-micdrop.com/...`, which is
- * the whole third-party-domain bug in one line: an embed on a venue's own
- * domain could not retarget it at all, so a self-hosted or proxied deployment
- * quoted tax from the wrong origin (or, under a strict CSP, not at all).
- *
- * `suppressOnError` defaults TRUE because a 422 here is a documented, handled
- * answer — "this venue has no address configured for Stripe Tax, show $0" — and
- * routing it through the global onError handler is what made the raw fetch look
- * necessary. Callers still see the 422 in `statusCode` and must apply their own
- * fallback; genuine 5xx/network failures are theirs to log.
- *
- * @param req - the quote request; `lineItems` may be empty, but prefer not
- *   calling at all in that case (the server has nothing to price).
- * @param options.signal - abort a superseded quote. An abort comes back as
- *   `{ aborted: true }`, NOT as a failure, so a debouncing caller can return
- *   early without clobbering the numbers it is still showing.
- */
-export declare function taxPreview(req: TaxPreviewRequest, options?: {
-    signal?: AbortSignal;
-    suppressOnError?: boolean;
-    widgetKey?: string;
-}): Promise<ApiResult<TaxPreviewResponse>>;
 /**
  * Whether a GET to `url` answers 2xx. Reads no body and reports nothing.
  *
@@ -187,4 +138,14 @@ export declare function apiResponds(url: string, options?: Pick<ApiRequestOption
  * credentials; see the apiRequest comment for why that is the point.
  */
 export declare function simpleFetch<T>(url: string, options?: RequestInit & Pick<ApiRequestOptions, 'widgetKey'>): Promise<T | null>;
+/**
+ * simpleFetch that also hands back the HTTP status of a refused request, so a
+ * loader can tell a 403 (this site may not read this calendar) from a network
+ * or server failure. `status` is 0 when no response arrived at all.
+ */
+export declare const simpleFetchWithStatus: typeof requestJson;
+declare function requestJson<T>(url: string, options?: RequestInit & Pick<ApiRequestOptions, 'widgetKey'>): Promise<{
+    data: T | null;
+    status: number;
+}>;
 export {};

package/dist/api/events.d.ts

@@ -21,7 +21,7 @@ export declare function fetchEventDetailsResult(eventId: string | number, custom
  * Gets full event information including venue and ticket data.
  *
  * Fail-open adapter over {@link fetchEventDetailsResult}: existing in-widget
- * callers (Checkout, CartView, EventPage) keep degrading to `null` on any
+ * callers (Checkout, EventPage) keep degrading to `null` on any
  * failure. SSR loaders that need to answer 404-vs-503 use the Result variant.
  *
  * @param eventId - The event ID
@@ -97,6 +97,20 @@ export interface MonthReadOptions {
  * Returns whether a month was parked.
  */
 export declare function primeOrgMonthEvents(orgId: string | number, firstMonth: unknown, req?: Pick<ApiRequestOptions, 'widgetKey'>): boolean;
+/**
+ * Park months the embed's first piece already read (src/lib/split), so the full
+ * widget it hands over to draws from them instead of asking again.
+ *
+ * Same hand-off as `primeOrgMonthEvents`, for whichever feed the calendar
+ * reads: the organization feed when `organizationId` is set, else the venue
+ * feed — CalendarContainer.loadMonthEvents' own rule. Parked at the moment of
+ * the hand-over, so the TTL counts from then: the data is exactly as old as the
+ * card the visitor is looking at.
+ */
+export declare function primeMonthEvents(feed: {
+    organizationId?: string | number;
+    venueId?: string | number;
+}, year: number, month: number, events: Event[], req?: Pick<ApiRequestOptions, 'widgetKey'>): boolean;
 export declare function getMonthEventsResult(venueId: string | number, year: number, month: number, options?: MonthReadOptions, req?: Pick<ApiRequestOptions, 'widgetKey'>): Promise<Result<Event[]>>;
 export declare function getMonthEvents(venueId: string | number, year: number, month: number, req?: Pick<ApiRequestOptions, 'widgetKey'>): Promise<Event[]>;
 /**

package/dist/api/result.d.ts

@@ -29,6 +29,7 @@ export type Result<T> = {
     ok: false;
     error: string;
     notFound?: boolean;
+    forbidden?: boolean;
 };
 /** Wrap a successful value. */
 export declare function ok<T>(data: T): Result<T>;
@@ -49,6 +50,13 @@ export declare function err(error: string): Result<never>;
  * channel exists to prevent (a fetch blip becoming a permanent 404).
  */
 export declare function errNotFound(error: string): Result<never>;
+/**
+ * Wrap a refusal (upstream 403): the API will not answer this caller at all —
+ * on the public surface, a widget on a domain the venue has not allowed, or
+ * one sent without its key. Retrying cannot help, so a caller shows that the
+ * calendar is not enabled for the site rather than a connection error.
+ */
+export declare function errForbidden(error: string): Result<never>;
 /** Narrowing guard — true when the result carries data. */
 export declare function isOk<T>(result: Result<T>): result is {
     ok: true;
@@ -67,6 +75,7 @@ export declare function isErr<T>(result: Result<T>): result is {
     ok: false;
     error: string;
     notFound?: boolean;
+    forbidden?: boolean;
 };
 /**
  * Collapse a Result to its data, substituting `fallback` on failure.