@mesadev/sdk 0.2.2 → 0.3.1

package/src/funcs/webhooksList.ts

@@ -1,214 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v4-mini";
-import { MesaCore } from "../core.js";
-import { 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";
-
-/**
- * List webhooks
- *
- * @remarks
- * List webhooks for a repository
- */
-export function webhooksList(
-  client: MesaCore,
-  request: operations.GetByOrgByRepoWebhooksRequest,
-  options?: RequestOptions,
-): APIPromise<
-  Result<
-    operations.GetByOrgByRepoWebhooksResponse,
-    | errors.GetByOrgByRepoWebhooksBadRequestError
-    | errors.GetByOrgByRepoWebhooksUnauthorizedError
-    | errors.GetByOrgByRepoWebhooksForbiddenError
-    | errors.GetByOrgByRepoWebhooksNotFoundError
-    | errors.GetByOrgByRepoWebhooksNotAcceptableError
-    | errors.GetByOrgByRepoWebhooksConflictError
-    | errors.GetByOrgByRepoWebhooksInternalServerError
-    | MesaError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
-  >
-> {
-  return new APIPromise($do(
-    client,
-    request,
-    options,
-  ));
-}
-
-async function $do(
-  client: MesaCore,
-  request: operations.GetByOrgByRepoWebhooksRequest,
-  options?: RequestOptions,
-): Promise<
-  [
-    Result<
-      operations.GetByOrgByRepoWebhooksResponse,
-      | errors.GetByOrgByRepoWebhooksBadRequestError
-      | errors.GetByOrgByRepoWebhooksUnauthorizedError
-      | errors.GetByOrgByRepoWebhooksForbiddenError
-      | errors.GetByOrgByRepoWebhooksNotFoundError
-      | errors.GetByOrgByRepoWebhooksNotAcceptableError
-      | errors.GetByOrgByRepoWebhooksConflictError
-      | errors.GetByOrgByRepoWebhooksInternalServerError
-      | MesaError
-      | ResponseValidationError
-      | ConnectionError
-      | RequestAbortedError
-      | RequestTimeoutError
-      | InvalidRequestError
-      | UnexpectedClientError
-      | SDKValidationError
-    >,
-    APICall,
-  ]
-> {
-  const parsed = safeParse(
-    request,
-    (value) =>
-      z.parse(operations.GetByOrgByRepoWebhooksRequest$outboundSchema, value),
-    "Input validation failed",
-  );
-  if (!parsed.ok) {
-    return [parsed, { status: "invalid" }];
-  }
-  const payload = parsed.value;
-  const body = null;
-
-  const pathParams = {
-    org: encodeSimple("org", payload.org, {
-      explode: false,
-      charEncoding: "percent",
-    }),
-    repo: encodeSimple("repo", payload.repo, {
-      explode: false,
-      charEncoding: "percent",
-    }),
-  };
-
-  const path = pathToFunc("/{org}/{repo}/webhooks")(pathParams);
-
-  const headers = new Headers(compactMap({
-    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: "getByOrgByRepoWebhooks",
-    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: "GET",
-    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.GetByOrgByRepoWebhooksResponse,
-    | errors.GetByOrgByRepoWebhooksBadRequestError
-    | errors.GetByOrgByRepoWebhooksUnauthorizedError
-    | errors.GetByOrgByRepoWebhooksForbiddenError
-    | errors.GetByOrgByRepoWebhooksNotFoundError
-    | errors.GetByOrgByRepoWebhooksNotAcceptableError
-    | errors.GetByOrgByRepoWebhooksConflictError
-    | errors.GetByOrgByRepoWebhooksInternalServerError
-    | MesaError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
-  >(
-    M.json(200, operations.GetByOrgByRepoWebhooksResponse$inboundSchema),
-    M.jsonErr(400, errors.GetByOrgByRepoWebhooksBadRequestError$inboundSchema),
-    M.jsonErr(
-      401,
-      errors.GetByOrgByRepoWebhooksUnauthorizedError$inboundSchema,
-    ),
-    M.jsonErr(403, errors.GetByOrgByRepoWebhooksForbiddenError$inboundSchema),
-    M.jsonErr(404, errors.GetByOrgByRepoWebhooksNotFoundError$inboundSchema),
-    M.jsonErr(
-      406,
-      errors.GetByOrgByRepoWebhooksNotAcceptableError$inboundSchema,
-    ),
-    M.jsonErr(409, errors.GetByOrgByRepoWebhooksConflictError$inboundSchema),
-    M.jsonErr(
-      500,
-      errors.GetByOrgByRepoWebhooksInternalServerError$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/helpers/index.ts

@@ -1,8 +0,0 @@
-/**
- * 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

@@ -1,410 +0,0 @@
-/**
- * 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;
-}