@cosmoops/connect-sdk 0.37.0 → 0.40.0

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

@@ -1,5 +1,5 @@
 import { type TransportOptions } from "../http.js";
-import type { BookableEventType, Booking, RescheduledBooking, BookingAttendee, BookingSlots, BookingStatus, ListBookingsPage } from "../../types.js";
+import type { AvailabilitySchedule, BookableEventType, Booking, ManageableEventType, RescheduledBooking, BookingAttendee, BookingSlots, BookingStatus, ListBookingsPage, WeeklyHours } from "../../types.js";
 /**
  * Present on every method here.
  *
@@ -56,6 +56,84 @@ export interface ListBookingsInput extends ActingAsOption {
     cursor?: string;
     limit?: number;
 }
+export interface ListSchedulesInput extends ActingAsOption {
+    workspaceId: string;
+}
+/**
+ * What `createSchedule` takes - deliberately narrower than Connect's own
+ * Calendar settings form: no date overrides, and never owned by one person.
+ * Anything beyond this is a Console edit, not a second write path to
+ * maintain.
+ */
+export interface CreateScheduleInput extends ActingAsOption {
+    workspaceId: string;
+    name: string;
+    /** Validated against the IANA database server-side, e.g. `"Asia/Kolkata"`. */
+    timezone: string;
+    weeklyHours: WeeklyHours;
+}
+/**
+ * What `createEventType` takes.
+ *
+ * Host is a specific member, never a team - there is no groups read in this
+ * API, so a round-robin team host stays a Console-only capability, reachable
+ * by following "Manage in Connect".
+ */
+export interface CreateEventTypeInput extends ActingAsOption {
+    workspaceId: string;
+    name: string;
+    description?: string | null;
+    /** 5 to 480 minutes. */
+    durationMinutes: number;
+    /** Dead time reserved either side of the meeting. Both default to 5. */
+    bufferBeforeMinutes?: number;
+    bufferAfterMinutes?: number;
+    /** A `ConnectWorkspaceMember.memberId` - see `Booking.hostMemberIds`. */
+    hostMemberId: string;
+    scheduleId: string;
+    location: {
+        kind: "phone" | "address" | "link";
+        value?: string | null;
+    };
+    /** Off by default - most appointment types are booked by your integration or a member, not the public. */
+    publicBookingEnabled?: boolean;
+}
+/**
+ * What `updateSchedule` takes. Every field optional - send only what changed.
+ * `ownerMemberId` and date overrides are not settable from this surface at
+ * all, so an edit can never touch them.
+ */
+export interface UpdateScheduleInput extends ActingAsOption {
+    workspaceId: string;
+    scheduleId: string;
+    name?: string;
+    timezone?: string;
+    weeklyHours?: WeeklyHours;
+}
+/**
+ * What `updateEventType` takes. Every field optional - send only what
+ * changed. `hostMemberId` omitted leaves the host untouched, including a
+ * *group* host this surface cannot represent; sending one always rewrites to
+ * a member host, by design.
+ */
+export interface UpdateEventTypeInput extends ActingAsOption {
+    workspaceId: string;
+    eventTypeId: string;
+    name?: string;
+    description?: string | null;
+    durationMinutes?: number;
+    bufferBeforeMinutes?: number;
+    bufferAfterMinutes?: number;
+    hostMemberId?: string;
+    scheduleId?: string;
+    location?: {
+        kind: "phone" | "address" | "link";
+        value?: string | null;
+    };
+    publicBookingEnabled?: boolean;
+    /** Take an appointment type out of (or back into) service. */
+    active?: boolean;
+}
 export interface CreateBookingInput extends ActingAsOption {
     workspaceId: string;
     eventTypeId: string;
@@ -88,6 +166,58 @@ export declare class SchedulingResource {
     constructor(transport: TransportOptions);
     /** What this workspace offers as bookable. Active appointment types only. */
     listEventTypes(workspaceId: string, options?: ActingAsOption): Promise<BookableEventType[]>;
+    /**
+     * The working-hours templates an appointment type can point at.
+     *
+     * Read this before offering to create one - a workspace that already has
+     * hours set does not need a second "Working hours" from your integration.
+     */
+    listSchedules(workspaceId: string, options?: ActingAsOption): Promise<AvailabilitySchedule[]>;
+    /**
+     * Gives a workspace its first working hours.
+     *
+     * Narrower than what the workspace's own Calendar settings can do - no date
+     * overrides, and never owned by one person (`ownerMemberId` stays `null`
+     * server-side). Anything beyond that is a Console edit, not a second write
+     * path for your integration to maintain.
+     */
+    createSchedule(input: CreateScheduleInput): Promise<AvailabilitySchedule>;
+    /**
+     * The first thing a workspace can be booked for.
+     *
+     * Needs a schedule - create or pick one with `listSchedules`/`createSchedule`
+     * first. The slug for a future public booking link is derived from `name`
+     * server-side; you cannot choose one.
+     *
+     * Answers the richer *manageable* shape, not `BookableEventType` - you just
+     * created this row and are about to manage it, not book against it.
+     */
+    createEventType(input: CreateEventTypeInput): Promise<ManageableEventType>;
+    /**
+     * The richer read `createEventType`/`updateEventType`'s edit mode needs -
+     * everything `listEventTypes`'s booking catalogue deliberately withholds,
+     * because this is the opposite audience: a member managing their own
+     * calendar, not a widget rendering someone else's. Includes inactive rows,
+     * since an edit screen is exactly where one gets reactivated.
+     */
+    listManageableEventTypes(workspaceId: string, options?: ActingAsOption): Promise<ManageableEventType[]>;
+    /**
+     * Edits an existing availability schedule.
+     *
+     * Narrower than what the workspace's own Calendar settings can do, the
+     * same way `createSchedule` is: `ownerMemberId` and date overrides stay
+     * untouched, since this surface never sets either.
+     */
+    updateSchedule(input: UpdateScheduleInput): Promise<AvailabilitySchedule>;
+    /**
+     * Edits an existing appointment type.
+     *
+     * `hostMemberId` omitted leaves the host untouched, including a *group*
+     * host this surface cannot represent - so an edit that says nothing about
+     * the host can never accidentally overwrite a team assignment made in
+     * Connect.
+     */
+    updateEventType(input: UpdateEventTypeInput): Promise<ManageableEventType>;
     /**
      * Free times for one appointment type over one window.
      *

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

@@ -11,6 +11,10 @@ import type { ConnectInvitation, ConnectMemberAccess, ConnectMemberAccessResult,
  * `createConnectHandler`, and it is why a partner cannot enumerate another
  * tenant's team with their own API key.
  */
+export interface CreateUserWorkspaceInput {
+    name: string;
+    type: "individual" | "business";
+}
 export declare class WorkspacesResource {
     private readonly transport;
     constructor(transport: TransportOptions);
@@ -24,6 +28,30 @@ export declare class WorkspacesResource {
     list(options: {
         asUser: string;
     }): Promise<UserWorkspace[]>;
+    /**
+     * Opens another workspace under the tenant the signed-in user already
+     * owns - a branch office, a second business unit.
+     *
+     * Every guard `CreateWorkspaceUseCase` enforces still applies: only the
+     * tenant's owner may call this, `type: "business"` still needs a non-free
+     * email domain, and the tenant's plan still decides whether it may hold
+     * another workspace at all - a `PreconditionError` surfaces as a thrown
+     * `ConnectError` with a message written to be shown ("Your current plan
+     * covers a single workspace...", "You've used all 3 of the workspaces
+     * your plans include..."). There is no `tenantId` parameter: the caller
+     * names no tenant, same as every other method on this resource names no
+     * workspace.
+     *
+     * `isActive`/`subscribed` on the result are always `false` - this does not
+     * switch the session, and the new workspace has no subscription yet. Chain
+     * `switch({workspaceId: result.workspaceId})` to move into it, but only
+     * when `result.inAudience` - a workspace outside this application's
+     * audience is refused by `switch` the same way `selectable()` in
+     * `<ConnectWorkspaceSwitcher>` already treats it.
+     */
+    create(input: CreateUserWorkspaceInput, options: {
+        asUser: string;
+    }): Promise<UserWorkspace>;
     /**
      * Moves this session to another workspace, returning a **new session
      * token**. The one you passed is revoked.

package/dist/types/types.d.ts

@@ -2003,6 +2003,66 @@ export interface ListBookingsPage {
     hasMore: boolean;
     totalCount: number;
 }
+/**
+ * One interval within a day, in minutes since midnight - `540` is 9am.
+ */
+export interface WeeklyInterval {
+    startMinute: number;
+    endMinute: number;
+}
+/**
+ * A week of working hours, one entry per weekday - `0` is Sunday. An empty
+ * array means closed that day; every key is required, so "closed on Sunday"
+ * is an array the caller had to mean rather than a key they forgot.
+ */
+export interface WeeklyHours {
+    0: WeeklyInterval[];
+    1: WeeklyInterval[];
+    2: WeeklyInterval[];
+    3: WeeklyInterval[];
+    4: WeeklyInterval[];
+    5: WeeklyInterval[];
+    6: WeeklyInterval[];
+}
+/** A working-hours template an appointment type points at. */
+export interface AvailabilitySchedule {
+    id: string;
+    name: string;
+    timezone: string;
+    weeklyHours: WeeklyHours;
+}
+/**
+ * One appointment type, as a management UI sees it - richer than
+ * `BookableEventType`'s booking-catalogue shape, which deliberately
+ * withholds `location.value` and everything else here. Fetched from
+ * `listManageableEventTypes`, never the booking flow's `listEventTypes`.
+ *
+ * `host` collapses a group host to `{kind:"group"}` with nothing else -
+ * there is no groups read in this API, so a team host is representable only
+ * as "not this, edit it in Connect".
+ */
+export interface ManageableEventType {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    durationMinutes: number;
+    bufferBeforeMinutes: number;
+    bufferAfterMinutes: number;
+    host: {
+        kind: "member";
+        memberId: string;
+    } | {
+        kind: "group";
+    };
+    scheduleId: string;
+    location: {
+        kind: "phone" | "address" | "link";
+        value: string | null;
+    };
+    active: boolean;
+    publicBookingEnabled: boolean;
+}
 /**
  * A phone or email on a contact.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmoops/connect-sdk",
-  "version": "0.37.0",
+  "version": "0.40.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",