@mesadev/sdk 0.1.6 → 0.2.1

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.6",
-  genVersion: "2.801.2",
-  userAgent: "speakeasy-sdk/typescript 0.1.6 2.801.2 1.0.0 @mesadev/sdk",
+  sdkVersion: "0.2.1",
+  genVersion: "2.818.4",
+  userAgent: "speakeasy-sdk/typescript 0.2.1 2.818.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";