@fanfare-io/fanfare-sdk-core 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,44 @@
+# @fanfare-io/fanfare-sdk-core
+
+Framework-agnostic browser SDK for [Fanfare](https://www.fanfare.io) controlled-access experiences: queues, draws, auctions, timed releases, waitlists, and appointments.
+
+The core concept is a **journey**: one consumer's progress through one Fanfare experience. Your application reads the current `JourneyView` and offers only the actions present in that view. The [React](https://www.npmjs.com/package/@fanfare-io/fanfare-sdk-react) and [Solid / web component](https://www.npmjs.com/package/@fanfare-io/fanfare-sdk-solid) adapters build on this package; use core directly when you want to own the UI.
+
+## Install
+
+```bash
+npm install @fanfare-io/fanfare-sdk-core
+```
+
+## Usage
+
+```ts
+import initFanfare from "@fanfare-io/fanfare-sdk-core";
+
+const sdk = await initFanfare({
+  organizationId: "org_123",
+  publishableKey: "pk_live_123",
+});
+
+const journey = sdk.journeys.get("exp_123");
+
+journey.view$.listen((view) => {
+  if (view.journeyStage === "ready") {
+    // offer view.start()
+  }
+});
+```
+
+The published artifact is self-contained: installable, runnable, and typecheckable using only public package dependencies.
+
+## Documentation
+
+- [Core SDK quickstart](https://docs.fanfare.io/sdk/core/quickstart)
+- [Journey state model](https://docs.fanfare.io/sdk/core/journey-state)
+- [SDK overview](https://docs.fanfare.io/sdk/overview)
+- [Website](https://www.fanfare.io)
+- [Source & issues](https://github.com/fanfare-io/fanfare-sdk)
+
+## License
+
+[Apache-2.0](./LICENSE)

package/dist/adapters/google-analytics.d.ts

@@ -0,0 +1,12 @@
+import { SDKEventKey } from '../state/events';
+import { CDPAdapter } from './types';
+declare global {
+    interface Window {
+        gtag?: (...args: unknown[]) => void;
+    }
+}
+export interface GAAdapterOptions {
+    measurementId?: string;
+    events?: SDKEventKey[];
+}
+export declare function createGAAdapter(options?: GAAdapterOptions): CDPAdapter;

package/dist/adapters/google-analytics.js

@@ -0,0 +1 @@
+const e={"experience:entered":"fanfare_experience_entered","experience:left":"fanfare_experience_left","experience:distribution-entered":"fanfare_distribution_entered","queue:entered":"fanfare_queue_entered","queue:granted":"fanfare_queue_granted","queue:left":"fanfare_queue_left","queue:expired":"fanfare_queue_expired","draw:entered":"fanfare_draw_entered","draw:won":"fanfare_draw_won","draw:lost":"fanfare_draw_lost","auction:entered":"fanfare_auction_entered","auction:bid-placed":"fanfare_auction_bid_placed","auction:outbid":"fanfare_auction_outbid","auction:won":"fanfare_auction_won","auction:lost":"fanfare_auction_lost","waitlist:entered":"fanfare_waitlist_entered","waitlist:left":"fanfare_waitlist_left","timed_release:entered":"fanfare_timed_release_entered","timed_release:completed":"fanfare_timed_release_completed","auth:authenticated":"fanfare_auth_authenticated"},t=Object.keys(e),i={"experience:entered":e=>({experience_id:String(e.experienceId??"")}),"experience:left":e=>({experience_id:String(e.experienceId??"")}),"experience:distribution-entered":e=>({distribution_type:String(e.distributionType??""),distribution_id:String(e.distributionId??"")}),"queue:entered":e=>({queue_id:String(e.queueId??""),position:Number(e.position??0),...null!=e.estimatedWaitTime?{estimated_wait_time:Number(e.estimatedWaitTime)}:{}}),"queue:granted":e=>({queue_id:String(e.queueId??"")}),"queue:left":e=>({queue_id:String(e.queueId??""),...e.reason?{reason:String(e.reason)}:{}}),"queue:expired":e=>({queue_id:String(e.queueId??"")}),"draw:entered":e=>({draw_id:String(e.drawId??""),...e.entryNumber?{entry_number:String(e.entryNumber)}:{}}),"draw:won":e=>({draw_id:String(e.drawId??"")}),"draw:lost":e=>({draw_id:String(e.drawId??"")}),"auction:entered":e=>({auction_id:String(e.auctionId??"")}),"auction:bid-placed":e=>({auction_id:String(e.auctionId??""),amount:String(e.amount??""),status:String(e.status??"")}),"auction:outbid":e=>({auction_id:String(e.auctionId??""),your_bid:String(e.yourBid??""),highest_bid:String(e.highestBid??"")}),"auction:won":e=>({auction_id:String(e.auctionId??""),winning_bid:String(e.winningBid??"")}),"auction:lost":e=>({auction_id:String(e.auctionId??""),highest_bid:String(e.highestBid??"")}),"waitlist:entered":e=>({waitlist_id:String(e.waitlistId??""),sequence_id:String(e.sequenceId??"")}),"waitlist:left":e=>({waitlist_id:String(e.waitlistId??"")}),"timed_release:entered":e=>({timed_release_id:String(e.timedReleaseId??"")}),"timed_release:completed":e=>({timed_release_id:String(e.timedReleaseId??"")}),"auth:authenticated":e=>({is_new:Boolean(e.isNew)})};function n(n){const r=[];return{id:"google-analytics",init(a,d){if(r.length>0)throw new Error("GA adapter already initialized. Create a new adapter instance per SDK via createGAAdapter().");const u=[...new Set(d?.events??n?.events??t)];for(const t of u){const d=e[t];if(!d)continue;const u=a.on(t,e=>{if("undefined"==typeof window||"function"!=typeof window.gtag)return;const r=i[t],a={fanfare_event:t,...r?r(e):{},...n?.measurementId?{send_to:n.measurementId}:{}};window.gtag("event",d,a)});r.push(u)}},destroy(){for(const e of r)e();r.length=0}}}export{n as createGAAdapter};

package/dist/adapters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Experimental CDP adapter surface backing `sdk.use(adapter, config)`: the
+ * `CDPAdapter` contract for custom analytics adapters plus the bundled GA4
+ * adapter. Not yet a stability-guaranteed public API — shapes may change
+ * without a major bump (see docs/PUBLIC_SURFACE.md).
+ */
+export { createGAAdapter } from './google-analytics';
+export type { GAAdapterOptions } from './google-analytics';
+export type { CDPAdapter, CDPAdapterConfig } from './types';

package/dist/adapters/index.js

@@ -0,0 +1 @@
+import{createGAAdapter as o}from"./google-analytics.js";export{o as createGAAdapter};

package/dist/adapters/types.d.ts

@@ -0,0 +1,9 @@
+import { EventBus, SDKEventKey } from '../state/events';
+export interface CDPAdapterConfig {
+    events?: SDKEventKey[];
+}
+export interface CDPAdapter {
+    readonly id: string;
+    init(eventBus: EventBus, config?: CDPAdapterConfig): void;
+    destroy(): void;
+}

package/dist/appointments/appointment.module.d.ts

@@ -0,0 +1,32 @@
+import { HttpClient } from '../core/http';
+import { MonitorUpdate } from '../experiences/distribution-monitor.types';
+import { AppointmentDetails } from '../experiences/types';
+import { AppointmentBooking, AppointmentModule, AppointmentSlot } from './types';
+export declare class AppointmentManagementModule implements AppointmentModule {
+    private readonly http;
+    private readonly logger;
+    private readonly monitorRuntime;
+    private readonly pollingIntervals;
+    private readonly monitorGenerations;
+    private readonly pollingIntervalMs;
+    private destroyed;
+    constructor(http: HttpClient, opts?: {
+        pollingIntervalMs?: number;
+    });
+    get(appointmentId: string): Promise<AppointmentDetails>;
+    getSlots(appointmentId: string, range: {
+        startDate: string;
+        endDate: string;
+        timezone?: string;
+    }): Promise<AppointmentSlot[]>;
+    getMe(appointmentId: string): Promise<AppointmentBooking | null>;
+    book(appointmentId: string, slotId: string, locationId?: string): Promise<AppointmentBooking>;
+    cancel(appointmentId: string, slotId: string, locationId?: string, reason?: string): Promise<void>;
+    reschedule(appointmentId: string, newSlotId: string, newLocationId?: string): Promise<AppointmentBooking>;
+    startMonitoring(id: string, context?: Record<string, unknown>, onUpdate?: (update: MonitorUpdate) => void): void;
+    stopMonitoring(id: string): void;
+    isMonitoring(id: string): boolean;
+    bumpMonitorGeneration(id: string): void;
+    destroy(): void;
+    private stopPolling;
+}

package/dist/appointments/appointment.module.js

@@ -0,0 +1 @@
+import*as t from"valibot";import{isFanfareError as o,createError as n}from"../core/errors.js";import{getLogger as i}from"../core/logger.js";import{parseResponse as e}from"../core/parse-response.js";import{DistributionMonitorRuntime as r}from"../experiences/distribution-monitor.runtime.js";function s(t,o,n){const i=e(t,o,{endpoint:n},{throwOnFailure:!0});if(!i.ok)throw i.error;return i.value}const a=t.object({id:t.string(),startTime:t.string(),endTime:t.string(),locationId:t.nullish(t.string()),locationName:t.nullish(t.string()),timezone:t.nullish(t.string()),capacity:t.number(),available:t.number()}),l=t.object({slots:t.array(a)}),d=t.object({id:t.string(),type:t.literal("appointment"),openAt:t.nullish(t.string()),closeAt:t.nullish(t.string()),slotDurationMinutes:t.nullish(t.number()),timeZone:t.nullish(t.string()),locationId:t.nullish(t.string()),totalSlots:t.nullish(t.number()),availableSlots:t.nullish(t.number())}),m=t.picklist(["booked","checked_in","completed"]),c=t.object({bookingId:t.string(),appointmentId:t.string(),consumerId:t.string(),slotId:t.string(),locationId:t.nullish(t.string()),locationName:t.nullish(t.string()),startTime:t.string(),endTime:t.string(),confirmationCode:t.string(),status:m,createdAt:t.string()}),p=t.object({booking:t.nullish(t.object({bookingId:t.string(),appointmentId:t.string(),consumerId:t.string(),slotId:t.string(),locationId:t.nullish(t.string()),locationName:t.nullish(t.string()),joinUrl:t.nullish(t.string()),startTime:t.string(),endTime:t.string(),confirmationCode:t.nullish(t.string()),status:m}))}),g=t.object({bookingId:t.string(),previousSlotId:t.string(),newSlotId:t.string(),confirmationCode:t.string(),status:m});function h(t){return{id:t.id,startTime:t.startTime,endTime:t.endTime,locationId:t.locationId??void 0,locationName:t.locationName??void 0,timezone:t.timezone??void 0,capacity:t.capacity,available:t.available}}class u{constructor(t,o){this.logger=i(),this.monitorRuntime=new r,this.pollingIntervals=/* @__PURE__ */new Map,this.monitorGenerations=/* @__PURE__ */new Map,this.destroyed=!1,this.http=t,this.pollingIntervalMs=o?.pollingIntervalMs??3e4}async get(t){try{const o=await this.http.get(`/appointments/${t}`),n=s(d,o,`/appointments/${t}`);return{id:n.id,type:"appointment",openAt:n.openAt??void 0,closeAt:n.closeAt??void 0,slotDurationMinutes:n.slotDurationMinutes??void 0,bookingWindowOpenAt:n.openAt??void 0,bookingWindowCloseAt:n.closeAt??void 0,timezone:n.timeZone??void 0,locationId:n.locationId??void 0,totalSlots:n.totalSlots??void 0,availableSlots:n.availableSlots??void 0}}catch(i){if(this.logger.error("Failed to get appointment",{appointmentId:t,error:i}),o(i))throw i;throw n.networkError("Failed to get appointment",{error:i})}}async getSlots(t,i){try{const o=new URLSearchParams({startDate:i.startDate,endDate:i.endDate});i.timezone&&o.set("timezone",i.timezone);const n=await this.http.get(`/appointments/${t}/slots?${o.toString()}`);return s(l,n,`/appointments/${t}/slots`).slots.map(h)}catch(e){if(this.logger.error("Failed to get appointment slots",{appointmentId:t,error:e}),o(e))throw e;throw n.networkError("Failed to get appointment slots",{error:e})}}async getMe(t){try{const o=await this.http.get(`/appointments/${t}/me`),n=s(p,o,`/appointments/${t}/me`);return n.booking?function(t){return{bookingId:t.bookingId,appointmentId:t.appointmentId,slotId:t.slotId,locationId:t.locationId??void 0,locationName:t.locationName??void 0,joinUrl:t.joinUrl??void 0,startTime:t.startTime,endTime:t.endTime,confirmationCode:t.confirmationCode??void 0,consumerStatus:t.status}}(n.booking):null}catch(i){if(this.logger.error("Failed to get current booking",{appointmentId:t,error:i}),o(i))throw i;throw n.networkError("Failed to get current booking",{error:i})}}async book(t,i,e){try{const o=await this.http.post(`/appointments/${t}/book`,{slotId:i,locationId:e??null});return function(t){return{bookingId:t.bookingId,appointmentId:t.appointmentId,slotId:t.slotId,locationId:t.locationId??void 0,locationName:t.locationName??void 0,startTime:t.startTime,endTime:t.endTime,confirmationCode:t.confirmationCode,consumerStatus:t.status}}(s(c,o,`/appointments/${t}/book`))}catch(r){if(this.logger.error("Failed to book appointment",{appointmentId:t,slotId:i,locationId:e,error:r}),o(r))throw r;throw n.networkError("Failed to book appointment",{error:r})}}async cancel(t,i,e,r){try{await this.http.post(`/appointments/${t}/cancel`,{slotId:i,locationId:e??null,reason:r??null})}catch(s){if(this.logger.error("Failed to cancel appointment",{appointmentId:t,slotId:i,locationId:e,error:s}),o(s))throw s;throw n.networkError("Failed to cancel appointment",{error:s})}}async reschedule(t,i,e){try{const o=await this.http.post(`/appointments/${t}/reschedule`,{newSlotId:i,newLocationId:e??null}),n=s(g,o,`/appointments/${t}/reschedule`),r=await this.getMe(t);return r?{...r,confirmationCode:n.confirmationCode}:{bookingId:n.bookingId,appointmentId:t,slotId:n.newSlotId,locationId:e,startTime:"",endTime:"",confirmationCode:n.confirmationCode,consumerStatus:n.status}}catch(r){if(this.logger.error("Failed to reschedule appointment",{appointmentId:t,newSlotId:i,newLocationId:e,error:r}),o(r))throw r;throw n.networkError("Failed to reschedule appointment",{error:r})}}startMonitoring(t,o,n){if(this.destroyed)return;this.monitorRuntime.start(t,o,n),this.stopPolling(t);const i=(this.monitorGenerations.get(t)??0)+1;this.monitorGenerations.set(t,i);const e=async()=>{if(!this.destroyed&&this.monitorGenerations.get(t)===i)try{const o=await this.getMe(t);if(this.destroyed||this.monitorGenerations.get(t)!==i)return;const n=this.monitorRuntime.getDisplayAtom(t);if(!n)return;if(o){const t=Math.max(0,Date.parse(o.startTime)-Date.now());n.set({type:"appointment",booking:{slotId:o.slotId,locationId:o.locationId,locationName:o.locationName,joinUrl:o.joinUrl,startTime:o.startTime,endTime:o.endTime,confirmationCode:o.confirmationCode,consumerStatus:o.consumerStatus},msUntilStart:t})}else n.set({type:"appointment"})}catch(o){this.logger.error("Appointment polling tick failed",{id:t,error:o})}};e();const r=setInterval(()=>{e()},this.pollingIntervalMs);this.pollingIntervals.set(t,r)}stopMonitoring(t){this.stopPolling(t),this.monitorRuntime.stop(t),this.monitorGenerations.set(t,(this.monitorGenerations.get(t)??0)+1)}isMonitoring(t){return this.monitorRuntime.has(t)||this.pollingIntervals.has(t)}bumpMonitorGeneration(t){this.monitorGenerations.set(t,(this.monitorGenerations.get(t)??0)+1)}destroy(){this.destroyed=!0,this.monitorGenerations.clear();for(const t of Array.from(this.pollingIntervals.keys()))this.stopPolling(t);this.monitorRuntime.clear()}stopPolling(t){const o=this.pollingIntervals.get(t);void 0!==o&&(clearInterval(o),this.pollingIntervals.delete(t))}}export{u as AppointmentManagementModule};

package/dist/appointments/index.d.ts

@@ -0,0 +1,2 @@
+export { AppointmentManagementModule } from './appointment.module';
+export type { AppointmentBooking, AppointmentModule, AppointmentSlot } from './types';

package/dist/appointments/public.d.ts

@@ -0,0 +1 @@
+export type { AppointmentBooking, AppointmentModule, AppointmentSlot } from './types';

package/dist/appointments/public.js

@@ -0,0 +1 @@
+

package/dist/appointments/types.d.ts

@@ -0,0 +1,47 @@
+import { MonitorUpdate } from '../experiences/distribution-monitor.types';
+export interface AppointmentSlot {
+    id: string;
+    startTime: string;
+    endTime: string;
+    locationId?: string;
+    locationName?: string;
+    timezone?: string;
+    capacity: number;
+    available: number;
+}
+export interface AppointmentBooking {
+    bookingId: string;
+    appointmentId: string;
+    slotId: string;
+    locationId?: string;
+    locationName?: string;
+    /** Join URL for online appointments. Absent for in-person bookings. */
+    joinUrl?: string;
+    startTime: string;
+    endTime: string;
+    confirmationCode?: string;
+    consumerStatus: "booked" | "checked_in" | "completed";
+}
+export interface AppointmentModule {
+    get(appointmentId: string): Promise<import('../experiences/types').AppointmentDetails>;
+    getSlots(appointmentId: string, range: {
+        startDate: string;
+        endDate: string;
+        timezone?: string;
+    }): Promise<AppointmentSlot[]>;
+    getMe(appointmentId: string): Promise<AppointmentBooking | null>;
+    book(appointmentId: string, slotId: string, locationId?: string): Promise<AppointmentBooking>;
+    cancel(appointmentId: string, slotId: string, locationId?: string, reason?: string): Promise<void>;
+    reschedule(appointmentId: string, newSlotId: string, newLocationId?: string): Promise<AppointmentBooking>;
+    startMonitoring(id: string, context?: Record<string, unknown>, onUpdate?: (update: MonitorUpdate) => void): void;
+    stopMonitoring(id: string): void;
+    isMonitoring(id: string): boolean;
+    /**
+     * Bump the monitor generation for `id` so any in-flight polling tick fails
+     * its post-await guard. Used by the journey after non-poll writes
+     * (book, reschedule) to prevent a concurrent tick from overwriting the
+     * fresh data with stale.
+     */
+    bumpMonitorGeneration(id: string): void;
+    destroy(): void;
+}

package/dist/auctions/auction.module.d.ts

@@ -0,0 +1,58 @@
+import { HttpClient, RequestOptions } from '../core/http';
+import { MonitorUpdate } from '../experiences/distribution-monitor.types';
+import { AuctionDetails, AuctionModule, AuctionStatus, AutoRebidConfig, Bid, BidResult } from './types';
+export declare class AuctionManagementModule implements AuctionModule {
+    private readonly http;
+    private readonly logger;
+    private readonly events;
+    private readonly trackedParticipations;
+    private readonly inFlightRequests;
+    private readonly pollingIntervals;
+    private readonly lastStatusCache;
+    private readonly autoRebidConfigs;
+    private readonly monitorRuntime;
+    private readonly bidHistoryCache;
+    private readonly auctionDetailsCache;
+    private readonly monitorGenerations;
+    private readonly operationGenerations;
+    private readonly diagnosticEmissionIds;
+    private readonly BID_HISTORY_CACHE_TTL;
+    private readonly AUCTION_DETAILS_CACHE_TTL;
+    private destroyed;
+    private lifecycleGeneration;
+    private get store();
+    constructor(http: HttpClient);
+    private computeMinNextBid;
+    private getAuctionDetailsCached;
+    private getTrackedParticipation;
+    private getAuctionCloseAt;
+    private buildDisplayState;
+    private emitTransitionEvents;
+    private applyTransition;
+    private checkOutbidConditions;
+    private buildBidTransition;
+    private buildStatusTransition;
+    private buildMissingTransition;
+    get(auctionId: string): Promise<AuctionDetails>;
+    bid(auctionId: string, amount: string, options?: RequestOptions): Promise<BidResult>;
+    enter(auctionId: string, metadata?: Record<string, unknown>, options?: RequestOptions): Promise<void>;
+    leave(auctionId: string, options?: RequestOptions): Promise<void>;
+    status(auctionId: string): Promise<AuctionStatus>;
+    private doStatus;
+    getBidHistory(auctionId: string): Promise<Bid[]>;
+    private startWatching;
+    private stopWatching;
+    private stopAllWatching;
+    private bumpMonitorGeneration;
+    private getOperationGeneration;
+    private bumpOperationGeneration;
+    private canApplyAsyncResult;
+    enableAutoRebid(auctionId: string, maxBid: string, increment: string): void;
+    disableAutoRebid(auctionId: string): void;
+    getAutoRebidConfig(auctionId: string): AutoRebidConfig | undefined;
+    private handleAutoRebid;
+    startMonitoring(id: string, context?: Record<string, unknown>, onUpdate?: (update: MonitorUpdate) => void): void;
+    stopMonitoring(id: string): void;
+    isMonitoring(id: string): boolean;
+    destroy(): void;
+}

package/dist/auctions/auction.module.js

@@ -0,0 +1 @@
+import{AuctionBidderStateResponseSchema as t,AuctionHighestBidResponseSchema as i,AuctionBidHistoryResponseSchema as e}from"@fanfare-io/fanfare-sdk-contracts/auction";import{createError as n}from"../core/errors.js";import{getLogger as a}from"../core/logger.js";import{isMoneyString as s,addMoney as o,isMoneyGreaterThan as r,normalizeMoney as d,isMoneyLessThanOrEqualTo as u,subtractMoney as c}from"../core/money.js";import{parseResponse as h}from"../core/parse-response.js";import{DistributionMonitorRuntime as l}from"../experiences/distribution-monitor.runtime.js";import{getEventBus as g}from"../state/events.js";import{getSDKStore as p}from"../state/store.js";class m{constructor(t){this.logger=a(),this.events=g(),this.trackedParticipations=/* @__PURE__ */new Map,this.inFlightRequests=/* @__PURE__ */new Map,this.pollingIntervals=/* @__PURE__ */new Map,this.lastStatusCache=/* @__PURE__ */new Map,this.autoRebidConfigs=/* @__PURE__ */new Map,this.monitorRuntime=new l,this.bidHistoryCache=/* @__PURE__ */new Map,this.auctionDetailsCache=/* @__PURE__ */new Map,this.monitorGenerations=/* @__PURE__ */new Map,this.operationGenerations=/* @__PURE__ */new Map,this.diagnosticEmissionIds=/* @__PURE__ */new Set,this.BID_HISTORY_CACHE_TTL=5e3,this.AUCTION_DETAILS_CACHE_TTL=3e4,this.destroyed=!1,this.lifecycleGeneration=0,this.http=t}get store(){return p()}computeMinNextBid(t,i){if(i&&s(t)&&s(i))return o(t,i)}async getAuctionDetailsCached(t){const i=this.auctionDetailsCache.get(t);if(i&&Date.now()-i.fetchedAt<this.AUCTION_DETAILS_CACHE_TTL)return i.details;const e=await this.http.get(`/auctions/${t}`);return this.auctionDetailsCache.set(t,{details:e,fetchedAt:Date.now()}),e}getTrackedParticipation(t){return this.trackedParticipations.get(t)}getAuctionCloseAt(t){return t.closeAt??t.settleAt}buildDisplayState(t,{status:i,highestBid:e,currentBid:n,bidCount:a}){return{highestBid:e,currentBid:n,bidCount:a,closeAt:this.getAuctionCloseAt(t),status:i,currencyCode:t.currencyCode,minNextBid:e?this.computeMinNextBid(e,t.minBidIncrement):void 0,bidIncrement:t.minBidIncrement??void 0}}emitTransitionEvents(t){for(const i of t)this.events.emit(i.type,i.payload)}applyTransition(t,i){i.trackedParticipation?this.trackedParticipations.set(t,i.trackedParticipation):this.trackedParticipations.delete(t);const e=this.monitorRuntime.getDisplayAtom(t);e&&i.displayState&&e.set({type:"auction",...i.displayState}),this.emitTransitionEvents(i.events),i.diagnosticError&&!this.diagnosticEmissionIds.has(t)?(this.diagnosticEmissionIds.add(t),this.logger.error("Auction monitoring diagnostic",{auctionId:t,error:i.diagnosticError}),this.events.emit("auction:error",{auctionId:t,error:i.diagnosticError})):i.diagnosticError||this.diagnosticEmissionIds.delete(t),i.monitorUpdate&&this.monitorRuntime.notify(t,i.monitorUpdate),i.stopWatching&&this.stopWatching(t),i.autoRebidStatus&&this.handleAutoRebid(t,i.autoRebidStatus)}checkOutbidConditions(t,i,e){if("winning"===t.status&&"outbid"===i.status)return!0;if(e?.currentBid&&i.highestBid){const n=e.currentBid,a=i.highestBid,o=t.highestBid||"0";if(s(n)&&s(a)&&s(o))return r(a,o)&&r(a,n)&&"winning"!==i.status}return"outbid"!==t.status&&"outbid"===i.status}buildBidTransition(t,i,e,n,a){const s="winning"===i.status?"winning":"outbid"===i.status?"outbid":"bidding";return{trackedParticipation:{auctionId:t,enteredAt:a?.enteredAt??/* @__PURE__ */(new Date).toISOString(),status:s,currentBid:e,highestBid:i.highestBid,bidCount:i.bidCount,lastBidAt:/* @__PURE__ */(new Date).toISOString(),metadata:a?.metadata,fingerprint:a?.fingerprint},displayState:this.buildDisplayState(n,{status:i.status,highestBid:i.highestBid,currentBid:e,bidCount:i.bidCount}),events:[{type:"auction:bid-placed",payload:{auctionId:t,amount:e,status:i.status}},..."winning"===i.status?[{type:"auction:winning",payload:{auctionId:t,amount:e,highestBid:i.highestBid}}]:[],..."outbid"===i.status?[{type:"auction:outbid",payload:{auctionId:t,yourBid:e,highestBid:i.highestBid}}]:[]],monitorUpdate:null,stopWatching:!1,autoRebidStatus:null}}buildStatusTransition(t,i,e,{previousParticipation:n,previousStatus:a}){const s=i.currentBid??n?.currentBid,o=i.bidCount??n?.bidCount;if(i.timeRemaining<=0){const a="winning"===i.status;return a&&!i.admissionGrant?{trackedParticipation:{auctionId:t,enteredAt:n?.enteredAt??/* @__PURE__ */(new Date).toISOString(),status:"winning",currentBid:s,highestBid:i.highestBid,bidCount:o,metadata:n?.metadata,fingerprint:n?.fingerprint},displayState:this.buildDisplayState(e,{status:"winning",highestBid:i.highestBid,currentBid:s,bidCount:o}),events:[],monitorUpdate:null,stopWatching:!1,autoRebidStatus:null,diagnosticError:new Error("Auction resolved to terminal winning without admissionGrant")}:{trackedParticipation:null,displayState:this.buildDisplayState(e,{status:a?"won":"lost",highestBid:i.highestBid,currentBid:s,bidCount:o}),events:a?[{type:"auction:won",payload:{auctionId:t,winningBid:s??""}}]:[{type:"auction:lost",payload:{auctionId:t,highestBid:i.highestBid}}],monitorUpdate:a&&i.admissionGrant?{type:"granted",token:i.admissionGrant}:a?null:{type:"ended",outcome:{type:"lost"}},stopWatching:!0,autoRebidStatus:null}}const r={auctionId:t,enteredAt:n?.enteredAt??/* @__PURE__ */(new Date).toISOString(),status:i.status,currentBid:s,highestBid:i.highestBid,bidCount:o,metadata:n?.metadata,fingerprint:n?.fingerprint},d=[];let u=null;return a&&(this.checkOutbidConditions(a,i,n)&&(d.push({type:"auction:outbid",payload:{auctionId:t,yourBid:a.currentBid||n?.currentBid||"",highestBid:i.highestBid}}),u=i),"winning"!==a.status&&"winning"===i.status&&d.push({type:"auction:winning",payload:{auctionId:t,amount:s||"",highestBid:i.highestBid}}),a.highestBid!==i.highestBid&&"winning"!==i.status&&d.push({type:"auction:bid-updated",payload:{auctionId:t,highestBid:i.highestBid,bidCount:i.bidCount||0}})),{trackedParticipation:r,displayState:this.buildDisplayState(e,{status:i.status,highestBid:i.highestBid,currentBid:s,bidCount:o}),events:d,monitorUpdate:null,stopWatching:!1,autoRebidStatus:u}}buildMissingTransition(){return{trackedParticipation:null,displayState:{status:"lost"},events:[],monitorUpdate:{type:"ended",outcome:{type:"closed",reason:"not_participating"}},stopWatching:!0,autoRebidStatus:null}}async get(t){try{return await this.getAuctionDetailsCached(t)}catch(i){throw this.logger.error("Failed to get auction",{auctionId:t,error:i}),i}}async bid(e,a,o){try{const r=this.lifecycleGeneration;if(!s(a))throw n.validationError("Invalid bid amount format. Must be a numeric string (e.g., '100.00')");if(!this.store.session)throw n.unauthorized("Not authenticated. Call auth.guest() or auth.login() first");let u=this.bumpOperationGeneration(e),c=this.getTrackedParticipation(e);c||(this.logger.warn("Attempting to bid without entering auction first",{auctionId:e}),await this.enter(e,void 0,o),c=this.getTrackedParticipation(e),u=this.bumpOperationGeneration(e)),this.logger.info("Placing bid",{auctionId:e,amount:a});const l=`/auctions/${e}/bid`,g=`/auctions/${e}/highest-bid`,[p,m,b]=await Promise.all([this.http.post(l,{amount:a},o),this.http.get(g),this.getAuctionDetailsCached(e)]),y=h(t,p,{endpoint:l},{throwOnFailure:!0});if(!y.ok)throw y.error;const I=h(i,m,{endpoint:g},{throwOnFailure:!0});if(!I.ok)throw I.error;const f=y.value,B=I.value,w=d(B.amount),v={status:"WINNING"===f.status||"WON"===f.status?"winning":"OUTBID"===f.status||"BIDDING"===f.status||"LOST"===f.status?"outbid":"accepted",amount:a,highestBid:w,bidCount:f.bidCount??(c?.bidCount||0)+1};return this.canApplyAsyncResult(e,r,void 0,u)?(this.applyTransition(e,this.buildBidTransition(e,v,a,b,c)),v):v}catch(r){throw this.logger.error("Failed to place bid",{auctionId:e,amount:a,error:r}),this.events.emit("auction:error",{auctionId:e,error:r}),r}}async enter(t,i,e){try{const s=this.lifecycleGeneration,o=this.store.session;if(!o)throw n.unauthorized("Not authenticated. Call auth.guest() or auth.login() first");const r=this.bumpOperationGeneration(t);this.logger.info("Entering auction",{auctionId:t});try{await this.http.post(`/auctions/${t}/enter`,{metadata:i},e)}catch(a){if(404!==a?.status)throw a}if(!this.canApplyAsyncResult(t,s,void 0,r))return;this.trackedParticipations.set(t,{auctionId:t,enteredAt:/* @__PURE__ */(new Date).toISOString(),status:"watching",metadata:i,fingerprint:o.deviceFingerprint}),this.emitTransitionEvents([{type:"auction:entered",payload:{auctionId:t}}])}catch(a){throw this.logger.error("Failed to enter auction",{auctionId:t,error:a}),this.events.emit("auction:error",{auctionId:t,error:a}),a}}async leave(t,i){try{const e=this.lifecycleGeneration,n=this.bumpOperationGeneration(t);this.logger.info("Leaving auction",{auctionId:t}),this.stopMonitoring(t);try{await this.http.post(`/auctions/${t}/leave`,void 0,i)}catch{this.logger.debug("Leave endpoint not available",{auctionId:t})}if(!this.canApplyAsyncResult(t,e,void 0,n))return;this.trackedParticipations.delete(t),this.emitTransitionEvents([{type:"auction:left",payload:{auctionId:t}}])}catch(e){throw this.logger.error("Failed to leave auction",{auctionId:t,error:e}),this.events.emit("auction:error",{auctionId:t,error:e}),e}}async status(t){const i=this.inFlightRequests.get(t);if(i)return this.logger.debug("Returning existing in-flight request",{auctionId:t}),i;const e=this.lifecycleGeneration,n=this.bumpOperationGeneration(t),a=this.doStatus(t,e,void 0,n).finally(()=>{this.inFlightRequests.delete(t)});return this.inFlightRequests.set(t,a),a}async doStatus(e,n,a,s){try{const o=`/auctions/${e}/status`,r=`/auctions/${e}/highest-bid`,[u,c,l]=await Promise.all([this.http.get(o),this.http.get(r),this.getAuctionDetailsCached(e)]),g=h(t,u,{endpoint:o},{throwOnFailure:!0});if(!g.ok)throw g.error;const p=h(i,c,{endpoint:r},{throwOnFailure:!0});if(!p.ok)throw p.error;const m=g.value,b=p.value,y=this.getAuctionCloseAt(l),I=y?new Date(y).getTime():Number.NaN,f=d(b.amount),B=this.getTrackedParticipation(e),w=m.lastBidAmount??m.winningBidAmount;let v="watching";"WINNING"===m.status||"WON"===m.status?v="winning":"OUTBID"!==m.status&&"LOST"!==m.status&&"BIDDING"!==m.status||(v="outbid");const A={auctionId:e,status:v,currentBid:B?.currentBid??(w?d(w):void 0),highestBid:f,timeRemaining:Number.isFinite(I)?Math.max(0,I-Date.now()):0,bidCount:m.bidCount,admissionGrant:m.admissionGrant};if(!this.canApplyAsyncResult(e,n,a,s))return A;const C=this.buildStatusTransition(e,A,l,{previousParticipation:B,previousStatus:this.lastStatusCache.get(e)});return this.applyTransition(e,C),C.stopWatching?this.lastStatusCache.delete(e):this.lastStatusCache.set(e,A),this.events.emit("auction:status-updated",{auctionId:e,status:A}),A}catch(o){if(o&&"object"==typeof o&&"status"in o&&404===o.status){const t={auctionId:e,status:"watching",highestBid:"0.00",timeRemaining:0};if(!this.canApplyAsyncResult(e,n,a,s))return t;const i=this.buildMissingTransition();return this.applyTransition(e,i),this.lastStatusCache.delete(e),this.events.emit("auction:status-updated",{auctionId:e,status:t}),t}if(!this.canApplyAsyncResult(e,n,a,s))return this.lastStatusCache.get(e)??{auctionId:e,status:"watching",highestBid:"0.00",timeRemaining:0};throw this.logger.error("Failed to get auction status",{auctionId:e,error:o}),this.events.emit("auction:error",{auctionId:e,error:o}),o}}async getBidHistory(t){try{const i=this.bidHistoryCache.get(t);if(i&&Date.now()-i.fetchedAt<this.BID_HISTORY_CACHE_TTL)return this.logger.debug("Returning cached bid history",{auctionId:t}),i.bids;this.logger.info("Fetching bid history",{auctionId:t});const n=`/auctions/${t}/bids/history`,a=await this.http.get(n),s=h(e,a,{endpoint:n},{throwOnFailure:!0});if(!s.ok)throw s.error;const o=s.value.map(t=>({amount:d(t.amount),timestamp:t.timestamp,isWinning:t.isHighest,isYours:!0}));return this.bidHistoryCache.set(t,{bids:o,fetchedAt:Date.now()}),this.events.emit("auction:history-fetched",{auctionId:t,bidCount:o.length}),o}catch(i){throw this.logger.error("Failed to get bid history",{auctionId:t,error:i}),this.events.emit("auction:error",{auctionId:t,error:i}),i}}startWatching(t,i=5e3){this.stopWatching(t);const e=this.bumpMonitorGeneration(t);this.logger.info("Starting auction status polling",{auctionId:t,intervalMs:i});const n=this.getOperationGeneration(t);this.doStatus(t,this.lifecycleGeneration,e,n).catch(i=>{this.canApplyAsyncResult(t,this.lifecycleGeneration,e,n)&&this.logger.error("Initial status check failed",{auctionId:t,error:i})});const a=setInterval(()=>{const i=this.getOperationGeneration(t);this.doStatus(t,this.lifecycleGeneration,e,i).catch(n=>{this.canApplyAsyncResult(t,this.lifecycleGeneration,e,i)&&this.logger.error("Polling failed",{auctionId:t,error:n})})},i);this.pollingIntervals.set(t,a),this.events.emit("auction:watching-started",{auctionId:t,intervalMs:i})}stopWatching(t){this.bumpMonitorGeneration(t);const i=this.pollingIntervals.get(t);i&&(clearInterval(i),this.pollingIntervals.delete(t),this.lastStatusCache.delete(t),this.logger.info("Stopped watching auction",{auctionId:t}),this.events.emit("auction:watching-stopped",{auctionId:t}))}stopAllWatching(){for(const t of Array.from(this.pollingIntervals.keys()))this.stopWatching(t)}bumpMonitorGeneration(t){const i=(this.monitorGenerations.get(t)??0)+1;return this.monitorGenerations.set(t,i),i}getOperationGeneration(t){return this.operationGenerations.get(t)??0}bumpOperationGeneration(t){const i=this.getOperationGeneration(t)+1;return this.operationGenerations.set(t,i),i}canApplyAsyncResult(t,i,e,n){return!this.destroyed&&this.lifecycleGeneration===i&&((void 0===e||this.monitorGenerations.get(t)===e)&&(void 0===n||this.getOperationGeneration(t)===n))}enableAutoRebid(t,i,e){if(!s(i)||!s(e))throw n.validationError("Invalid monetary format. Must be numeric strings (e.g., '100.00')");if(u(i,"0")||u(e,"0"))throw n.validationError("Max bid and increment must be positive");if(r(e,i))throw n.validationError("Increment cannot be greater than max bid");const a=this.getTrackedParticipation(t);if(!a)throw n.validationError("Must enter auction before enabling auto-rebid");const o=d(a.currentBid),h=c(i,o);this.autoRebidConfigs.set(t,{enabled:!0,maxBid:i,increment:e,remainingBudget:h,rebidCount:0}),this.logger.info("Auto-rebid enabled",{auctionId:t,maxBid:i,increment:e,remainingBudget:h}),this.events.emit("auction:auto-rebid-enabled",{auctionId:t,maxBid:i,increment:e})}disableAutoRebid(t){const i=this.autoRebidConfigs.get(t);i&&(i.enabled=!1,this.logger.info("Auto-rebid disabled",{auctionId:t}),this.events.emit("auction:auto-rebid-disabled",{auctionId:t,finalRebidCount:i.rebidCount||0}))}getAutoRebidConfig(t){return this.autoRebidConfigs.get(t)}async handleAutoRebid(t,i){const e=this.autoRebidConfigs.get(t);if(e&&e.enabled)try{if(!s(i.highestBid)||!s(e.maxBid)||!s(e.increment))return void this.logger.error("Invalid auto-rebid amounts",{auctionId:t,config:e});const n=o(i.highestBid,e.increment);if(r(n,e.maxBid))return this.logger.info("Auto-rebid would exceed max bid, disabling",{auctionId:t,wouldBid:n,maxBid:e.maxBid}),this.disableAutoRebid(t),void this.events.emit("auction:auto-rebid-max-reached",{auctionId:t,maxBid:e.maxBid,wouldNeedToBid:n});this.logger.info("Placing auto-rebid",{auctionId:t,amount:n});const a=await this.bid(t,n);e.lastRebidAt=/* @__PURE__ */(new Date).toISOString(),e.rebidCount=(e.rebidCount||0)+1,e.remainingBudget=c(e.maxBid,n),this.events.emit("auction:auto-rebid-placed",{auctionId:t,amount:n,remainingBudget:e.remainingBudget,status:a.status})}catch(n){this.logger.error("Auto-rebid failed",{auctionId:t,error:n}),this.events.emit("auction:auto-rebid-failed",{auctionId:t,error:n})}}startMonitoring(t,i,e){this.monitorRuntime.start(t,i,e),this.trackedParticipations.has(t)||this.trackedParticipations.set(t,{auctionId:t,enteredAt:/* @__PURE__ */(new Date).toISOString(),status:"watching"}),this.startWatching(t)}stopMonitoring(t){this.stopWatching(t),this.monitorRuntime.stop(t)}isMonitoring(t){return this.monitorRuntime.has(t)||this.pollingIntervals.has(t)}destroy(){this.destroyed=!0,this.lifecycleGeneration+=1,this.stopAllWatching(),this.inFlightRequests.clear(),this.lastStatusCache.clear(),this.diagnosticEmissionIds.clear(),this.trackedParticipations.clear(),this.monitorGenerations.clear(),this.operationGenerations.clear(),this.bidHistoryCache.clear(),this.auctionDetailsCache.clear(),this.autoRebidConfigs.clear(),this.monitorRuntime.clear()}}export{m as AuctionManagementModule};

package/dist/auctions/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Auction module exports
+ */
+export { AuctionManagementModule } from './auction.module';
+export type { AuctionDetails, AuctionModule, AuctionParticipation, AuctionStatus, AutoRebidConfig, Bid, BidResult, } from './types';

package/dist/auctions/public.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Public auction surface. The runtime `AuctionManagementModule`/`AuctionModule`/`AuctionParticipation`
+ * symbols from `./types` are internal and not exported here.
+ */
+export type { AuctionDetails, AuctionStatus, AutoRebidConfig, Bid, BidResult } from './types';

package/dist/auctions/public.js

@@ -0,0 +1 @@
+

package/dist/auctions/types.d.ts

@@ -0,0 +1,97 @@
+import { RequestOptions } from '../core/http';
+/**
+ * Auction participation stored in state
+ */
+export interface AuctionParticipation {
+    auctionId: string;
+    enteredAt: string;
+    status: "watching" | "bidding" | "winning" | "outbid";
+    currentBid?: string;
+    highestBid?: string;
+    bidCount?: number;
+    lastBidAt?: string;
+    metadata?: Record<string, unknown>;
+    fingerprint?: string;
+}
+/**
+ * Bid details
+ */
+export interface Bid {
+    id?: string;
+    amount: string;
+    timestamp: string;
+    isWinning: boolean;
+    bidderAlias?: string;
+    isYours?: boolean;
+}
+/**
+ * Result of placing a bid
+ */
+export interface BidResult {
+    status: "winning" | "outbid" | "accepted";
+    amount: string;
+    highestBid: string;
+    bidCount: number;
+    position?: number;
+}
+/**
+ * Auction status from API
+ */
+export interface AuctionStatus {
+    auctionId: string;
+    status: "winning" | "outbid" | "watching";
+    currentBid?: string;
+    highestBid: string;
+    timeRemaining: number;
+    bidCount?: number;
+    position?: number;
+    admissionGrant?: string;
+}
+/**
+ * Auction details from API
+ */
+export interface AuctionDetails {
+    id: string;
+    /** ISO timestamp when bidding opens (if scheduled). */
+    openAt?: string | null;
+    /** ISO timestamp when bidding closes (if scheduled). */
+    closeAt?: string | null;
+    /** ISO timestamp when auction is settled. */
+    settleAt: string;
+    /** Organization-level currency code (ISO 4217). */
+    currencyCode: string;
+    /** Reserve price (monetary string), if configured. */
+    reservePrice?: string | null;
+    /** Minimum bid increment (monetary string), if configured. */
+    minBidIncrement?: string | null;
+    /** Auto-extend duration (seconds), if configured. */
+    autoExtendSeconds?: number | null;
+    /** Timezone identifier (e.g. "America/New_York"). */
+    timeZone: string;
+}
+/**
+ * Auto-rebid configuration
+ */
+export interface AutoRebidConfig {
+    enabled: boolean;
+    maxBid: string;
+    increment: string;
+    remainingBudget?: string;
+    lastRebidAt?: string;
+    rebidCount?: number;
+}
+/**
+ * Auction module interface
+ */
+export interface AuctionModule {
+    get(auctionId: string): Promise<AuctionDetails>;
+    bid(auctionId: string, amount: string, options?: RequestOptions): Promise<BidResult>;
+    enter(auctionId: string, metadata?: Record<string, unknown>, options?: RequestOptions): Promise<void>;
+    leave(auctionId: string, options?: RequestOptions): Promise<void>;
+    status(auctionId: string): Promise<AuctionStatus>;
+    getBidHistory(auctionId: string): Promise<Bid[]>;
+    enableAutoRebid(auctionId: string, maxBid: string, increment: string): void;
+    disableAutoRebid(auctionId: string): void;
+    getAutoRebidConfig(auctionId: string): AutoRebidConfig | undefined;
+    destroy(): void;
+}