@cosmoops/connect-sdk 0.17.0 → 0.19.0

package/dist/types/server/resources/scheduling.d.ts

@@ -1,13 +1,45 @@
 import { type TransportOptions } from "../http.js";
-import type { BookableEventType, Booking, BookingAttendee, BookingSlots, BookingStatus, ListBookingsPage } from "../../types.js";
-export interface FindSlotsInput {
+import type { BookableEventType, Booking, RescheduledBooking, BookingAttendee, BookingSlots, BookingStatus, ListBookingsPage } from "../../types.js";
+/**
+ * Present on every method here.
+ *
+ * With `asUser`, Connect derives the workspace from **that member's session**
+ * and ignores `workspaceId`, then checks their own `calendar:read` /
+ * `calendar:manage`. Without it the call is your server acting for a workspace
+ * you name, gated only on your application being installed there. The bridge
+ * always sends it - a browser must never be trusted to name a tenant, and an
+ * end user of your app is not automatically allowed to book on their
+ * employer's calendar.
+ */
+export interface ActingAsOption {
+    /** The signed-in member's opaque Connect session token. */
+    asUser?: string;
+}
+export interface FindSlotsInput extends ActingAsOption {
     workspaceId: string;
     eventTypeId: string;
     /** ISO-8601 instant, or a `Date`. */
     from: string | Date;
     to: string | Date;
+    /**
+     * A booking to treat as if it were not there - **set this when offering
+     * times to move an existing appointment to.**
+     *
+     * Without it the appointment counts as blocking its own replacement, so the
+     * adjustment people actually make - same day, half an hour later - comes
+     * back with nothing available.
+     */
+    excludeBookingId?: string;
 }
-export interface ListBookingsInput {
+export interface RescheduleBookingInput extends ActingAsOption {
+    workspaceId: string;
+    bookingId: string;
+    /** The new time, from a `findSlots` result, passed back unchanged. */
+    startAt: string | Date;
+    /** Replaces the original note when given; it carries over otherwise. */
+    notes?: string | null;
+}
+export interface ListBookingsInput extends ActingAsOption {
     workspaceId: string;
     status?: BookingStatus;
     /** A Connect workspace member id - only bookings that committed them. */
@@ -19,7 +51,7 @@ export interface ListBookingsInput {
     cursor?: string;
     limit?: number;
 }
-export interface CreateBookingInput {
+export interface CreateBookingInput extends ActingAsOption {
     workspaceId: string;
     eventTypeId: string;
     /**
@@ -50,7 +82,7 @@ export declare class SchedulingResource {
     private readonly transport;
     constructor(transport: TransportOptions);
     /** What this workspace offers as bookable. Active appointment types only. */
-    listEventTypes(workspaceId: string): Promise<BookableEventType[]>;
+    listEventTypes(workspaceId: string, options?: ActingAsOption): Promise<BookableEventType[]>;
     /**
      * Free times for one appointment type over one window.
      *
@@ -76,6 +108,19 @@ export declare class SchedulingResource {
      * a `ConnectError` with `code: "conflict"` rather than double-booking.
      */
     createBooking(input: CreateBookingInput): Promise<Booking>;
+    /**
+     * Moves an appointment to a different time.
+     *
+     * **The original is retired, not edited.** It stays on the diary as
+     * `rescheduled` with `rescheduledToId` pointing at the replacement, and both
+     * come back here - so a booking id you cached still resolves, and still says
+     * where the appointment went.
+     *
+     * A refused move changes nothing: the new slot is claimed before the old one
+     * is released, so a `conflict` leaves the customer with the appointment they
+     * already had. Re-read the slots (with `excludeBookingId`) and offer another.
+     */
+    rescheduleBooking(input: RescheduleBookingInput): Promise<RescheduledBooking>;
     /**
      * Frees the slot and records why.
      *
@@ -83,7 +128,7 @@ export declare class SchedulingResource {
      * reason, which is what makes a late cancellation something anyone can look
      * up afterwards.
      */
-    cancelBooking(input: {
+    cancelBooking(input: ActingAsOption & {
         workspaceId: string;
         bookingId: string;
         reason?: string | null;

package/dist/types/types.d.ts

@@ -1202,8 +1202,21 @@ export interface Booking {
     notes: string | null;
     source: BookingSource;
     cancelledReason: string | null;
+    /**
+     * Set when `status` is `rescheduled` - the booking that replaced this one.
+     *
+     * Rescheduling retires a booking rather than moving its `startAt`, so an id
+     * you cached still resolves and still tells you where the appointment went.
+     */
+    rescheduledToId: string | null;
     createdAt: string;
 }
+export interface RescheduledBooking {
+    /** The new appointment. This is the live one. */
+    booking: Booking;
+    /** The retired original, now `rescheduled` and pointing at `booking`. */
+    previous: Booking;
+}
 export interface ListBookingsPage {
     bookings: Booking[];
     /** Pass back as `cursor`. A cursor belongs to one set of filters. */
@@ -1211,3 +1224,48 @@ export interface ListBookingsPage {
     hasMore: boolean;
     totalCount: number;
 }
+/**
+ * A phone or email on a contact.
+ *
+ * `verified` means a human confirmed it reaches them - only a manual source
+ * may ever set it. Branch on it: an unverified value is one an extraction
+ * heard on a call and nobody has checked since.
+ */
+export interface ContactChannelValue {
+    value: string;
+    label: string | null;
+    verified: boolean;
+}
+/**
+ * How a contact came to exist. `call` means a voice agent created it from an
+ * inbound call; `manual` and `import` are the two a human stands behind.
+ */
+export type ContactSource = "call" | "manual" | "import" | "api" | "extraction";
+/**
+ * Someone a workspace knows how to reach - **the telephony identity**, not a
+ * CRM record. See `ContactsResource` for why the difference decides whether
+ * you reference this or copy it.
+ */
+export interface ConnectContact {
+    id: string;
+    /** E.164, and immutable - the key this contact is identified by. */
+    primaryPhone: string;
+    phones: ContactChannelValue[];
+    emails: ContactChannelValue[];
+    name: {
+        display: string | null;
+        given: string | null;
+        family: string | null;
+    };
+    business: {
+        company: string | null;
+        role: string | null;
+        gstin: string | null;
+        website: string | null;
+        address: string | null;
+    };
+    tags: string[];
+    source: ContactSource;
+    createdAt: string;
+    updatedAt: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmoops/connect-sdk",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Official server-side SDK for the CosmoOps Connect platform API - Login with Connect, entitlements, billing and metering.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "commonjs",