@steuerboard/mcp 0.1.0 → 0.2.0

package/src/funcs/adminUsersUpdateAccountantUser.ts

@@ -0,0 +1,180 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SteuerboardCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  UpdateAccountantUserRequest,
+  UpdateAccountantUserRequest$zodSchema,
+  UpdateAccountantUserResponse,
+  UpdateAccountantUserResponse$zodSchema,
+} from "../models/updateaccountantuserop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Update an accountant user
+ *
+ * @remarks
+ * Updates an accountant user by ID.
+ */
+export function adminUsersUpdateAccountantUser(
+  client$: SteuerboardCore,
+  request: UpdateAccountantUserRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    UpdateAccountantUserResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: SteuerboardCore,
+  request: UpdateAccountantUserRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      UpdateAccountantUserResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => UpdateAccountantUserRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$.UpdateAccountantUser, {
+    explode: true,
+  });
+
+  const pathParams$ = {
+    id: encodeSimple("id", payload$.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/admin/users/{id}")(
+    pathParams$,
+  );
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "updateAccountantUser",
+    oAuth2Scopes: [],
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "PATCH",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  const response = doResult.value;
+  const responseFields$ = {
+    HttpMeta: { Response: response, Request: req$ },
+  };
+
+  const [result$] = await M.match<
+    UpdateAccountantUserResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, UpdateAccountantUserResponse$zodSchema, {
+      key: "AccountantUser",
+    }),
+    M.json(401, UpdateAccountantUserResponse$zodSchema, { key: "auth_error" }),
+    M.json(403, UpdateAccountantUserResponse$zodSchema, { key: "object" }),
+    M.json(404, UpdateAccountantUserResponse$zodSchema, { key: "not_found" }),
+    M.json(422, UpdateAccountantUserResponse$zodSchema, { key: "oneOf" }),
+    M.json(429, UpdateAccountantUserResponse$zodSchema, { key: "rate_limit" }),
+    M.nil(500, UpdateAccountantUserResponse$zodSchema),
+  )(response, req$, { extraFields: responseFields$ });
+
+  return [result$, { status: "complete", request: req$, response }];
+}

package/src/funcs/authMe.ts

@@ -23,6 +23,9 @@ import { Result } from "../types/fp.js";
 
 /**
  * Me
+ *
+ * @remarks
+ * Returns information about the authenticated principal.
  */
 export function authMe(
   client$: SteuerboardCore,
@@ -63,7 +66,7 @@ async function $do(
     APICall,
   ]
 > {
-  const path$ = pathToFunc("/v1/me")();
+  const path$ = pathToFunc("/me")();
 
   const headers$ = new Headers(compactMap({
     Accept: "application/json",
@@ -129,9 +132,13 @@ async function $do(
     | RequestTimeoutError
     | ConnectionError
   >(
-    M.json(200, MeResponse$zodSchema, { key: "200_application/json_object" }),
+    M.json(200, MeResponse$zodSchema, {
+      key: "twoHundredApplicationJsonObject",
+    }),
     M.json(401, MeResponse$zodSchema, { key: "auth_error" }),
-    M.json(403, MeResponse$zodSchema, { key: "403_application/json_object" }),
+    M.json(403, MeResponse$zodSchema, {
+      key: "fourHundredAndThreeApplicationJsonObject",
+    }),
     M.json(429, MeResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, MeResponse$zodSchema),
   )(response, req$, { extraFields: responseFields$ });

package/src/funcs/filesCreateFile.ts

@@ -127,7 +127,7 @@ async function $do(
   if (payload$.FileCreate.taskId !== undefined) {
     appendForm(body$, "taskId", payload$.FileCreate.taskId);
   }
-  const path$ = pathToFunc("/v1/files")();
+  const path$ = pathToFunc("/files")();
 
   const headers$ = new Headers(compactMap({
     Accept: "application/json",
@@ -198,17 +198,17 @@ async function $do(
     | RequestTimeoutError
     | ConnectionError
   >(
-    M.json(201, CreateFileResponse$zodSchema, { key: "File" }),
+    M.json(201, CreateFileResponse$zodSchema, { key: "FileT" }),
     M.json(400, CreateFileResponse$zodSchema, { key: "bad_request" }),
     M.json(401, CreateFileResponse$zodSchema, { key: "auth_error" }),
     M.json(403, CreateFileResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(413, CreateFileResponse$zodSchema, {
-      key: "413_application/json_object",
+      key: "fourHundredAndThirteenApplicationJsonObject",
     }),
     M.json(422, CreateFileResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, CreateFileResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, CreateFileResponse$zodSchema),

package/src/funcs/filesDeleteFile.ts

@@ -93,7 +93,7 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path$ = pathToFunc("/v1/files/{id}")(
+  const path$ = pathToFunc("/files/{id}")(
     pathParams$,
   );
 
@@ -170,11 +170,11 @@ async function $do(
     M.json(400, DeleteFileResponse$zodSchema, { key: "bad_request" }),
     M.json(401, DeleteFileResponse$zodSchema, { key: "auth_error" }),
     M.json(403, DeleteFileResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(404, DeleteFileResponse$zodSchema, { key: "not_found" }),
     M.json(422, DeleteFileResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, DeleteFileResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, DeleteFileResponse$zodSchema),

package/src/funcs/filesGetFile.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * Get a file
  *
  * @remarks
- * Returns a single file object by ID.
+ * Returns a single file by ID.
  */
 export function filesGetFile(
   client$: SteuerboardCore,
@@ -93,7 +93,7 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path$ = pathToFunc("/v1/files/{id}")(
+  const path$ = pathToFunc("/files/{id}")(
     pathParams$,
   );
 
@@ -166,17 +166,17 @@ async function $do(
     | RequestTimeoutError
     | ConnectionError
   >(
-    M.json(200, GetFileResponse$zodSchema, { key: "File" }),
+    M.json(200, GetFileResponse$zodSchema, { key: "FileT" }),
     M.json(400, GetFileResponse$zodSchema, { key: "bad_request" }),
     M.json(401, GetFileResponse$zodSchema, { key: "auth_error" }),
     M.json(403, GetFileResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(404, GetFileResponse$zodSchema, {
-      key: "404_application/json_object",
+      key: "fourHundredAndFourApplicationJsonObject",
     }),
     M.json(422, GetFileResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, GetFileResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, GetFileResponse$zodSchema),

package/src/funcs/filesListFiles.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * List files
  *
  * @remarks
- * Returns a paginated list of files. Optionally you can filter by workspace.
+ * Returns a paginated list of files with optional workspace filters.
  */
 export function filesListFiles(
   client$: SteuerboardCore,
@@ -86,7 +86,7 @@ async function $do(
   }
   const payload$ = parsed$.value;
   const body$ = null;
-  const path$ = pathToFunc("/v1/files")();
+  const path$ = pathToFunc("/files")();
   const query$ = encodeFormQuery({
     "cursor": payload$.cursor,
     "limit": payload$.limit,
@@ -167,10 +167,10 @@ async function $do(
     M.json(400, ListFilesResponse$zodSchema, { key: "bad_request" }),
     M.json(401, ListFilesResponse$zodSchema, { key: "auth_error" }),
     M.json(403, ListFilesResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(422, ListFilesResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, ListFilesResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, ListFilesResponse$zodSchema),

package/src/funcs/filesUpdateFile.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * Update a file
  *
  * @remarks
- * Updates a file object.
+ * Updates a file by ID.
  */
 export function filesUpdateFile(
   client$: SteuerboardCore,
@@ -93,7 +93,7 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path$ = pathToFunc("/v1/files/{id}")(
+  const path$ = pathToFunc("/files/{id}")(
     pathParams$,
   );
 
@@ -167,17 +167,17 @@ async function $do(
     | RequestTimeoutError
     | ConnectionError
   >(
-    M.json(200, UpdateFileResponse$zodSchema, { key: "File" }),
+    M.json(200, UpdateFileResponse$zodSchema, { key: "FileT" }),
     M.json(400, UpdateFileResponse$zodSchema, { key: "bad_request" }),
     M.json(401, UpdateFileResponse$zodSchema, { key: "auth_error" }),
     M.json(403, UpdateFileResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(404, UpdateFileResponse$zodSchema, {
-      key: "404_application/json_object",
+      key: "fourHundredAndFourApplicationJsonObject",
     }),
     M.json(422, UpdateFileResponse$zodSchema, {
-      key: "422_application/json_oneOf",
+      key: "fourHundredAndTwentyTwoApplicationJsonOneOf",
     }),
     M.json(429, UpdateFileResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, UpdateFileResponse$zodSchema),

package/src/funcs/healthIndex.ts

@@ -21,7 +21,10 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Index
+ * Get API index
+ *
+ * @remarks
+ * Returns API information.
  */
 export function healthIndex(
   client$: SteuerboardCore,
@@ -62,7 +65,7 @@ async function $do(
     APICall,
   ]
 > {
-  const path$ = pathToFunc("/v1")();
+  const path$ = pathToFunc("/")();
 
   const headers$ = new Headers(compactMap({
     Accept: "application/json",

package/src/funcs/healthPing.ts

@@ -22,6 +22,9 @@ import { Result } from "../types/fp.js";
 
 /**
  * Ping Pong
+ *
+ * @remarks
+ * Returns a pong response for health checks.
  */
 export function healthPing(
   client$: SteuerboardCore,
@@ -62,7 +65,7 @@ async function $do(
     APICall,
   ]
 > {
-  const path$ = pathToFunc("/v1/ping")();
+  const path$ = pathToFunc("/ping")();
 
   const headers$ = new Headers(compactMap({
     Accept: "application/json",

package/src/funcs/tasksCreateTask.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * Create a task
  *
  * @remarks
- * Creates a new task and returns the created task object.
+ * Creates a new task and returns the created task.
  */
 export function tasksCreateTask(
   client$: SteuerboardCore,
@@ -86,7 +86,7 @@ async function $do(
   }
   const payload$ = parsed$.value;
   const body$ = encodeJSON("body", payload$.TaskCreate, { explode: true });
-  const path$ = pathToFunc("/v1/tasks")();
+  const path$ = pathToFunc("/tasks")();
 
   const headers$ = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -162,10 +162,10 @@ async function $do(
     M.json(400, CreateTaskResponse$zodSchema, { key: "bad_request" }),
     M.json(401, CreateTaskResponse$zodSchema, { key: "auth_error" }),
     M.json(403, CreateTaskResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(422, CreateTaskResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, CreateTaskResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, CreateTaskResponse$zodSchema),

package/src/funcs/tasksDeleteTask.ts

@@ -93,7 +93,7 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path$ = pathToFunc("/v1/tasks/{id}")(
+  const path$ = pathToFunc("/tasks/{id}")(
     pathParams$,
   );
 
@@ -170,11 +170,11 @@ async function $do(
     M.json(400, DeleteTaskResponse$zodSchema, { key: "bad_request" }),
     M.json(401, DeleteTaskResponse$zodSchema, { key: "auth_error" }),
     M.json(403, DeleteTaskResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(404, DeleteTaskResponse$zodSchema, { key: "not_found" }),
     M.json(422, DeleteTaskResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, DeleteTaskResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, DeleteTaskResponse$zodSchema),

package/src/funcs/tasksGetTask.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * Get a task
  *
  * @remarks
- * Returns a single task object by ID.
+ * Returns a single task by ID.
  */
 export function tasksGetTask(
   client$: SteuerboardCore,
@@ -93,7 +93,7 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path$ = pathToFunc("/v1/tasks/{id}")(
+  const path$ = pathToFunc("/tasks/{id}")(
     pathParams$,
   );
 
@@ -170,11 +170,11 @@ async function $do(
     M.json(400, GetTaskResponse$zodSchema, { key: "bad_request" }),
     M.json(401, GetTaskResponse$zodSchema, { key: "auth_error" }),
     M.json(403, GetTaskResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(404, GetTaskResponse$zodSchema, { key: "not_found" }),
     M.json(422, GetTaskResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, GetTaskResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, GetTaskResponse$zodSchema),

package/src/funcs/tasksListTasks.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * List tasks
  *
  * @remarks
- * Returns a paginated list of tasks. Optionally you can filter by client or workspace.
+ * Returns a paginated list of tasks with optional client and workspace filters.
  */
 export function tasksListTasks(
   client$: SteuerboardCore,
@@ -86,11 +86,12 @@ async function $do(
   }
   const payload$ = parsed$.value;
   const body$ = null;
-  const path$ = pathToFunc("/v1/tasks")();
+  const path$ = pathToFunc("/tasks")();
   const query$ = encodeFormQuery({
     "cursor": payload$.cursor,
     "limit": payload$.limit,
     "order": payload$.order,
+    "parentId": payload$.parentId,
     "sort": payload$.sort,
     "workspaceId": payload$.workspaceId,
   });
@@ -169,10 +170,10 @@ async function $do(
     M.json(400, ListTasksResponse$zodSchema, { key: "bad_request" }),
     M.json(401, ListTasksResponse$zodSchema, { key: "auth_error" }),
     M.json(403, ListTasksResponse$zodSchema, {
-      key: "403_application/json_object",
+      key: "fourHundredAndThreeApplicationJsonObject",
     }),
     M.json(422, ListTasksResponse$zodSchema, {
-      key: "422_application/json_object",
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
     }),
     M.json(429, ListTasksResponse$zodSchema, { key: "rate_limit" }),
     M.nil(500, ListTasksResponse$zodSchema),

package/src/funcs/tasksUpdateTask.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * Update a task
  *
  * @remarks
- * Updates an existing task object.
+ * Updates a task by ID.
  */
 export function tasksUpdateTask(
   client$: SteuerboardCore,
@@ -93,7 +93,7 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path$ = pathToFunc("/v1/tasks/{id}")(
+  const path$ = pathToFunc("/tasks/{id}")(
     pathParams$,
   );