@miosa/sdk 1.2.4 → 1.2.6

package/src/resources/files.test.ts

@@ -1,339 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { HttpClient } from "../http.js";
-import type { DirEntry, FileStat } from "../types.js";
-import { Files } from "./files.js";
-
-// ── Helpers ────────────────────────────────────────────────────────────────────
-
-function mockFetch(status: number, body: unknown): void {
-  vi.stubGlobal(
-    "fetch",
-    vi.fn().mockResolvedValue({
-      ok: status >= 200 && status < 300,
-      status,
-      headers: new Headers({ "content-type": "application/json" }),
-      json: () => Promise.resolve(body),
-      arrayBuffer: () => Promise.resolve(new ArrayBuffer(0)),
-      body: null,
-    }),
-  );
-}
-
-function makeFiles(computerId = "computer-123"): Files {
-  const http = new HttpClient({
-    baseUrl: "https://api.miosa.ai/api/v1",
-    apiKey: "msk_test_key",
-    timeout: 5_000,
-    maxRetries: 0,
-  });
-  return new Files(http, computerId);
-}
-
-// ── stat ───────────────────────────────────────────────────────────────────────
-
-describe("Files.stat", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should POST to /computers/:id/files/stat with path", async () => {
-    const mockStat: FileStat = {
-      path: "/home/user/main.py",
-      size: 42,
-      mode: 0o100644,
-      is_dir: false,
-      is_symlink: false,
-      modified_at: "2026-01-01T00:00:00Z",
-    };
-    mockFetch(200, { data: mockStat });
-
-    const files = makeFiles();
-    const result = await files.stat("/home/user/main.py");
-
-    expect(result).toEqual(mockStat);
-
-    const [url, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    expect(url).toContain("/computers/computer-123/files/stat");
-    expect(init.method).toBe("POST");
-    expect(JSON.parse(init.body as string)).toEqual({
-      path: "/home/user/main.py",
-    });
-  });
-
-  it("should unwrap data envelope from response", async () => {
-    const stat: FileStat = {
-      path: "/tmp/x",
-      size: 0,
-      mode: 0o40755,
-      is_dir: true,
-      is_symlink: false,
-      modified_at: "2026-01-01T00:00:00Z",
-    };
-    mockFetch(200, { data: stat });
-    const result = await makeFiles().stat("/tmp/x");
-    expect(result.is_dir).toBe(true);
-    expect(result.size).toBe(0);
-  });
-
-  it("should include symlink_target when present", async () => {
-    const stat: FileStat = {
-      path: "/home/user/link",
-      size: 10,
-      mode: 0o120777,
-      is_dir: false,
-      is_symlink: true,
-      symlink_target: "/home/user/real.txt",
-      modified_at: "2026-01-01T00:00:00Z",
-    };
-    mockFetch(200, { data: stat });
-    const result = await makeFiles().stat("/home/user/link");
-    expect(result.is_symlink).toBe(true);
-    expect(result.symlink_target).toBe("/home/user/real.txt");
-  });
-});
-
-// ── mkdir ──────────────────────────────────────────────────────────────────────
-
-describe("Files.mkdir", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should POST to /computers/:id/files/mkdir with defaults", async () => {
-    mockFetch(201, { data: { status: "created", path: "/home/user/project" } });
-
-    await makeFiles().mkdir("/home/user/project");
-
-    const [url, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    expect(url).toContain("/computers/computer-123/files/mkdir");
-    const body = JSON.parse(init.body as string);
-    expect(body.path).toBe("/home/user/project");
-    expect(body.recursive).toBe(true); // default
-    expect(body.mode).toBe("0755"); // default
-  });
-
-  it("should send correct mode when integer is passed", async () => {
-    mockFetch(201, { data: { status: "created" } });
-
-    await makeFiles().mkdir("/tmp/test", { mode: 0o700 });
-
-    const [, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    const body = JSON.parse(init.body as string);
-    expect(body.mode).toBe("0700");
-  });
-
-  it("should respect recursive:false", async () => {
-    mockFetch(201, { data: { status: "created" } });
-
-    await makeFiles().mkdir("/tmp/strict", { recursive: false });
-
-    const [, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    const body = JSON.parse(init.body as string);
-    expect(body.recursive).toBe(false);
-  });
-});
-
-// ── rename ─────────────────────────────────────────────────────────────────────
-
-describe("Files.rename", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should POST to /computers/:id/files/rename with from and to", async () => {
-    mockFetch(200, { data: { status: "renamed" } });
-
-    await makeFiles().rename("/home/user/a.txt", "/home/user/b.txt");
-
-    const [url, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    expect(url).toContain("/files/rename");
-    const body = JSON.parse(init.body as string);
-    expect(body.from).toBe("/home/user/a.txt");
-    expect(body.to).toBe("/home/user/b.txt");
-  });
-});
-
-// ── copy ───────────────────────────────────────────────────────────────────────
-
-describe("Files.copy", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should POST to /computers/:id/files/copy with recursive:false by default", async () => {
-    mockFetch(201, { data: { status: "copied" } });
-
-    await makeFiles().copy("/home/user/src.txt", "/home/user/dst.txt");
-
-    const [, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    const body = JSON.parse(init.body as string);
-    expect(body.from).toBe("/home/user/src.txt");
-    expect(body.to).toBe("/home/user/dst.txt");
-    expect(body.recursive).toBe(false);
-  });
-
-  it("should send recursive:true when option is set", async () => {
-    mockFetch(201, { data: { status: "copied" } });
-
-    await makeFiles().copy("/home/user/src", "/home/user/dst", {
-      recursive: true,
-    });
-
-    const [, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    const body = JSON.parse(init.body as string);
-    expect(body.recursive).toBe(true);
-  });
-});
-
-// ── chmod ──────────────────────────────────────────────────────────────────────
-
-describe("Files.chmod", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should POST to /computers/:id/files/chmod with octal integer", async () => {
-    mockFetch(200, { data: { status: "ok" } });
-
-    await makeFiles().chmod("/home/user/run.sh", 0o755);
-
-    const [url, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    expect(url).toContain("/files/chmod");
-    const body = JSON.parse(init.body as string);
-    expect(body.path).toBe("/home/user/run.sh");
-    expect(body.mode).toBe("0755");
-  });
-
-  it("should accept a string mode directly", async () => {
-    mockFetch(200, { data: { status: "ok" } });
-
-    await makeFiles().chmod("/home/user/read.txt", "0644");
-
-    const [, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    const body = JSON.parse(init.body as string);
-    expect(body.mode).toBe("0644");
-  });
-
-  it("should zero-pad mode < 4 digits", async () => {
-    mockFetch(200, { data: { status: "ok" } });
-
-    // 0o77 = 63 decimal → "0077"
-    await makeFiles().chmod("/tmp/x", 0o77);
-
-    const [, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    const body = JSON.parse(init.body as string);
-    expect(body.mode).toBe("0077");
-  });
-});
-
-// ── readdir ────────────────────────────────────────────────────────────────────
-
-describe("Files.readdir", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  const mockEntries: DirEntry[] = [
-    {
-      name: "main.py",
-      is_dir: false,
-      is_symlink: false,
-      size: 100,
-      modified_at: "2026-01-01T00:00:00Z",
-    },
-    {
-      name: "tests",
-      is_dir: true,
-      is_symlink: false,
-      size: 0,
-      modified_at: "2026-01-01T00:00:00Z",
-    },
-  ];
-
-  it("should GET /computers/:id/files/readdir with path query param", async () => {
-    mockFetch(200, { data: { entries: mockEntries, path: "/workspace" } });
-
-    const result = await makeFiles().readdir("/workspace");
-
-    const [url] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [string];
-    expect(url).toContain("/files/readdir");
-    expect(url).toContain("path=%2Fworkspace");
-    expect(result).toEqual(mockEntries);
-  });
-
-  it("should return an array of DirEntry", async () => {
-    mockFetch(200, { data: { entries: mockEntries, path: "/workspace" } });
-
-    const entries = await makeFiles().readdir("/workspace");
-    expect(entries).toHaveLength(2);
-    expect(entries[0]!.name).toBe("main.py");
-    expect(entries[0]!.is_dir).toBe(false);
-    expect(entries[1]!.name).toBe("tests");
-    expect(entries[1]!.is_dir).toBe(true);
-  });
-});
-
-// ── writeFile / readFile helpers ───────────────────────────────────────────────
-
-describe("Files.writeFile", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should delegate to upload() with base64-encoded content", async () => {
-    mockFetch(201, {
-      file: { path: "/home/user/hello.txt" },
-      success: true,
-    });
-
-    await makeFiles().writeFile("/home/user/hello.txt", "hello");
-
-    const [url, init] = (fetch as ReturnType<typeof vi.fn>).mock.calls[0] as [
-      string,
-      RequestInit,
-    ];
-    expect(url).toContain("/files/write");
-    const body = JSON.parse(init.body as string);
-    expect(body.path).toBe("/home/user/hello.txt");
-    expect(typeof body.content_base64).toBe("string");
-  });
-});
-
-describe("Files.readFile", () => {
-  beforeEach(() => vi.restoreAllMocks());
-
-  it("should delegate to download() and decode UTF-8", async () => {
-    const content = "print('hello')";
-    const bytes = new TextEncoder().encode(content);
-    vi.stubGlobal(
-      "fetch",
-      vi.fn().mockResolvedValue({
-        ok: true,
-        status: 200,
-        headers: new Headers({ "content-type": "application/octet-stream" }),
-        json: () => Promise.reject(new Error("not json")),
-        arrayBuffer: () => Promise.resolve(bytes.buffer as ArrayBuffer),
-        body: null,
-      }),
-    );
-
-    const result = await makeFiles().readFile("/home/user/main.py");
-    expect(result).toBe(content);
-  });
-});

package/src/resources/files.ts

@@ -1,220 +0,0 @@
-import { HttpClient } from "../http.js";
-import type {
-  CopyParams,
-  DirEntry,
-  DirListResult,
-  FileDeleteParams,
-  FileEntry,
-  FileExportParams,
-  FileExportResult,
-  FileListResult,
-  FileStat,
-  MkdirParams,
-} from "../types.js";
-
-function toBase64(bytes: Uint8Array): string {
-  // Works on both Node (Buffer available) and browsers/Deno/Bun (btoa).
-  const maybeBuffer = (
-    globalThis as {
-      Buffer?: { from(b: Uint8Array): { toString(e: string): string } };
-    }
-  ).Buffer;
-  if (maybeBuffer) return maybeBuffer.from(bytes).toString("base64");
-  let bin = "";
-  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]!);
-  return btoa(bin);
-}
-
-export class Files {
-  private readonly http: HttpClient;
-  private readonly computerId: string;
-
-  constructor(http: HttpClient, computerId: string) {
-    this.http = http;
-    this.computerId = computerId;
-  }
-
-  private base(): string {
-    return `/computers/${this.computerId}/files`;
-  }
-
-  /**
-   * Upload a local file to the computer.
-   *
-   * In a Node.js environment pass a Buffer or Blob; in a browser pass a File
-   * or Blob.  The remote path is where the file will be written inside the VM.
-   *
-   * @param content  - File content as Blob, Buffer, Uint8Array, or string.
-   * @param remotePath - Absolute path inside the VM (e.g. /home/user/file.txt).
-   * @param filename - Optional filename hint (defaults to basename of remotePath).
-   */
-  async upload(
-    content: Blob | Uint8Array | string,
-    remotePath: string,
-    _filename?: string,
-  ): Promise<FileEntry> {
-    // The hosted API is JSON-only — it doesn't accept multipart uploads.
-    // We send {path, content_base64} so binary payloads round-trip cleanly.
-    let bytes: Uint8Array;
-    if (typeof content === "string") {
-      bytes = new TextEncoder().encode(content);
-    } else if (content instanceof Uint8Array) {
-      bytes = content;
-    } else {
-      // Blob → bytes
-      const buf = await content.arrayBuffer();
-      bytes = new Uint8Array(buf);
-    }
-
-    const contentBase64 = toBase64(bytes);
-
-    return this.http.post<FileEntry>(`${this.base()}/write`, {
-      path: remotePath,
-      content_base64: contentBase64,
-    });
-  }
-
-  /**
-   * List files and directories at the given path inside the VM.
-   */
-  async list(path: string): Promise<FileListResult> {
-    return this.http.get<FileListResult>(this.base(), { path });
-  }
-
-  /**
-   * Download a file from the computer. Returns raw bytes.
-   */
-  async download(path: string): Promise<Uint8Array> {
-    const url = `${this.base()}/download`;
-    // Build query manually so getBinary can still use the helper
-    return this.http.getBinary(`${url}?path=${encodeURIComponent(path)}`);
-  }
-
-  /**
-   * Export a file from the computer and receive a temporary signed URL.
-   */
-  async export(path: string): Promise<FileExportResult> {
-    const params: FileExportParams = { path };
-    return this.http.post<FileExportResult>(`${this.base()}/export`, params);
-  }
-
-  /**
-   * Delete a file or directory inside the computer.
-   */
-  async delete(path: string): Promise<void> {
-    const params: FileDeleteParams = { path };
-    return this.http.delete<void>(this.base(), params);
-  }
-
-  // ── Phase-7 stdlib-parity methods ──────────────────────────────────────────
-
-  /**
-   * Stat a path inside the computer. Does not follow symlinks (lstat semantics).
-   *
-   * Returns `{path, size, mode, is_dir, is_symlink, symlink_target?, modified_at}`.
-   */
-  async stat(path: string): Promise<FileStat> {
-    const result = await this.http.post<{ data: FileStat }>(
-      `${this.base()}/stat`,
-      { path },
-    );
-    return result.data;
-  }
-
-  /**
-   * Create a directory inside the computer.
-   *
-   * @param path    - Absolute path to create (e.g. `/home/user/project`).
-   * @param options - `{ recursive?: boolean, mode?: number }`. Defaults: recursive=true, mode=0o755.
-   */
-  async mkdir(path: string, options: MkdirParams = {}): Promise<void> {
-    const modeStr =
-      options.mode !== undefined
-        ? options.mode.toString(8).padStart(4, "0")
-        : "0755";
-
-    await this.http.post<unknown>(`${this.base()}/mkdir`, {
-      path,
-      recursive: options.recursive ?? true,
-      mode: modeStr,
-    });
-  }
-
-  /**
-   * Rename (move) a path inside the computer.
-   *
-   * Creates the destination parent directory if it does not exist.
-   */
-  async rename(from: string, to: string): Promise<void> {
-    await this.http.post<unknown>(`${this.base()}/rename`, { from, to });
-  }
-
-  /**
-   * Copy a file or directory inside the computer.
-   *
-   * @param from    - Source absolute path.
-   * @param to      - Destination absolute path.
-   * @param options - `{ recursive?: boolean }`. Required when source is a directory.
-   */
-  async copy(
-    from: string,
-    to: string,
-    options: CopyParams = {},
-  ): Promise<void> {
-    await this.http.post<unknown>(`${this.base()}/copy`, {
-      from,
-      to,
-      recursive: options.recursive ?? false,
-    });
-  }
-
-  /**
-   * Change permissions on a path inside the computer.
-   *
-   * @param path - Absolute path inside the VM.
-   * @param mode - Unix mode bits as an octal integer (e.g. `0o755`) or string (`"0755"`).
-   */
-  async chmod(path: string, mode: number | string): Promise<void> {
-    const modeStr =
-      typeof mode === "number" ? mode.toString(8).padStart(4, "0") : mode;
-    await this.http.post<unknown>(`${this.base()}/chmod`, {
-      path,
-      mode: modeStr,
-    });
-  }
-
-  /**
-   * Return a rich directory listing for the given path.
-   *
-   * Each entry includes `{name, is_dir, is_symlink, size, modified_at}`.
-   * Richer than `list()` which uses `find` under the hood.
-   *
-   * @param path        - Absolute path to list.
-   * @param _withTypes  - Kept for API symmetry; types are always returned.
-   */
-  async readdir(path: string, _withTypes = true): Promise<DirEntry[]> {
-    const result = await this.http.get<DirListResult>(
-      `${this.base()}/readdir`,
-      { path },
-    );
-    return result.data.entries;
-  }
-
-  // ── Read/write text helpers ─────────────────────────────────────────────────
-
-  /**
-   * Write a UTF-8 string to a file inside the computer.
-   * Convenience wrapper around `upload()`.
-   */
-  async writeFile(path: string, content: string): Promise<void> {
-    await this.upload(content, path);
-  }
-
-  /**
-   * Read a file from the computer and return its contents as a UTF-8 string.
-   */
-  async readFile(path: string): Promise<string> {
-    const bytes = await this.download(path);
-    return new TextDecoder().decode(bytes);
-  }
-}

package/src/resources/flat-custom-domains.ts

@@ -1,127 +0,0 @@
-/**
- * FlatCustomDomains resource — tenant-scoped custom domains at /custom-domains.
- *
- * The per-computer and per-deployment domain APIs live on those resources;
- * this is the flat tenant-level list view for white-label platforms managing
- * many domains across all resources.
- */
-
-import { randomUUID } from "node:crypto";
-
-import type { HttpClient } from "../http.js";
-
-// ── Branded IDs ──────────────────────────────────────────────────────────────
-
-export type CustomDomainId = string & { readonly __brand: "CustomDomainId" };
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface CustomDomainData {
-  id: CustomDomainId;
-  tenant_id: string;
-  domain: string;
-  state?: string;
-  resource_type?: string | null;
-  resource_id?: string | null;
-  verified?: boolean;
-  verification_token?: string | null;
-  created_at?: string;
-  updated_at?: string;
-  [key: string]: unknown;
-}
-
-// ── Request payloads ─────────────────────────────────────────────────────────
-
-export interface CustomDomainListParams {
-  limit?: number;
-  cursor?: string;
-  [key: string]: string | number | boolean | undefined;
-}
-
-export interface CustomDomainCreateParams {
-  domain: string;
-  resource_type?: string;
-  resourceType?: string;
-  resource_id?: string;
-  resourceId?: string;
-  redirect_policy?: "none" | "www_to_apex" | "apex_to_www";
-  redirectPolicy?: "none" | "www_to_apex" | "apex_to_www";
-  idempotencyKey?: string;
-  [key: string]: unknown;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(
-  payload: unknown,
-  candidateKeys: string[] = ["data", "domains", "items"],
-): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  if (Array.isArray(p.data)) return p.data as T[];
-  for (const key of candidateKeys) {
-    if (Array.isArray(p[key])) return p[key] as T[];
-  }
-  return [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-function idempotencyKey(key?: string): string {
-  return key ?? randomUUID();
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class FlatCustomDomains {
-  constructor(private readonly http: HttpClient) {}
-
-  async list(params: CustomDomainListParams = {}): Promise<CustomDomainData[]> {
-    const query = stripUndefined({ ...params }) as Record<
-      string,
-      string | number | boolean | undefined
-    >;
-    const data = await this.http.get<unknown>("/custom-domains", query);
-    return listItems<CustomDomainData>(data);
-  }
-
-  async create(params: CustomDomainCreateParams): Promise<CustomDomainData> {
-    const {
-      idempotencyKey: ikey,
-      resourceType,
-      resourceId,
-      redirectPolicy,
-      ...rest
-    } = params;
-    const body = stripUndefined({
-      ...rest,
-      resource_type: resourceType ?? rest.resource_type,
-      resource_id: resourceId ?? rest.resource_id,
-      redirect_policy: redirectPolicy ?? rest.redirect_policy,
-    });
-    const data = await this.http.request<unknown>("/custom-domains", {
-      method: "POST",
-      body,
-      headers: { "Idempotency-Key": idempotencyKey(ikey) },
-    });
-    return unwrap<CustomDomainData>(data);
-  }
-
-  async delete(domainId: string): Promise<void> {
-    await this.http.delete<unknown>(`/custom-domains/${domainId}`);
-  }
-}