@mesadev/sdk 0.1.7 → 0.2.2

package/src/funcs/mergePerform.ts

@@ -0,0 +1,234 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { MesaCore } 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 {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { MesaError } from "../models/errors/mesaerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Merge branches
+ *
+ * @remarks
+ * Merge a head branch into a base branch. Performs a fast-forward merge when possible, otherwise creates a merge commit. Returns 409 if there are merge conflicts.
+ */
+export function mergePerform(
+  client: MesaCore,
+  request: operations.PostByOrgByRepoMergeByBaseRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.PostByOrgByRepoMergeByBaseResponse,
+    | errors.PostByOrgByRepoMergeByBaseBadRequestError
+    | errors.PostByOrgByRepoMergeByBaseUnauthorizedError
+    | errors.PostByOrgByRepoMergeByBaseForbiddenError
+    | errors.PostByOrgByRepoMergeByBaseNotFoundError
+    | errors.PostByOrgByRepoMergeByBaseNotAcceptableError
+    | errors.PostByOrgByRepoMergeByBaseConflictError
+    | errors.PostByOrgByRepoMergeByBaseInternalServerError
+    | MesaError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MesaCore,
+  request: operations.PostByOrgByRepoMergeByBaseRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.PostByOrgByRepoMergeByBaseResponse,
+      | errors.PostByOrgByRepoMergeByBaseBadRequestError
+      | errors.PostByOrgByRepoMergeByBaseUnauthorizedError
+      | errors.PostByOrgByRepoMergeByBaseForbiddenError
+      | errors.PostByOrgByRepoMergeByBaseNotFoundError
+      | errors.PostByOrgByRepoMergeByBaseNotAcceptableError
+      | errors.PostByOrgByRepoMergeByBaseConflictError
+      | errors.PostByOrgByRepoMergeByBaseInternalServerError
+      | MesaError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      z.parse(
+        operations.PostByOrgByRepoMergeByBaseRequest$outboundSchema,
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.body, { explode: true });
+
+  const pathParams = {
+    base: encodeSimple("base", payload.base, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    org: encodeSimple("org", payload.org, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    repo: encodeSimple("repo", payload.repo, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/{org}/{repo}/merge/{base}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "postByOrgByRepoMergeByBase",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    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: ["400", "401", "403", "404", "406", "409", "4XX", "500", "5XX"],
+    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<
+    operations.PostByOrgByRepoMergeByBaseResponse,
+    | errors.PostByOrgByRepoMergeByBaseBadRequestError
+    | errors.PostByOrgByRepoMergeByBaseUnauthorizedError
+    | errors.PostByOrgByRepoMergeByBaseForbiddenError
+    | errors.PostByOrgByRepoMergeByBaseNotFoundError
+    | errors.PostByOrgByRepoMergeByBaseNotAcceptableError
+    | errors.PostByOrgByRepoMergeByBaseConflictError
+    | errors.PostByOrgByRepoMergeByBaseInternalServerError
+    | MesaError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.PostByOrgByRepoMergeByBaseResponse$inboundSchema),
+    M.jsonErr(
+      400,
+      errors.PostByOrgByRepoMergeByBaseBadRequestError$inboundSchema,
+    ),
+    M.jsonErr(
+      401,
+      errors.PostByOrgByRepoMergeByBaseUnauthorizedError$inboundSchema,
+    ),
+    M.jsonErr(
+      403,
+      errors.PostByOrgByRepoMergeByBaseForbiddenError$inboundSchema,
+    ),
+    M.jsonErr(
+      404,
+      errors.PostByOrgByRepoMergeByBaseNotFoundError$inboundSchema,
+    ),
+    M.jsonErr(
+      406,
+      errors.PostByOrgByRepoMergeByBaseNotAcceptableError$inboundSchema,
+    ),
+    M.jsonErr(
+      409,
+      errors.PostByOrgByRepoMergeByBaseConflictError$inboundSchema,
+    ),
+    M.jsonErr(
+      500,
+      errors.PostByOrgByRepoMergeByBaseInternalServerError$inboundSchema,
+    ),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/reposGet.ts

@@ -186,6 +186,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, operations.GetByOrgByRepoResponse$inboundSchema),
+    M.json(202, operations.GetByOrgByRepoResponse$inboundSchema),
     M.jsonErr(400, errors.GetByOrgByRepoBadRequestError$inboundSchema),
     M.jsonErr(401, errors.GetByOrgByRepoUnauthorizedError$inboundSchema),
     M.jsonErr(403, errors.GetByOrgByRepoForbiddenError$inboundSchema),

package/src/helpers/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Helper utilities for common SDK operations.
+ *
+ * These helpers provide convenient high-level functions that combine
+ * multiple SDK operations into single calls.
+ */
+
+export * from './lfs.js';

package/src/helpers/lfs.ts

@@ -0,0 +1,410 @@
+/**
+ * LFS (Large File Storage) helpers for uploading large files.
+ *
+ * These helpers provide a convenient way to upload large files to a repository
+ * using Git LFS, without needing to clone the repository.
+ *
+ * @example
+ * ```typescript
+ * import { Mesa } from '@mesadev/sdk';
+ * import { uploadLargeFiles } from '@mesadev/sdk/helpers/lfs';
+ *
+ * const mesa = new Mesa({ apiKey: 'your-api-key' });
+ *
+ * const result = await uploadLargeFiles(mesa, {
+ *   org: 'my-org',
+ *   repo: 'my-repo',
+ *   branch: 'main',
+ *   message: 'Add large model file',
+ *   author: { name: 'Bot', email: 'bot@example.com' },
+ *   files: [{ path: 'models/model.bin', content: fileBuffer }]
+ * });
+ *
+ * console.log('Created commit:', result.sha);
+ * ```
+ */
+
+import { MesaCore } from '../core.js';
+import { encodeJSON, encodeSimple } from '../lib/encodings.js';
+import { compactMap } from '../lib/primitives.js';
+import { RequestOptions } from '../lib/sdks.js';
+import { extractSecurity, resolveGlobalSecurity } from '../lib/security.js';
+import { pathToFunc } from '../lib/url.js';
+
+/** Input for a large file to upload via LFS */
+export interface LargeFileInput {
+  /** File path in the repository (e.g., 'models/large-model.bin') */
+  path: string;
+  /** File content as ArrayBuffer, Uint8Array, or Blob */
+  content: ArrayBuffer | Uint8Array | Blob;
+}
+
+/** Options for uploading large files */
+export interface UploadLargeFilesOptions {
+  /** Organization slug */
+  org: string;
+  /** Repository name */
+  repo: string;
+  /** Target branch name */
+  branch: string;
+  /** Commit message */
+  message: string;
+  /** Commit author */
+  author: {
+    name: string;
+    email: string;
+    date?: string | undefined;
+  };
+  /** Large files to upload */
+  files: LargeFileInput[];
+  /** Optional base SHA for optimistic locking */
+  baseSha?: string | undefined;
+}
+
+/** Result of uploading large files */
+export interface UploadLargeFilesResult {
+  /** The commit SHA */
+  sha: string;
+  /** The branch name */
+  branch: string;
+  /** The commit message */
+  message: string;
+}
+
+/** Response from LFS upload endpoint */
+interface LfsUploadResponse {
+  objects: Array<{
+    oid: string;
+    size: number;
+    upload_url?: string;
+    expires_in?: number;
+    exists: boolean;
+    error?: { code: string; message: string };
+  }>;
+}
+
+/**
+ * Compute SHA-256 hash of content.
+ * Uses Web Crypto API which is available in browsers and Node.js 18+.
+ */
+async function computeSha256(data: ArrayBuffer): Promise<string> {
+  const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+
+/**
+ * Convert various input types to ArrayBuffer
+ */
+async function toArrayBuffer(content: ArrayBuffer | Uint8Array | Blob): Promise<ArrayBuffer> {
+  if (content instanceof Blob) {
+    return content.arrayBuffer();
+  }
+  if (content instanceof Uint8Array) {
+    // Create a new ArrayBuffer copy to ensure we have a proper ArrayBuffer (not SharedArrayBuffer)
+    const copy = new ArrayBuffer(content.byteLength);
+    new Uint8Array(copy).set(content);
+    return copy;
+  }
+  return content;
+}
+
+/**
+ * Upload large files to a repository using LFS.
+ *
+ * This convenience method:
+ * 1. Computes SHA-256 of each file
+ * 2. Requests pre-signed upload URLs from the LFS endpoint
+ * 3. Uploads file content directly to S3
+ * 4. Creates a commit with LFS pointer references
+ *
+ * @param client - The Mesa SDK client instance
+ * @param options - Upload configuration
+ * @param requestOptions - Optional request configuration (timeout, retries, etc.)
+ * @returns The created commit details
+ *
+ * @example
+ * ```typescript
+ * import { Mesa } from '@mesadev/sdk';
+ * import { uploadLargeFiles } from '@mesadev/sdk/helpers/lfs';
+ * import { readFile } from 'fs/promises';
+ *
+ * const mesa = new Mesa({ apiKey: process.env.MESA_API_KEY });
+ * const fileContent = await readFile('./large-model.bin');
+ *
+ * const result = await uploadLargeFiles(mesa, {
+ *   org: 'my-org',
+ *   repo: 'my-repo',
+ *   branch: 'main',
+ *   message: 'Add ML model',
+ *   author: { name: 'Deploy Bot', email: 'deploy@example.com' },
+ *   files: [
+ *     { path: 'models/classifier.bin', content: fileContent }
+ *   ]
+ * });
+ *
+ * console.log(`Created commit: ${result.sha}`);
+ * ```
+ */
+export async function uploadLargeFiles(
+  client: MesaCore,
+  options: UploadLargeFilesOptions,
+  requestOptions?: RequestOptions
+): Promise<UploadLargeFilesResult> {
+  const { org, repo, branch, message, author, files, baseSha } = options;
+
+  // 1. Prepare files: compute SHA-256 and convert to ArrayBuffer
+  const preparedFiles: Array<{
+    path: string;
+    oid: string;
+    size: number;
+    content: ArrayBuffer;
+  }> = [];
+
+  for (const file of files) {
+    const content = await toArrayBuffer(file.content);
+    const oid = await computeSha256(content);
+    preparedFiles.push({
+      path: file.path,
+      oid,
+      size: content.byteLength,
+      content,
+    });
+  }
+
+  // 2. Request upload URLs from LFS endpoint
+  const lfsResponse = await requestLfsUpload(client, org, repo, preparedFiles, requestOptions);
+
+  // 3. Upload files that need uploading
+  for (const obj of lfsResponse.objects) {
+    if (obj.error) {
+      throw new Error(`LFS upload failed for ${obj.oid}: ${obj.error.message}`);
+    }
+
+    if (obj.upload_url) {
+      const file = preparedFiles.find((f) => f.oid === obj.oid);
+      if (!file) continue;
+
+      const uploadResponse = await fetch(obj.upload_url, {
+        method: 'PUT',
+        body: file.content,
+        headers: {
+          'Content-Length': String(file.size),
+        },
+      });
+
+      if (!uploadResponse.ok) {
+        throw new Error(`Failed to upload ${file.path} to S3: ${uploadResponse.status} ${uploadResponse.statusText}`);
+      }
+    }
+  }
+
+  // 4. Create commit with LFS pointers
+  // Note: The SDK needs to be regenerated to include LFS file types.
+  // For now, we make the request directly with the correct shape.
+  const commitResponse = await requestCommitWithLfs(
+    client,
+    org,
+    repo,
+    {
+      branch,
+      message,
+      author,
+      base_sha: baseSha,
+      files: preparedFiles.map((f) => ({
+        path: f.path,
+        lfs: { oid: f.oid, size: f.size },
+      })),
+    },
+    requestOptions
+  );
+
+  return {
+    sha: commitResponse.sha,
+    branch: commitResponse.branch,
+    message: commitResponse.message,
+  };
+}
+
+/**
+ * Make LFS upload request to get pre-signed URLs
+ */
+async function requestLfsUpload(
+  client: MesaCore,
+  org: string,
+  repo: string,
+  files: Array<{ oid: string; size: number }>,
+  options?: RequestOptions
+): Promise<LfsUploadResponse> {
+  const body = encodeJSON(
+    'body',
+    {
+      objects: files.map((f) => ({ oid: f.oid, size: f.size })),
+    },
+    { explode: true }
+  );
+
+  const pathParams = {
+    org: encodeSimple('org', org, { explode: false, charEncoding: 'percent' }),
+    repo: encodeSimple('repo', repo, { explode: false, charEncoding: 'percent' }),
+  };
+
+  const path = pathToFunc('/{org}/{repo}/lfs/objects')(pathParams);
+
+  const headers = new Headers(
+    compactMap({
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+    })
+  );
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? '',
+    operationID: 'lfsUpload',
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries || client._options.retryConfig || { strategy: 'none' as const },
+    retryCodes: options?.retryCodes || ['429', '500', '502', '503', '504'],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: 'POST',
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  });
+
+  if (!requestRes.ok) {
+    throw new Error('Failed to create LFS upload request');
+  }
+
+  const req = requestRes.value;
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ['400', '401', '403', '404', '4XX', '500', '5XX'],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+
+  if (!doResult.ok) {
+    throw new Error(`LFS upload request failed: ${doResult.error}`);
+  }
+
+  const response = doResult.value;
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`LFS upload failed: ${response.status} ${errorText}`);
+  }
+
+  return (await response.json()) as LfsUploadResponse;
+}
+
+/** Request body for creating a commit with LFS files */
+interface CommitWithLfsRequest {
+  branch: string;
+  message: string;
+  author: {
+    name: string;
+    email: string;
+    date?: string | undefined;
+  };
+  base_sha?: string | undefined;
+  files: Array<{
+    path: string;
+    lfs: { oid: string; size: number };
+  }>;
+}
+
+/** Response from create commit endpoint */
+interface CommitResponse {
+  sha: string;
+  branch: string;
+  message: string;
+}
+
+/**
+ * Make commit request with LFS file references
+ */
+async function requestCommitWithLfs(
+  client: MesaCore,
+  org: string,
+  repo: string,
+  commitData: CommitWithLfsRequest,
+  options?: RequestOptions
+): Promise<CommitResponse> {
+  const body = encodeJSON('body', commitData, { explode: true });
+
+  const pathParams = {
+    org: encodeSimple('org', org, { explode: false, charEncoding: 'percent' }),
+    repo: encodeSimple('repo', repo, { explode: false, charEncoding: 'percent' }),
+  };
+
+  const path = pathToFunc('/{org}/{repo}/commits')(pathParams);
+
+  const headers = new Headers(
+    compactMap({
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+    })
+  );
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? '',
+    operationID: 'commitsCreate',
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries || client._options.retryConfig || { strategy: 'none' as const },
+    retryCodes: options?.retryCodes || ['429', '500', '502', '503', '504'],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: 'POST',
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  });
+
+  if (!requestRes.ok) {
+    throw new Error('Failed to create commit request');
+  }
+
+  const req = requestRes.value;
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ['400', '401', '403', '404', '406', '409', '4XX', '500', '5XX'],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+
+  if (!doResult.ok) {
+    throw new Error(`Commit request failed: ${doResult.error}`);
+  }
+
+  const response = doResult.value;
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Commit failed: ${response.status} ${errorText}`);
+  }
+
+  return (await response.json()) as CommitResponse;
+}

package/src/lib/config.ts

@@ -58,7 +58,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.1.7",
-  genVersion: "2.801.2",
-  userAgent: "speakeasy-sdk/typescript 0.1.7 2.801.2 1.0.0 @mesadev/sdk",
+  sdkVersion: "0.2.2",
+  genVersion: "2.821.4",
+  userAgent: "speakeasy-sdk/typescript 0.2.2 2.821.4 1.0.0 @mesadev/sdk",
 } as const;

package/src/models/errors/index.ts

@@ -27,6 +27,9 @@ export * from "./postbyorgapikeys.js";
 export * from "./postbyorgbyrepoanalyticsrefresh.js";
 export * from "./postbyorgbyrepobranches.js";
 export * from "./postbyorgbyrepocommits.js";
+export * from "./postbyorgbyrepolfsobjects.js";
+export * from "./postbyorgbyrepolfsobjectsdownload.js";
+export * from "./postbyorgbyrepomergebybase.js";
 export * from "./postbyorgbyreposync.js";
 export * from "./postbyorgbyrepowebhooks.js";
 export * from "./postbyorgrepos.js";