@myapihq/sdk 2.4.0 → 2.4.2

package/src/funnel.ts

@@ -1,203 +0,0 @@
-import { request, MyApiError } from './client';
-import { ApiResponse } from './types';
-import { FUNNEL_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-export const EXPOSES: Exposes = [
-  'POST /funnel/orgs/{org_id}/funnels',
-  'GET /funnel/orgs/{org_id}/funnels',
-  'GET /funnel/orgs/{org_id}/funnels/{funnel_id}',
-  'DELETE /funnel/orgs/{org_id}/funnels/{funnel_id}',
-  'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/push-page',
-  'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/verify',
-  'GET /funnel/orgs/{org_id}/funnels/{funnel_id}/pages',
-  'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/files',
-  // Backend (2026-06-03): canonical funnel-form proxy lands per-slug
-  // bindings — destination (webhook/workflow), fields, honeypot, rate
-  // limit. See docs/cross-repo-prompts/cli-funnel-form-canonical-followup-2026-06-04.md.
-  'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/forms',
-  'GET /funnel/orgs/{org_id}/funnels/{funnel_id}/forms',
-  'DELETE /funnel/orgs/{org_id}/funnels/{funnel_id}/forms/{slug}',
-];
-
-export interface Funnel {
-  id: string;
-  org_id: string;
-  // Backend (2026-05-15): POST /funnels now accepts optional `name`. Defaults
-  // to the org's preview_subdomain for back-compat. Get / list responses
-  // include it when set.
-  name?: string;
-  // Backend (2026-06-03): every funnel auto-provisions a webhook_endpoints
-  // row at create. Submissions to `/submit/{slug}` without a per-slug
-  // binding fall through to this webhook. Optional only because legacy
-  // funnels migrated by the boot job may be briefly null.
-  org_webhook_id?: string;
-  created_at: string;
-  updated_at: string;
-}
-
-// Per-slug binding from `POST /funnel/.../forms`. Backend resolves a
-// submission's destination at submit time: per-slug binding wins, then
-// `Funnel.org_webhook_id`, else `NO_DESTINATION`.
-export interface FormFieldSpec {
-  name: string;
-  required?: boolean;
-  oneof?: string[];
-  max_length?: number;
-  regex?: string;
-}
-export interface FormBinding {
-  slug: string;
-  // "<kind>:<uuid>" — kind is "webhook" or "workflow".
-  destination: string;
-  fields?: FormFieldSpec[];
-  honeypot_field?: string;
-  rate_limit?: { per_minute: number };
-}
-export interface CreateFunnelResponse { funnel: Funnel; subdomain_url?: string; domain_url?: string }
-// Same envelope shape on read — kept as its own name so call sites read
-// honestly. Wire shape is `{funnel: {...}, subdomain_url?, domain_url?}`.
-export interface GetFunnelResponse { funnel: Funnel; subdomain_url?: string; domain_url?: string }
-export interface VerifyResult {
-  pages?: Array<{ slug: string; tests: VerifyTest[] }>;
-  tests?: VerifyTest[];
-}
-export interface VerifyTest { type: 'link' | 'image' | 'webhook'; url: string; passed: boolean; details: string }
-
-export async function createFunnel(apiKey: string, orgId: string, opts?: { name?: string }): Promise<CreateFunnelResponse> {
-  // v2: accept optional name for N-funnels-per-org. Backend rejects names
-  // matching the reserved-suffix rules; agent should pre-validate.
-  return request('POST', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels`, apiKey, opts?.name ? { name: opts.name } : {});
-}
-export async function getFunnel(apiKey: string, orgId: string, funnelId: string): Promise<GetFunnelResponse> {
-  // Backend has wrapped GET responses since 2026-04 (`{funnel, subdomain_url, domain_url}`).
-  // Older builds returned a flat Funnel — normalize to the envelope so
-  // callers can rely on the typed shape.
-  const raw = await request<GetFunnelResponse | Funnel>(
-    'GET',
-    `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}`,
-    apiKey,
-  );
-  if (raw && typeof raw === 'object' && 'funnel' in raw && (raw as GetFunnelResponse).funnel) {
-    return raw as GetFunnelResponse;
-  }
-  return { funnel: raw as Funnel };
-}
-export async function listFunnels(apiKey: string, orgId: string): Promise<Funnel[]> {
-  return request('GET', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels`, apiKey);
-}
-export async function deleteFunnel(apiKey: string, orgId: string, funnelId: string): Promise<void> {
-  return request('DELETE', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}`, apiKey);
-}
-
-export async function pushFunnelPage(apiKey: string, orgId: string, funnelId: string, payload: { slug: string; html: string }): Promise<{ url: string }> {
-  return request('POST', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/push-page`, apiKey, payload);
-}
-
-export interface FunnelPage {
-  slug: string;
-  url?: string;
-  published_at?: string;
-  updated_at?: string;
-  // Backend may include other fields; we type the common ones and let the
-  // rest pass through for printJson() / printTable() consumers.
-  [key: string]: unknown;
-}
-
-export async function listFunnelPages(apiKey: string, orgId: string, funnelId: string): Promise<FunnelPage[]> {
-  // Backend returns `{ pages: [...] }` for this endpoint (every other list
-  // endpoint returns a flat array). Unwrap so the SDK's contract matches the
-  // rest — callers expect an array.
-  const res = await request<{ pages?: FunnelPage[] } | FunnelPage[]>(
-    'GET',
-    `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/pages`,
-    apiKey,
-  );
-  if (Array.isArray(res)) return res;
-  return res?.pages ?? [];
-}
-export async function verifyFunnel(apiKey: string, orgId: string, funnelId: string, opts?: { html?: string; slug?: string }): Promise<VerifyResult> {
-  return request('POST', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/verify`, apiKey, opts || {});
-}
-
-// One file in a directory publish: `path` is the path within the site
-// (e.g. "index.html", "assets/app.js"); the backend roots it ("/index.html").
-export interface PublishFile {
-  path: string;
-  content: Blob | Buffer | string;
-}
-
-export interface PublishOptions {
-  // 'dev' or 'prod' channel — defaults to 'prod' server-side.
-  env?: 'dev' | 'prod';
-  // Force SPA fallback. Auto-true server-side when an index.html is present.
-  spaMode?: boolean;
-  // Bind /api/* on the funnel to a deployed function.
-  apiFunctionId?: string;
-}
-
-export interface PublishResult {
-  manifest_id: string;
-  channel: 'dev' | 'prod';
-  file_count: number;
-  size_bytes: number;
-  spa_mode: boolean;
-  published_url: string;
-}
-
-// publishFiles is the my-funnel-api v2 directory publish. Every file is a
-// multipart part named `files`; the part's filename carries the site path.
-// 25MB total cap server-side.
-export async function publishFiles(
-  apiKey: string,
-  orgId: string,
-  funnelId: string,
-  files: PublishFile[],
-  opts: PublishOptions = {},
-): Promise<PublishResult> {
-  const formData = new FormData();
-  for (const f of files) {
-    formData.append('files', new Blob([f.content as any]), f.path);
-  }
-  if (opts.env) formData.append('env', opts.env);
-  if (opts.spaMode !== undefined) formData.append('spa_mode', String(opts.spaMode));
-  if (opts.apiFunctionId) formData.append('api_function_id', opts.apiFunctionId);
-
-  const response = await fetch(
-    `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/files`,
-    { method: 'POST', headers: { Authorization: `Bearer ${apiKey}` }, body: formData as any },
-  );
-
-  let result: any;
-  try {
-    result = await response.json();
-  } catch {
-    throw new MyApiError('invalid_json_response', response.status);
-  }
-  if (!response.ok || !result?.success) {
-    const err = result?.error;
-    const code = typeof err === 'object' ? (err?.code || 'unknown_error') : (err || 'unknown_error');
-    const detail = typeof err === 'object' ? err?.message : undefined;
-    throw new MyApiError(code, response.status, detail, typeof err === 'object' ? err : undefined);
-  }
-  return (result as ApiResponse<PublishResult>).data as PublishResult;
-}
-
-// ── Form bindings (canonical funnel-form proxy) ────────────────────────────
-
-function formsBase(orgId: string, funnelId: string): string {
-  return `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/forms`;
-}
-
-export async function createFormBinding(apiKey: string, orgId: string, funnelId: string, binding: FormBinding): Promise<FormBinding> {
-  return request('POST', formsBase(orgId, funnelId), apiKey, binding);
-}
-
-export async function listFormBindings(apiKey: string, orgId: string, funnelId: string): Promise<FormBinding[]> {
-  const res = await request<FormBinding[] | { forms?: FormBinding[] }>('GET', formsBase(orgId, funnelId), apiKey);
-  return Array.isArray(res) ? res : (res?.forms ?? []);
-}
-
-export async function deleteFormBinding(apiKey: string, orgId: string, funnelId: string, slug: string): Promise<void> {
-  return request('DELETE', `${formsBase(orgId, funnelId)}/${encodeURIComponent(slug)}`, apiKey);
-}

package/src/git.ts

@@ -1,171 +0,0 @@
-import { request } from './client';
-import { GIT_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-// Backend: my-git-api per myapi-hq/internal/routes/git/. A stateless
-// git-over-HTTP surface — repositories, refs, commits, and history served
-// by a go-git engine (objects in GCS packfiles, refs in Postgres).
-export const EXPOSES: Exposes = [
-  'POST /git/orgs/{org_id}/repos',
-  'GET /git/orgs/{org_id}/repos',
-  'GET /git/orgs/{org_id}/repos/{repo}',
-  'DELETE /git/orgs/{org_id}/repos/{repo}',
-  'GET /git/orgs/{org_id}/repos/{repo}/refs',
-  'GET /git/orgs/{org_id}/repos/{repo}/tree/{ref}',
-  'GET /git/orgs/{org_id}/repos/{repo}/blob/{ref}/{path}',
-  'GET /git/orgs/{org_id}/repos/{repo}/commits',
-  'GET /git/orgs/{org_id}/repos/{repo}/commits/{sha}',
-  'GET /git/orgs/{org_id}/repos/{repo}/diff',
-  'POST /git/orgs/{org_id}/repos/{repo}/commits',
-  'POST /git/orgs/{org_id}/repos/{repo}/branches',
-  'DELETE /git/orgs/{org_id}/repos/{repo}/branches/{branch}',
-  'POST /git/orgs/{org_id}/repos/{repo}/tags',
-  'POST /git/orgs/{org_id}/repos/{repo}/merges',
-  'POST /git/orgs/{org_id}/repos/{repo}/repack',
-];
-
-export interface RepoSummary { name: string }
-export interface Repo {
-  name: string;
-  default_branch: string;
-  branches: number;
-  tags: number;
-}
-export interface RefInfo { name: string; sha: string }
-export interface Refs {
-  head: string;            // symbolic HEAD target, e.g. "refs/heads/main"
-  branches: RefInfo[];
-  tags: RefInfo[];
-}
-export interface TreeEntry {
-  name: string;
-  path: string;
-  type: 'file' | 'dir';
-  mode: string;
-  sha: string;
-  size: number;
-}
-export interface CommitInfo {
-  sha: string;
-  message: string;
-  author: string;
-  email: string;
-  when: string;
-  parents: string[];
-}
-export interface CommitResult { sha: string; tree: string; branch: string }
-export interface RepackResult { packs_before: number; packs_after: number; objects: number }
-export interface Blob { path: string; size: number; content_base64: string }
-
-// One file edit in an atomic commit. Either `content` (UTF-8 text) or
-// `content_base64` (binary); set `delete` to remove the path instead.
-export interface FileChange {
-  path: string;
-  content?: string;
-  content_base64?: string;
-  delete?: boolean;
-  mode?: string;            // "100644" (default), "100755" (exec), "120000" (symlink)
-}
-export interface CommitPayload {
-  branch: string;                          // required — short name or full ref
-  base?: string;                           // expected branch tip; "" => branch must not exist
-  message: string;
-  author?: { name: string; email: string };
-  changes: FileChange[];
-}
-
-function repoBase(orgId: string, repo: string): string {
-  return `${BASE_URL}/git/orgs/${encodeURIComponent(orgId)}/repos/${encodeURIComponent(repo)}`;
-}
-
-// ── Repos ────────────────────────────────────────────────────────────────────
-
-export async function createRepo(apiKey: string, orgId: string, name: string, defaultBranch?: string): Promise<{ name: string; default_branch: string }> {
-  const body: Record<string, string> = { name };
-  if (defaultBranch) body.default_branch = defaultBranch;
-  return request('POST', `${BASE_URL}/git/orgs/${encodeURIComponent(orgId)}/repos`, apiKey, body);
-}
-
-export async function listRepos(apiKey: string, orgId: string): Promise<RepoSummary[]> {
-  const res = await request<{ repos?: RepoSummary[] }>('GET', `${BASE_URL}/git/orgs/${encodeURIComponent(orgId)}/repos`, apiKey);
-  return res?.repos ?? [];
-}
-
-export async function getRepo(apiKey: string, orgId: string, repo: string): Promise<Repo> {
-  return request('GET', repoBase(orgId, repo), apiKey);
-}
-
-export async function deleteRepo(apiKey: string, orgId: string, repo: string): Promise<void> {
-  return request('DELETE', repoBase(orgId, repo), apiKey);
-}
-
-// ── Refs / history ───────────────────────────────────────────────────────────
-
-export async function listRefs(apiKey: string, orgId: string, repo: string): Promise<Refs> {
-  return request('GET', `${repoBase(orgId, repo)}/refs`, apiKey);
-}
-
-// listCommits walks history from `ref` (default HEAD); `limit` is 1-500.
-export async function listCommits(apiKey: string, orgId: string, repo: string, opts: { ref?: string; limit?: number } = {}): Promise<CommitInfo[]> {
-  const q = new URLSearchParams();
-  if (opts.ref) q.set('ref', opts.ref);
-  if (opts.limit !== undefined) q.set('limit', String(opts.limit));
-  const qs = q.toString();
-  const res = await request<{ commits?: CommitInfo[] }>('GET', `${repoBase(orgId, repo)}/commits${qs ? `?${qs}` : ''}`, apiKey);
-  return res?.commits ?? [];
-}
-
-export async function getCommit(apiKey: string, orgId: string, repo: string, sha: string): Promise<CommitInfo> {
-  return request('GET', `${repoBase(orgId, repo)}/commits/${encodeURIComponent(sha)}`, apiKey);
-}
-
-// getDiff returns the unified diff text between two refs.
-export async function getDiff(apiKey: string, orgId: string, repo: string, base: string, head: string): Promise<string> {
-  const q = new URLSearchParams({ base, head });
-  const res = await request<{ diff?: string }>('GET', `${repoBase(orgId, repo)}/diff?${q}`, apiKey);
-  return res?.diff ?? '';
-}
-
-// listTree lists a ref's tree; `path` scopes it to a subdirectory.
-export async function listTree(apiKey: string, orgId: string, repo: string, ref: string, path?: string): Promise<TreeEntry[]> {
-  const qs = path ? `?path=${encodeURIComponent(path)}` : '';
-  const res = await request<{ entries?: TreeEntry[] }>('GET', `${repoBase(orgId, repo)}/tree/${encodeURIComponent(ref)}${qs}`, apiKey);
-  return res?.entries ?? [];
-}
-
-// readBlob returns a file's content (base64-encoded — safe for binary).
-export async function readBlob(apiKey: string, orgId: string, repo: string, ref: string, path: string): Promise<Blob> {
-  // The backend route is /blob/{ref}/{path...} — a catch-all — so slashes
-  // in the path must survive; encode each segment, not the separators.
-  const encPath = path.split('/').map(encodeURIComponent).join('/');
-  return request('GET', `${repoBase(orgId, repo)}/blob/${encodeURIComponent(ref)}/${encPath}`, apiKey);
-}
-
-// ── Writes ───────────────────────────────────────────────────────────────────
-
-// commit applies all `changes` atomically onto `branch`.
-export async function commit(apiKey: string, orgId: string, repo: string, payload: CommitPayload): Promise<CommitResult> {
-  return request('POST', `${repoBase(orgId, repo)}/commits`, apiKey, payload);
-}
-
-export async function createBranch(apiKey: string, orgId: string, repo: string, name: string, from: string): Promise<{ name: string }> {
-  return request('POST', `${repoBase(orgId, repo)}/branches`, apiKey, { name, from });
-}
-
-export async function deleteBranch(apiKey: string, orgId: string, repo: string, branch: string): Promise<void> {
-  return request('DELETE', `${repoBase(orgId, repo)}/branches/${encodeURIComponent(branch)}`, apiKey);
-}
-
-export async function createTag(apiKey: string, orgId: string, repo: string, name: string, ref: string): Promise<{ name: string }> {
-  return request('POST', `${repoBase(orgId, repo)}/tags`, apiKey, { name, ref });
-}
-
-// merge fast-forwards `target` to `source` (fast-forward only).
-export async function merge(apiKey: string, orgId: string, repo: string, target: string, source: string): Promise<{ sha: string }> {
-  return request('POST', `${repoBase(orgId, repo)}/merges`, apiKey, { target, source });
-}
-
-// repack compacts the repository's incremental packfiles into one.
-export async function repack(apiKey: string, orgId: string, repo: string): Promise<RepackResult> {
-  return request('POST', `${repoBase(orgId, repo)}/repack`, apiKey);
-}