@unicity-astrid/sdk 0.1.0

package/dist/fs.js

@@ -0,0 +1,257 @@
+/**
+ * Virtual filesystem — shape-compatible with `node:fs/promises` where it
+ * makes sense, including a `Stats`-like object with `isFile()` /
+ * `isDirectory()` methods.
+ *
+ * Path schemes follow VFS conventions (`workspace://`, `home://`, `tmp://`).
+ * The kernel re-resolves and re-validates every path on every call;
+ * {@link canonicalize} is for display / equality only, NOT a security check
+ * that subsequent calls can rely on.
+ *
+ * The Rust SDK's surface is sync (`std::fs`); we expose async (`await`) to
+ * match Node idioms even though the underlying host calls are synchronous.
+ * StarlingMonkey syncifies awaits at the WASM boundary.
+ */
+import { fsOpen as hostOpen, fsExists as hostExists, fsMkdir as hostMkdir, fsMkdirAll as hostMkdirAll, fsReaddir as hostReaddir, fsStat as hostStat, fsStatSymlink as hostStatSymlink, fsUnlink as hostUnlink, readFile as hostReadFile, writeFile as hostWriteFile, fsAppend as hostAppend, fsCopy as hostCopy, fsRename as hostRename, fsRemoveDirAll as hostRemoveDirAll, fsCanonicalize as hostCanonicalize, fsReadLink as hostReadLink, fsHardLink as hostHardLink, } from "astrid:fs/host@1.0.0";
+import { SysError, callHost } from "./errors.js";
+const decoder = new TextDecoder();
+const encoder = new TextEncoder();
+/**
+ * Stat result. Shaped like Node's `fs.Stats` for the fields the Astrid VFS
+ * surfaces. `size` is `bigint` (WIT `u64`); use `Number(size)` if you need a
+ * regular number and you're sure it fits.
+ */
+export class Stats {
+    size;
+    mode;
+    kind;
+    mtimeMs;
+    birthtimeMs;
+    atimeMs;
+    constructor(stat) {
+        this.size = stat.size;
+        this.mode = stat.mode;
+        this.kind = stat.kind;
+        this.mtimeMs = datetimeToMs(stat.modified);
+        this.birthtimeMs = datetimeToMs(stat.created);
+        this.atimeMs = datetimeToMs(stat.accessed);
+    }
+    isFile() {
+        return this.kind === "regular";
+    }
+    isDirectory() {
+        return this.kind === "directory";
+    }
+    isSymbolicLink() {
+        return this.kind === "symlink";
+    }
+    isEmpty() {
+        return this.size === 0n;
+    }
+}
+/** Directory entry returned by `readdir({ withFileTypes: true })`. */
+export class Dirent {
+    name;
+    path;
+    parentPath;
+    constructor(parentPath, name) {
+        this.name = name;
+        this.parentPath = parentPath;
+        this.path = parentPath.endsWith("/") ? parentPath + name : `${parentPath}/${name}`;
+    }
+}
+/**
+ * Open file handle. Returned from {@link open}. The host releases the
+ * underlying file descriptor automatically when the handle is dropped via
+ * `Symbol.dispose` or `.close()`. Per-capsule cap: 16 open file handles.
+ *
+ * ```ts
+ * using f = await fs.open("workspace://data.bin", "read-write");
+ * await f.writeAt(0n, new TextEncoder().encode("hello"));
+ * ```
+ */
+export class FileHandle {
+    #inner;
+    path;
+    constructor(inner, path) {
+        this.#inner = inner;
+        this.path = path;
+    }
+    /** Read up to `maxBytes` from `offset`. Empty result signals EOF at that offset. */
+    async readAt(offset, maxBytes) {
+        return callHost(`fs.FileHandle.readAt(${quote(this.path)})`, () => this.#requireInner().readAt(offset, maxBytes));
+    }
+    /** Write `data` at `offset`. Returns bytes actually written. */
+    async writeAt(offset, data) {
+        return callHost(`fs.FileHandle.writeAt(${quote(this.path)})`, () => this.#requireInner().writeAt(offset, data));
+    }
+    /** Flush buffered data (only) to disk — `fdatasync(2)`. */
+    async syncData() {
+        callHost(`fs.FileHandle.syncData(${quote(this.path)})`, () => this.#requireInner().syncData());
+    }
+    /** Flush both data and metadata to disk — `fsync(2)`. */
+    async syncAll() {
+        callHost(`fs.FileHandle.syncAll(${quote(this.path)})`, () => this.#requireInner().syncAll());
+    }
+    /** Race-free counterpart to {@link stat} on the path. */
+    async stat() {
+        const raw = callHost(`fs.FileHandle.stat(${quote(this.path)})`, () => this.#requireInner().stat());
+        return new Stats(raw);
+    }
+    /** Truncate or extend the file to `size` bytes. Extending past end fills with zeros. */
+    async setLen(size) {
+        callHost(`fs.FileHandle.setLen(${quote(this.path)})`, () => this.#requireInner().setLen(size));
+    }
+    close() {
+        if (this.#inner === undefined)
+            return;
+        const inner = this.#inner;
+        this.#inner = undefined;
+        try {
+            inner[Symbol.dispose]();
+        }
+        catch {
+            // Already disposed by the runtime; safe to ignore.
+        }
+    }
+    [Symbol.dispose]() {
+        this.close();
+    }
+    #requireInner() {
+        if (this.#inner === undefined) {
+            throw SysError.api(`FileHandle ${quote(this.path)} is closed`);
+        }
+        return this.#inner;
+    }
+}
+/** Open a file by path. Required capability depends on `mode`. */
+export async function open(path, mode) {
+    const inner = callHost(`fs.open(${quote(path)})`, () => hostOpen(path, mode));
+    return new FileHandle(inner, path);
+}
+export async function exists(path) {
+    return callHost(`fs.exists(${quote(path)})`, () => hostExists(path));
+}
+export async function stat(path) {
+    const raw = callHost(`fs.stat(${quote(path)})`, () => hostStat(path));
+    return new Stats(raw);
+}
+/** Stat without following symlinks — `lstat(2)`. */
+export async function lstat(path) {
+    const raw = callHost(`fs.lstat(${quote(path)})`, () => hostStatSymlink(path));
+    return new Stats(raw);
+}
+export async function readFile(path, options) {
+    const bytes = callHost(`fs.readFile(${quote(path)})`, () => hostReadFile(path));
+    if (options?.encoding === "utf8")
+        return decoder.decode(bytes);
+    return bytes;
+}
+/** Read a file as UTF-8 text. */
+export async function readTextFile(path) {
+    const bytes = callHost(`fs.readTextFile(${quote(path)})`, () => hostReadFile(path));
+    try {
+        return decoder.decode(bytes);
+    }
+    catch (err) {
+        throw SysError.api(`fs.readTextFile(${quote(path)}): ${err.message}`, err);
+    }
+}
+export async function writeFile(path, data) {
+    const bytes = typeof data === "string" ? encoder.encode(data) : data;
+    callHost(`fs.writeFile(${quote(path)})`, () => hostWriteFile(path, bytes));
+}
+/** Append `data` to a file, creating it if absent. */
+export async function appendFile(path, data) {
+    const bytes = typeof data === "string" ? encoder.encode(data) : data;
+    callHost(`fs.appendFile(${quote(path)})`, () => hostAppend(path, bytes));
+}
+/**
+ * Create a directory. Mirrors `std::fs::create_dir` / `mkdir(2)` — strict.
+ * Fails with `already-exists` if the path exists. Use {@link mkdirAll} for
+ * idempotent "ensure-exists" semantics.
+ */
+export async function mkdir(path) {
+    callHost(`fs.mkdir(${quote(path)})`, () => hostMkdir(path));
+}
+/** Create a directory and all missing parents. Idempotent. */
+export async function mkdirAll(path) {
+    callHost(`fs.mkdirAll(${quote(path)})`, () => hostMkdirAll(path));
+}
+/** Remove a file. Mirrors `fs.unlink` / `fs.rm` (file-only). */
+export async function rm(path) {
+    callHost(`fs.rm(${quote(path)})`, () => hostUnlink(path));
+}
+/** Alias for {@link rm} matching Node's `fs.unlink`. */
+export const unlink = rm;
+/**
+ * Remove a directory and all its contents recursively. Refuses to traverse
+ * symlinks to prevent sandbox escapes. Returns the count of removed entries.
+ */
+export async function removeDirAll(path) {
+    return callHost(`fs.removeDirAll(${quote(path)})`, () => hostRemoveDirAll(path));
+}
+/** Copy a file from `src` to `dst`. Overwrites `dst`. */
+export async function copy(src, dst) {
+    callHost(`fs.copy(${quote(src)} -> ${quote(dst)})`, () => hostCopy(src, dst));
+}
+/** Rename (move) within the same VFS scheme. Cross-scheme returns `cross-vfs`. */
+export async function rename(src, dst) {
+    callHost(`fs.rename(${quote(src)} -> ${quote(dst)})`, () => hostRename(src, dst));
+}
+/**
+ * Resolve a path to its canonical form, following symlinks. Returns a
+ * VFS-scheme path, never a host real-path. NOT a TOCTOU-safe security check.
+ */
+export async function canonicalize(path) {
+    return callHost(`fs.canonicalize(${quote(path)})`, () => hostCanonicalize(path));
+}
+/** Read a symlink target without following it. */
+export async function readLink(path) {
+    return callHost(`fs.readLink(${quote(path)})`, () => hostReadLink(path));
+}
+/** Create a hard link. Both endpoints must be in the same VFS scheme. */
+export async function hardLink(src, linkPath) {
+    callHost(`fs.hardLink(${quote(src)} -> ${quote(linkPath)})`, () => hostHardLink(src, linkPath));
+}
+export async function readdir(path, options) {
+    const names = callHost(`fs.readdir(${quote(path)})`, () => hostReaddir(path));
+    if (options?.withFileTypes) {
+        return names.map((n) => new Dirent(path, n));
+    }
+    return names;
+}
+/**
+ * Stream-style directory iteration. Mirrors `fs.opendir` / `Dir`. The VFS
+ * resolves all entries in one host call, so the async-iterator is fully
+ * populated up-front; the shape matches Node for compatibility.
+ */
+export async function opendir(path) {
+    const entries = await readdir(path, { withFileTypes: true });
+    let i = 0;
+    const iter = {
+        [Symbol.asyncIterator]() {
+            return iter;
+        },
+        async next() {
+            if (i >= entries.length) {
+                return { value: undefined, done: true };
+            }
+            return { value: entries[i++], done: false };
+        },
+        async return() {
+            i = entries.length;
+            return { value: undefined, done: true };
+        },
+    };
+    return iter;
+}
+function datetimeToMs(dt) {
+    if (dt === undefined)
+        return undefined;
+    return Number(dt.seconds) * 1000 + dt.nanoseconds / 1_000_000;
+}
+function quote(s) {
+    return `"${s.replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Outbound HTTP. Two public shapes:
+ *
+ *   1. A builder-style {@link Request} / {@link Response} mirroring the Rust
+ *      SDK's reqwest-like API (`http.get(url)`, `http.send(req)`).
+ *   2. A WHATWG `fetch(url, init)` polyfill registered onto `globalThis`
+ *      at SDK init via {@link installFetchPolyfill}. Routes through the same
+ *      capability-gated host imports so users can't bypass the per-capsule
+ *      net allow-list by reaching for the platform fetch.
+ *
+ * Streaming: {@link streamStart} returns an {@link HttpStream} resource
+ * handle with `read-chunk` for explicit per-chunk pulls, an `async-iterator`
+ * convenience, and access to the body as an `astrid:io/streams` `InputStream`
+ * for capsules forwarding the body into another sink.
+ */
+import { type HttpRequestData, type HttpResponseData, type HttpStream as WitHttpStream } from "astrid:http/host@1.0.0";
+export type HttpMethod = "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "CONNECT" | "OPTIONS" | "TRACE" | "PATCH" | string;
+export declare class Request {
+    url: string;
+    method: string;
+    headers: Map<string, string>;
+    body: Uint8Array | undefined;
+    constructor(method: string, url: string);
+    static get(url: string): Request;
+    static post(url: string): Request;
+    static put(url: string): Request;
+    static delete(url: string): Request;
+    static patch(url: string): Request;
+    static head(url: string): Request;
+    header(key: string, value: string): this;
+    setBody(body: string | Uint8Array): this;
+    json<T>(value: T): this;
+    toWit(): HttpRequestData;
+}
+export declare class Response {
+    #private;
+    readonly status: number;
+    readonly headers: Map<string, string>;
+    constructor(raw: HttpResponseData);
+    bytes(): Uint8Array;
+    text(): string;
+    json<T = unknown>(): T;
+    ok(): boolean;
+}
+export declare function send(req: Request): Response;
+/**
+ * Streaming HTTP response. The kernel buffers chunks server-side; the
+ * capsule reads them via `.read()` (or the async iterator) until EOF. Drop
+ * (via `using` or `.close()`) releases the host-side resource.
+ */
+export declare class HttpStreamHandle {
+    #private;
+    readonly status: number;
+    readonly headers: Map<string, string>;
+    constructor(inner: WitHttpStream);
+    /** Read the next chunk. Returns `undefined` at EOF. */
+    read(): Uint8Array | undefined;
+    close(): void;
+    [Symbol.dispose](): void;
+    /** Async iterator that yields each chunk until EOF. Auto-closes on completion. */
+    [Symbol.asyncIterator](): AsyncIterableIterator<Uint8Array>;
+}
+export interface StreamStart {
+    handle: HttpStreamHandle;
+    status: number;
+    headers: Map<string, string>;
+}
+export declare function streamStart(req: Request): StreamStart;
+export interface FetchInit {
+    method?: string;
+    headers?: Record<string, string> | Map<string, string> | [string, string][];
+    body?: string | Uint8Array | Record<string, unknown>;
+}
+export declare class FetchResponse {
+    #private;
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: Headers;
+    readonly url: string;
+    readonly ok: boolean;
+    constructor(url: string, status: number, headerEntries: [string, string][], body: Uint8Array);
+    text(): Promise<string>;
+    json<T = unknown>(): Promise<T>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    bytes(): Promise<Uint8Array>;
+}
+export declare function fetchPolyfill(url: string, init?: FetchInit): Promise<FetchResponse>;
+/** Install the polyfill on `globalThis.fetch`. */
+export declare function installFetchPolyfill(): void;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/http.js

@@ -0,0 +1,276 @@
+/**
+ * Outbound HTTP. Two public shapes:
+ *
+ *   1. A builder-style {@link Request} / {@link Response} mirroring the Rust
+ *      SDK's reqwest-like API (`http.get(url)`, `http.send(req)`).
+ *   2. A WHATWG `fetch(url, init)` polyfill registered onto `globalThis`
+ *      at SDK init via {@link installFetchPolyfill}. Routes through the same
+ *      capability-gated host imports so users can't bypass the per-capsule
+ *      net allow-list by reaching for the platform fetch.
+ *
+ * Streaming: {@link streamStart} returns an {@link HttpStream} resource
+ * handle with `read-chunk` for explicit per-chunk pulls, an `async-iterator`
+ * convenience, and access to the body as an `astrid:io/streams` `InputStream`
+ * for capsules forwarding the body into another sink.
+ */
+import { httpRequest as hostRequest, httpStreamStart as hostStreamStart, } from "astrid:http/host@1.0.0";
+import { SysError, callHost } from "./errors.js";
+/** Convert a string method name into the WIT variant the host expects. */
+function methodToWit(method) {
+    switch (method.toUpperCase()) {
+        case "GET":
+            return { tag: "get" };
+        case "HEAD":
+            return { tag: "head" };
+        case "POST":
+            return { tag: "post" };
+        case "PUT":
+            return { tag: "put" };
+        case "DELETE":
+            return { tag: "delete" };
+        case "CONNECT":
+            return { tag: "connect" };
+        case "OPTIONS":
+            return { tag: "options" };
+        case "TRACE":
+            return { tag: "trace" };
+        case "PATCH":
+            return { tag: "patch" };
+        default:
+            return { tag: "other", val: method };
+    }
+}
+// ---------------------------------------------------------------------------
+// Builder API (reqwest shape)
+// ---------------------------------------------------------------------------
+export class Request {
+    url;
+    method;
+    headers;
+    body;
+    constructor(method, url) {
+        this.method = method;
+        this.url = url;
+        this.headers = new Map();
+        this.body = undefined;
+    }
+    static get(url) {
+        return new Request("GET", url);
+    }
+    static post(url) {
+        return new Request("POST", url);
+    }
+    static put(url) {
+        return new Request("PUT", url);
+    }
+    static delete(url) {
+        return new Request("DELETE", url);
+    }
+    static patch(url) {
+        return new Request("PATCH", url);
+    }
+    static head(url) {
+        return new Request("HEAD", url);
+    }
+    header(key, value) {
+        this.headers.set(key, value);
+        return this;
+    }
+    setBody(body) {
+        this.body = typeof body === "string" ? new TextEncoder().encode(body) : body;
+        return this;
+    }
+    json(value) {
+        this.headers.set("Content-Type", "application/json");
+        let s;
+        try {
+            s = JSON.stringify(value);
+        }
+        catch (err) {
+            throw SysError.json(`http.Request.json: ${err.message}`, err);
+        }
+        this.body = new TextEncoder().encode(s);
+        return this;
+    }
+    toWit() {
+        return {
+            url: this.url,
+            method: methodToWit(this.method),
+            headers: Array.from(this.headers, ([key, value]) => ({ key, value })),
+            body: this.body,
+        };
+    }
+}
+export class Response {
+    status;
+    headers;
+    #body;
+    constructor(raw) {
+        this.status = raw.status;
+        this.headers = new Map(raw.headers.map((h) => [h.key, h.value]));
+        this.#body = raw.body;
+    }
+    bytes() {
+        return this.#body;
+    }
+    text() {
+        return new TextDecoder().decode(this.#body);
+    }
+    json() {
+        try {
+            return JSON.parse(this.text());
+        }
+        catch (err) {
+            throw SysError.json(`http.Response.json: ${err.message}`, err);
+        }
+    }
+    ok() {
+        return this.status >= 200 && this.status < 300;
+    }
+}
+export function send(req) {
+    const wit = req.toWit();
+    const raw = callHost(`http.send ${req.method} ${req.url}`, () => hostRequest(wit));
+    return new Response(raw);
+}
+// ---------------------------------------------------------------------------
+// Streaming
+// ---------------------------------------------------------------------------
+/**
+ * Streaming HTTP response. The kernel buffers chunks server-side; the
+ * capsule reads them via `.read()` (or the async iterator) until EOF. Drop
+ * (via `using` or `.close()`) releases the host-side resource.
+ */
+export class HttpStreamHandle {
+    #inner;
+    status;
+    headers;
+    constructor(inner) {
+        this.#inner = inner;
+        this.status = inner.status();
+        this.headers = new Map(inner.headers().map((h) => [h.key, h.value]));
+    }
+    /** Read the next chunk. Returns `undefined` at EOF. */
+    read() {
+        if (this.#inner === undefined)
+            return undefined;
+        const chunk = callHost("http.HttpStream.readChunk", () => this.#inner.readChunk());
+        if (chunk.length === 0)
+            return undefined;
+        return chunk;
+    }
+    close() {
+        if (this.#inner === undefined)
+            return;
+        const inner = this.#inner;
+        this.#inner = undefined;
+        try {
+            // Explicit close mirrors the WIT-defined `.close()`; the Drop step still
+            // runs on resource release regardless.
+            inner.close();
+        }
+        catch {
+            // idempotent close — host may have already released it.
+        }
+        try {
+            inner[Symbol.dispose]();
+        }
+        catch {
+            // already released
+        }
+    }
+    [Symbol.dispose]() {
+        this.close();
+    }
+    /** Async iterator that yields each chunk until EOF. Auto-closes on completion. */
+    async *[Symbol.asyncIterator]() {
+        try {
+            while (true) {
+                const chunk = this.read();
+                if (chunk === undefined)
+                    return;
+                yield chunk;
+            }
+        }
+        finally {
+            this.close();
+        }
+    }
+}
+export function streamStart(req) {
+    const wit = req.toWit();
+    const inner = callHost(`http.streamStart ${req.method} ${req.url}`, () => hostStreamStart(wit));
+    const handle = new HttpStreamHandle(inner);
+    return { handle, status: handle.status, headers: handle.headers };
+}
+export class FetchResponse {
+    status;
+    statusText;
+    headers;
+    url;
+    ok;
+    #body;
+    constructor(url, status, headerEntries, body) {
+        this.url = url;
+        this.status = status;
+        this.statusText = httpStatusText(status);
+        this.headers = new Headers(headerEntries);
+        this.ok = status >= 200 && status < 300;
+        this.#body = body;
+    }
+    async text() {
+        return new TextDecoder().decode(this.#body);
+    }
+    async json() {
+        return JSON.parse(await this.text());
+    }
+    async arrayBuffer() {
+        return this.#body.buffer.slice(this.#body.byteOffset, this.#body.byteOffset + this.#body.byteLength);
+    }
+    async bytes() {
+        return this.#body;
+    }
+}
+export async function fetchPolyfill(url, init = {}) {
+    const req = new Request(init.method ?? "GET", url);
+    if (init.headers) {
+        for (const [k, v] of normalizeHeaders(init.headers)) {
+            req.header(k, v);
+        }
+    }
+    if (init.body !== undefined) {
+        if (typeof init.body === "string") {
+            req.setBody(init.body);
+        }
+        else if (init.body instanceof Uint8Array) {
+            req.setBody(init.body);
+        }
+        else {
+            req.json(init.body);
+        }
+    }
+    const raw = callHost(`fetch ${req.method} ${url}`, () => hostRequest(req.toWit()));
+    return new FetchResponse(url, raw.status, raw.headers.map((h) => [h.key, h.value]), raw.body);
+}
+/** Install the polyfill on `globalThis.fetch`. */
+export function installFetchPolyfill() {
+    globalThis.fetch = fetchPolyfill;
+}
+function normalizeHeaders(input) {
+    if (input instanceof Map)
+        return input.entries();
+    if (Array.isArray(input))
+        return input;
+    return Object.entries(input);
+}
+function httpStatusText(code) {
+    const map = {
+        200: "OK", 201: "Created", 202: "Accepted", 204: "No Content",
+        301: "Moved Permanently", 302: "Found", 304: "Not Modified",
+        400: "Bad Request", 401: "Unauthorized", 403: "Forbidden", 404: "Not Found",
+        409: "Conflict", 422: "Unprocessable Entity", 429: "Too Many Requests",
+        500: "Internal Server Error", 502: "Bad Gateway", 503: "Service Unavailable",
+    };
+    return map[code] ?? "";
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}