@37signals/basecamp 0.11.0 → 0.12.0

package/src/generated/services/my-assignments.ts

@@ -21,6 +21,24 @@ due_later_this_week, due_next_week, due_later */
   scope?: string;
 }
 
+/**
+ * Request parameters for prioritizeAssignment.
+ */
+export interface PrioritizeAssignmentMyAssignmentRequest {
+  /** The recording id to prioritize. */
+  id: number;
+}
+
+/**
+ * Request parameters for reorderUpNext.
+ */
+export interface ReorderUpNextMyAssignmentRequest {
+  /** The recording id to move, chosen the same way as when prioritizing. */
+  sourceId: number;
+  /** The 1-based position to move it to. */
+  position: number;
+}
+
 
 // =============================================================================
 // Service
@@ -106,4 +124,90 @@ export class MyAssignmentsService extends BaseService {
     );
     return response ?? [];
   }
+
+  /**
+   * Add a recording to Up Next — the current user's ordered list of prioritized
+   * @param req - Resource request parameters
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.myAssignments.prioritizeAssignment({ id: 1 });
+   * ```
+   */
+  async prioritizeAssignment(req: PrioritizeAssignmentMyAssignmentRequest): Promise<void> {
+    await this.request(
+      {
+        service: "MyAssignments",
+        operation: "PrioritizeAssignment",
+        resourceType: "resource",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/my/priorities.json", {
+          body: {
+            id: req.id,
+          },
+        })
+    );
+  }
+
+  /**
+   * Remove a recording from Up Next. Exact-target:
+   * @param recordingId - The recording ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.myAssignments.deprioritizeAssignment(123);
+   * ```
+   */
+  async deprioritizeAssignment(recordingId: number): Promise<void> {
+    await this.request(
+      {
+        service: "MyAssignments",
+        operation: "DeprioritizeAssignment",
+        resourceType: "resource",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.DELETE("/my/priorities/{recordingId}", {
+          params: {
+            path: { recordingId },
+          },
+        })
+    );
+  }
+
+  /**
+   * Move an already-prioritized recording to a new 1-based position in Up Next
+   * @param req - Resource request parameters
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.myAssignments.reorderUpNext({ sourceId: 1, position: 1 });
+   * ```
+   */
+  async reorderUpNext(req: ReorderUpNextMyAssignmentRequest): Promise<void> {
+    await this.request(
+      {
+        service: "MyAssignments",
+        operation: "ReorderUpNext",
+        resourceType: "resource",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/my/priority_moves.json", {
+          body: {
+            source_id: req.sourceId,
+            position: req.position,
+          },
+        })
+    );
+  }
 }

package/src/generated/services/my-notes.ts

@@ -0,0 +1,92 @@
+/**
+ * MyNotes service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+
+import { BaseService } from "../../services/base.js";
+import type { components } from "../schema.js";
+import { Errors } from "../../errors.js";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/** MyNote entity from the Basecamp API. */
+export type MyNote = components["schemas"]["MyNote"];
+
+/**
+ * Request parameters for updateMyNote.
+ */
+export interface UpdateMyNoteMyNoteRequest {
+  /** Note */
+  note: components["schemas"]["MyNoteAttributes"];
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for MyNotes operations.
+ */
+export class MyNotesService extends BaseService {
+
+  /**
+   * Get the authenticated user's note — a per-person notebook singleton at
+   * @returns The MyNote
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.myNotes.getMyNote();
+   * ```
+   */
+  async getMyNote(): Promise<MyNote> {
+    const response = await this.request(
+      {
+        service: "MyNotes",
+        operation: "GetMyNote",
+        resourceType: "my_note",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/my/notes.json", {
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Replace the note's content, recording a new revision server-side. The first
+   * @param req - My_note update parameters
+   * @returns The MyNote
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.myNotes.updateMyNote({ note: { content: "Hello world" } });
+   * ```
+   */
+  async updateMyNote(req: UpdateMyNoteMyNoteRequest): Promise<MyNote> {
+    if (!req.note) {
+      throw Errors.validation("Note is required");
+    }
+    const response = await this.request(
+      {
+        service: "MyNotes",
+        operation: "UpdateMyNote",
+        resourceType: "my_note",
+        isMutation: true,
+      },
+      () =>
+        this.client.PUT("/my/notes.json", {
+          body: {
+            note: req.note,
+          },
+        })
+    );
+    return response;
+  }
+}

package/src/generated/services/todos.ts

@@ -17,6 +17,26 @@ import { Errors } from "../../errors.js";
 /** Todo entity from the Basecamp API. */
 export type Todo = components["schemas"]["Todo"];
 
+/**
+ * Request parameters for createTodosetTodo.
+ */
+export interface CreateTodosetTodoTodoRequest {
+  /** Text content */
+  content: string;
+  /** Rich text description (HTML) */
+  description?: string;
+  /** Person IDs to assign to */
+  assigneeIds?: number[];
+  /** Person IDs to notify on completion */
+  completionSubscriberIds?: number[];
+  /** Whether to send notifications to relevant people */
+  notify?: boolean;
+  /** Due date (YYYY-MM-DD) */
+  dueOn?: string;
+  /** Start date (YYYY-MM-DD) */
+  startsOn?: string;
+}
+
 /**
  * Options for list.
  */
@@ -87,6 +107,57 @@ export interface RepositionTodoRequest {
  */
 export class TodosService extends BaseService {
 
+  /**
+   * Create a to-do directly under a project's to-do set, outside any to-do list.
+   * @param bucketId - The bucket ID
+   * @param todosetId - The todoset ID
+   * @param req - Todo creation parameters
+   * @returns The Todo
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.todos.createTodosetTodo(123, 123, { content: "Hello world" });
+   * ```
+   */
+  async createTodosetTodo(bucketId: number, todosetId: number, req: CreateTodosetTodoTodoRequest): Promise<Todo> {
+    if (!req.content) {
+      throw Errors.validation("Content is required");
+    }
+    if (req.dueOn && !/^\d{4}-\d{2}-\d{2}$/.test(req.dueOn)) {
+      throw Errors.validation("Due on must be in YYYY-MM-DD format");
+    }
+    if (req.startsOn && !/^\d{4}-\d{2}-\d{2}$/.test(req.startsOn)) {
+      throw Errors.validation("Starts on must be in YYYY-MM-DD format");
+    }
+    const response = await this.request(
+      {
+        service: "Todos",
+        operation: "CreateTodosetTodo",
+        resourceType: "todo",
+        isMutation: true,
+        projectId: bucketId,
+        resourceId: todosetId,
+      },
+      () =>
+        this.client.POST("/buckets/{bucketId}/todosets/{todosetId}/todos.json", {
+          params: {
+            path: { bucketId, todosetId },
+          },
+          body: {
+            content: req.content,
+            description: req.description,
+            assignee_ids: req.assigneeIds,
+            completion_subscriber_ids: req.completionSubscriberIds,
+            notify: req.notify,
+            due_on: req.dueOn,
+            starts_on: req.startsOn,
+          },
+        })
+    );
+    return response;
+  }
+
   /**
    * List todos in a todolist
    * @param todolistId - The todolist ID