@microboxlabs/miot-calendar-client 0.1.3 → 0.2.0

package/README.md

@@ -89,11 +89,12 @@ const client = createMiotCalendarClient({
 
 #### `calendars.list(params?)`
 
-List all calendars, optionally filtered by active status.
+List all calendars, optionally filtered by active status or group membership.
 
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
 | `active` | `boolean` | No | Filter by active status |
+| `groupCode` | `string` | No | Filter calendars belonging to this group code |
 
 **Returns:** `CalendarResponse[]`
 
@@ -120,6 +121,7 @@ Create a new calendar.
 | `description` | `string` | No | — | Optional description |
 | `timezone` | `string` | No | `"UTC"` | IANA timezone |
 | `active` | `boolean` | No | `true` | Whether the calendar is active |
+| `groups` | `string[]` | No | — | Group codes to assign. `null` = no change; `[]` = remove all; `["code"]` = replace all |
 
 **Returns:** `CalendarResponse`
 
@@ -130,7 +132,7 @@ Replace a calendar's fields. Takes the same body as `create`.
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
 | `id` | `string` | Yes | Calendar ID |
-| `body` | `CalendarRequest` | Yes | Updated calendar data |
+| `body` | `CalendarRequest` | Yes | Updated calendar data (include `groups` to reassign group membership) |
 
 **Returns:** `CalendarResponse`
 
@@ -192,6 +194,70 @@ Update a time window. Takes the same body as `createTimeWindow`.
 
 ---
 
+### Groups
+
+Calendar groups let you organize calendars into named collections. Calendars can belong to multiple groups; use `CalendarRequest.groups` on create or update to manage membership.
+
+#### `groups.list(params?)`
+
+List all calendar groups, optionally filtered by active status.
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `active` | `boolean` | No | Filter by active status |
+
+**Returns:** `CalendarGroupResponse[]`
+
+#### `groups.get(id)`
+
+Get a single calendar group by ID.
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `id` | `string` | Yes | Group ID |
+
+**Returns:** `CalendarGroupResponse`
+
+**Throws:** `MiotCalendarApiError` with status `404` if not found.
+
+#### `groups.create(body)`
+
+Create a new calendar group.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `code` | `string` | Yes | — | Unique code identifier (max 50 chars) |
+| `name` | `string` | Yes | — | Display name (max 255 chars) |
+| `description` | `string` | No | — | Optional description |
+| `active` | `boolean` | No | `true` | Whether the group is active |
+
+**Returns:** `CalendarGroupResponse`
+
+**Throws:** `MiotCalendarApiError` with status `400` if the code is already taken.
+
+#### `groups.update(id, body)`
+
+Replace a calendar group's fields. Takes the same body as `create`.
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `id` | `string` | Yes | Group ID |
+| `body` | `CalendarGroupRequest` | Yes | Updated group data |
+
+**Returns:** `CalendarGroupResponse`
+
+#### `groups.deactivate(id)`
+
+Deactivate a calendar group (soft delete). Calendars in the group are not affected.
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `id` | `string` | Yes | Group ID |
+
+**Returns:** `void` (HTTP 204 — no content)
+
+---
+
 ### Slots
 
 #### `slots.list(params)`
@@ -321,6 +387,31 @@ List all bookings for a specific resource.
 
 ## Types
 
+### `CalendarGroupRequest`
+
+```ts
+interface CalendarGroupRequest {
+  code: string;           // Unique code identifier (max 50 chars)
+  name: string;           // Display name (max 255 chars)
+  description?: string;   // Optional description
+  active?: boolean;       // Active status (default: true)
+}
+```
+
+### `CalendarGroupResponse`
+
+```ts
+interface CalendarGroupResponse {
+  id: string;
+  code: string;
+  name: string;
+  description?: string;
+  active: boolean;
+  createdAt: string;      // ISO 8601
+  updatedAt: string;      // ISO 8601
+}
+```
+
 ### `CalendarRequest`
 
 ```ts
@@ -330,6 +421,7 @@ interface CalendarRequest {
   description?: string;   // Optional description
   timezone?: string;      // IANA timezone (default: "UTC")
   active?: boolean;       // Active status (default: true)
+  groups?: string[];      // Group codes to assign. null = no change; [] = remove all; ["code"] = replace all
 }
 ```
 
@@ -341,10 +433,11 @@ interface CalendarResponse {
   code: string;
   name: string;
   description?: string;
-  timezone: string;       // Always present (default: "UTC")
-  active: boolean;        // Always present (default: true)
-  createdAt: string;      // ISO 8601
-  updatedAt: string;      // ISO 8601
+  timezone: string;                    // Always present (default: "UTC")
+  active: boolean;                     // Always present (default: true)
+  createdAt: string;                   // ISO 8601
+  updatedAt: string;                   // ISO 8601
+  groups?: CalendarGroupResponse[];    // Groups this calendar belongs to
 }
 ```
 

package/dist/index.d.ts

@@ -27,12 +27,28 @@ interface BookingListResponse {
     data: BookingResponse[];
     total: number;
 }
+interface CalendarGroupRequest {
+    code: string;
+    name: string;
+    description?: string;
+    active?: boolean;
+}
+interface CalendarGroupResponse {
+    id: string;
+    code: string;
+    name: string;
+    description?: string;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
 interface CalendarRequest {
     code: string;
     name: string;
     description?: string;
     timezone?: string;
     active?: boolean;
+    groups?: string[];
 }
 interface CalendarResponse {
     id: string;
@@ -43,6 +59,7 @@ interface CalendarResponse {
     active: boolean;
     createdAt: string;
     updatedAt: string;
+    groups?: CalendarGroupResponse[];
 }
 interface TimeWindowRequest {
     name: string;
@@ -130,6 +147,7 @@ declare function createMiotCalendarClient(config: ClientConfig): {
     calendars: {
         list(params?: {
             active?: boolean;
+            groupCode?: string;
         }): Promise<CalendarResponse[]>;
         get(id: string): Promise<CalendarResponse>;
         create(body: CalendarRequest): Promise<CalendarResponse>;
@@ -139,6 +157,15 @@ declare function createMiotCalendarClient(config: ClientConfig): {
         createTimeWindow(calendarId: string, body: TimeWindowRequest): Promise<TimeWindowResponse>;
         updateTimeWindow(calendarId: string, timeWindowId: string, body: TimeWindowRequest): Promise<TimeWindowResponse>;
     };
+    groups: {
+        list(params?: {
+            active?: boolean;
+        }): Promise<CalendarGroupResponse[]>;
+        get(id: string): Promise<CalendarGroupResponse>;
+        create(body: CalendarGroupRequest): Promise<CalendarGroupResponse>;
+        update(id: string, body: CalendarGroupRequest): Promise<CalendarGroupResponse>;
+        deactivate(id: string): Promise<void>;
+    };
     slots: {
         list(params: {
             calendarId: string;
@@ -159,4 +186,4 @@ declare class MiotCalendarApiError extends Error {
     constructor(status: number, body: ErrorResponse | string);
 }
 
-export { type BookingListResponse, type BookingRequest, type BookingResponse, type CalendarRequest, type CalendarResponse, type ClientConfig, type ErrorResponse, type GenerateSlotsRequest, type GenerateSlotsResponse, MiotCalendarApiError, type ResourceData, type SlotData, type SlotListResponse, type SlotResponse, type SlotStatus, type TimeWindowRequest, type TimeWindowResponse, type UpdateSlotStatusRequest, createMiotCalendarClient };
+export { type BookingListResponse, type BookingRequest, type BookingResponse, type CalendarGroupRequest, type CalendarGroupResponse, type CalendarRequest, type CalendarResponse, type ClientConfig, type ErrorResponse, type GenerateSlotsRequest, type GenerateSlotsResponse, MiotCalendarApiError, type ResourceData, type SlotData, type SlotListResponse, type SlotResponse, type SlotStatus, type TimeWindowRequest, type TimeWindowResponse, type UpdateSlotStatusRequest, createMiotCalendarClient };

package/dist/index.js

@@ -66,9 +66,9 @@ function createCalendarsApi(fetcher) {
   };
 }
 
-// src/resources/slots.ts
-var BASE3 = "/api/v1/miot-calendar/slots";
-function createSlotsApi(fetcher) {
+// src/resources/groups.ts
+var BASE3 = "/api/v1/miot-calendar/groups";
+function createGroupsApi(fetcher) {
   return {
     list(params) {
       return fetcher("GET", BASE3, { query: params });
@@ -76,11 +76,33 @@ function createSlotsApi(fetcher) {
     get(id) {
       return fetcher("GET", `${BASE3}/${id}`);
     },
+    create(body) {
+      return fetcher("POST", BASE3, { body });
+    },
+    update(id, body) {
+      return fetcher("PUT", `${BASE3}/${id}`, { body });
+    },
+    deactivate(id) {
+      return fetcher("DELETE", `${BASE3}/${id}`);
+    }
+  };
+}
+
+// src/resources/slots.ts
+var BASE4 = "/api/v1/miot-calendar/slots";
+function createSlotsApi(fetcher) {
+  return {
+    list(params) {
+      return fetcher("GET", BASE4, { query: params });
+    },
+    get(id) {
+      return fetcher("GET", `${BASE4}/${id}`);
+    },
     generate(body) {
-      return fetcher("POST", `${BASE3}/generate`, { body });
+      return fetcher("POST", `${BASE4}/generate`, { body });
     },
     updateStatus(id, body) {
-      return fetcher("PATCH", `${BASE3}/${id}/status`, { body });
+      return fetcher("PATCH", `${BASE4}/${id}/status`, { body });
     }
   };
 }
@@ -130,6 +152,7 @@ function createMiotCalendarClient(config) {
   return {
     bookings: createBookingsApi(fetcher),
     calendars: createCalendarsApi(fetcher),
+    groups: createGroupsApi(fetcher),
     slots: createSlotsApi(fetcher)
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microboxlabs/miot-calendar-client",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",