@silo-code/sdk 0.21.0 → 0.22.0

package/dist/editor-service.d.ts

@@ -1,4 +1,6 @@
 import type { Disposable } from "./types";
+import type { Event } from "./event";
+import type { EditorMode } from "./domain-types";
 /**
  * Options for the editor open methods.
  *
@@ -58,7 +60,7 @@ export interface EditorViewInfo {
     isDefault: boolean;
 }
 /**
- * Save callbacks an editor viewer registers via
+ * Save callbacks an editor registers via
  * {@link EditorService.registerSaveHandler}, so the active-editor `save` /
  * `saveAs` commands can dispatch to whichever editor is focused.
  *
@@ -129,11 +131,75 @@ export interface DiffContentRequest {
  * @public
  */
 export type DiffContentProvider = (request: DiffContentRequest) => Promise<DiffContent>;
+/**
+ * A point-in-time snapshot of the focused editor tab. Part of
+ * {@link EditorsState}, returned by {@link EditorService.getState} and
+ * delivered to {@link EditorService.subscribe} listeners.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ActiveEditorInfo {
+    /** The focused editor tab's record id — matches {@link EditorRecord.id}. */
+    editorId: string;
+    /**
+     * The absolute file path of the focused tab, or `null` for an untitled
+     * buffer.
+     */
+    filePath: string | null;
+    /**
+     * The {@link Editor.id} of the presenter rendering the tab
+     * (e.g. `"core.text-editor"`, `"silo.markdown-preview"`). Empty string
+     * when the presenter could not be resolved (rare: editor registered after
+     * the tab was opened).
+     */
+    viewId: string;
+    /** Whether the tab is in text or diff mode. */
+    mode: EditorMode;
+}
+/**
+ * A frozen, referentially-stable snapshot of editor domain state. Returned by
+ * {@link EditorService.getState} and delivered to
+ * {@link EditorService.subscribe} listeners.
+ *
+ * Compatible with `useServiceState` — just pass `ctx.editors` directly.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface EditorsState {
+    /**
+     * The focused editor tab, or `null` when the active dock panel is not an
+     * editor tab (e.g. a terminal, a dock panel kind, or nothing at all).
+     */
+    active: ActiveEditorInfo | null;
+    /**
+     * `true` once the persisted workspace state has loaded from disk. Matches
+     * `WorkspaceState.hydrated` — guard state-restoring code on this flag.
+     */
+    hydrated: boolean;
+}
+/**
+ * Payload delivered to {@link EditorService.onDidSave} listeners after an
+ * editor tab's contents are written to disk.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface EditorSaveEvent {
+    /** The saved tab's editor record id — matches {@link EditorRecord.id}. */
+    editorId: string;
+    /**
+     * Absolute path the contents were written to. For a save-as (or first save
+     * of an untitled buffer) this is the newly chosen path, not the old one.
+     */
+    filePath: string;
+}
 /**
  * The editor & document domain, exposed as {@link ExtensionContext.editors}.
  * Open files into editor tabs, drive the active editor (save / close), and let
- * editor viewers register save handlers. The single entry point for opening
- * editors — prefer it over reaching into workspace/editor state.
+ * editors register save handlers. The single entry point for opening editors —
+ * prefer it over reaching into workspace/editor state.
  *
  * @category Consumer Services
  * @public
@@ -189,5 +255,71 @@ export interface EditorService {
      * through this provider, on every mount. Dispose to unregister.
      */
     registerDiffContentProvider(providerId: string, provider: DiffContentProvider): Disposable;
+    /**
+     * The current buffer text of an open editor tab, including unsaved edits.
+     *
+     * Resolves `undefined` when the tab isn't text-backed (e.g. the image
+     * viewer) or hasn't mounted yet — a lazy-mounted dock panel is **not**
+     * force-mounted to read its text. It is async precisely because the text
+     * lives in the mounted editor component, not in host state.
+     *
+     * @example
+     * ```ts
+     * const text = await ctx.editors.getText(editorId);
+     * if (text !== undefined) ctx.log.info(`${text.length} chars`);
+     * ```
+     */
+    getText(editorId: string): Promise<string | undefined>;
+    /**
+     * Whether an open editor tab has unsaved changes. Returns `false` for an
+     * unknown id or a tab that isn't mounted / text-backed.
+     */
+    isDirty(editorId: string): boolean;
+    /**
+     * Fires after an editor tab's contents are saved to disk — a formatter,
+     * linter, or build-on-save extension's entry point. See {@link Event}.
+     *
+     * @example
+     * ```ts
+     * ctx.subscriptions.push(
+     *   ctx.editors.onDidSave(({ editorId, filePath }) => {
+     *     ctx.log.info(`saved ${filePath}`);
+     *   }),
+     * );
+     * ```
+     */
+    onDidSave: Event<EditorSaveEvent>;
+    /**
+     * Current frozen snapshot of editor state. The returned object is
+     * referentially stable between renders — `getState() === getState()` when
+     * nothing has changed, which satisfies `useSyncExternalStore`'s contract and
+     * means `useServiceState(ctx.editors)` works without extra memoization.
+     *
+     * @example
+     * ```ts
+     * const { active } = ctx.editors.getState();
+     * if (active) ctx.log.info(`Active file: ${active.filePath ?? "(untitled)"}`);
+     * ```
+     */
+    getState(): EditorsState;
+    /**
+     * Subscribe to changes in the active editor. The listener is called whenever
+     * `active` changes (tab focus moves, workspace switches, editor opens or
+     * closes) or `hydrated` flips. Returns a {@link Disposable} that cancels the
+     * subscription.
+     *
+     * Use `useServiceState(ctx.editors)` in React components instead of calling
+     * `subscribe` directly — it wraps `getState` + `subscribe` for you.
+     *
+     * @example
+     * ```ts
+     * ctx.subscriptions.push(
+     *   ctx.editors.subscribe(({ active }) => {
+     *     statusItem.setTitle(active?.filePath ?? "No file");
+     *   }),
+     * );
+     * ```
+     */
+    subscribe(listener: (state: EditorsState) => void): Disposable;
 }
 //# sourceMappingURL=editor-service.d.ts.map

package/dist/editor-service.d.ts.map

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

package/dist/event.d.ts

@@ -0,0 +1,28 @@
+import type { Disposable } from "./types";
+/**
+ * A subscribable event: call it with a listener and receive a
+ * {@link Disposable} that cancels the subscription. Modeled on VS Code's
+ * `Event<T>` convention.
+ *
+ * Services that emit events expose a member typed as `Event<T>` — the
+ * consuming extension calls it directly and pushes the returned disposable
+ * onto `ctx.subscriptions`:
+ *
+ * @example
+ * ```ts
+ * ctx.subscriptions.push(
+ *   ctx.editors.onDidSave(({ editorId, filePath }) => {
+ *     console.log("saved", filePath);
+ *   }),
+ * );
+ * ```
+ *
+ * **Host-side:** the matching emitter (`EventEmitter<T>`) lives in the
+ * extension-host package (not the SDK). Only the subscribable `Event<T>` type
+ * is public — extensions never construct emitters.
+ *
+ * @category Core Types
+ * @public
+ */
+export type Event<T> = (listener: (e: T) => void) => Disposable;
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,KAAK,UAAU,CAAC"}

package/dist/event.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":""}

package/dist/file-service.d.ts

@@ -74,15 +74,46 @@ export interface FileService {
     readBytes(path: string): Promise<ArrayBuffer>;
     /** List a directory's immediate entries. */
     readDir(path: string): Promise<FileMeta[]>;
-    /** Resolve true if a file or directory exists at `path`. */
+    /**
+     * Resolve true if a file or directory exists at `path`. Prefer
+     * {@link FileService.stat} when you also need the entry's metadata — `stat`
+     * returning non-`null` subsumes this check in one call.
+     */
     pathExists(path: string): Promise<boolean>;
+    /**
+     * Metadata for a single path, following symlinks, or `null` if nothing
+     * exists there. Resolving `null` (rather than rejecting) for an absent path
+     * is deliberate — it makes `stat` a one-call replacement for
+     * {@link FileService.pathExists} that also returns size / mtime / type.
+     * Rejects only on a real I/O error (e.g. a permission failure).
+     */
+    stat(path: string): Promise<FileMeta | null>;
     /** Write UTF-8 text to a file, creating or overwriting it. */
     writeText(path: string, content: string): Promise<void>;
+    /**
+     * Write raw bytes to a file, creating or overwriting it (and creating any
+     * missing parent directories). The byte-oriented counterpart to
+     * {@link FileService.writeText} / {@link FileService.readBytes} — use it for
+     * binary assets (images, archives) where `writeText` would corrupt the data.
+     */
+    writeBytes(path: string, data: ArrayBuffer | Uint8Array): Promise<void>;
     /** Create a directory (and any missing parents). */
     createDir(path: string): Promise<void>;
+    /**
+     * Copy a file or directory from `src` to `dest`, recursively for
+     * directories, creating any missing parent directories. Requires read access
+     * to `src` and write access to `dest` (both are workspace-scoped). Overwrites
+     * existing files at the destination.
+     */
+    copy(src: string, dest: string): Promise<void>;
     /** Rename / move a file or directory. */
     rename(oldPath: string, newPath: string): Promise<void>;
-    /** Delete a file or directory. */
+    /**
+     * **Permanently** delete a file or directory (directories are removed
+     * recursively). This does **not** move the entry to the OS trash/recycle
+     * bin — the delete is irreversible, so confirm destructive removals with the
+     * user first. Rejects if the path does not exist.
+     */
     delete(path: string): Promise<void>;
     /** Reveal a path in the OS file manager (Finder / Explorer). */
     reveal(path: string): Promise<void>;

package/dist/file-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../src/file-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,+BAA+B;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,4DAA4D;IAC5D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yCAAyC;IACzC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,UAAU,CAAC;CAC7E"}
+{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../src/file-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,+BAA+B;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,yCAAyC;IACzC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,UAAU,CAAC;CAC7E"}

package/dist/index.d.ts

@@ -1,10 +1,16 @@
 /**
- * The public Silo extension API surface — the single curated entry point an
- * extension author imports from. This is the seed of the future `@silo-code/sdk`
- * package: it re-exports **only** the blessed, permanently supported types.
- * Anything not re-exported here is host-internal and may change without notice.
+ * The `@silo-code/sdk` public surface — the single curated entry point an
+ * extension author imports from. Re-exports **only** the blessed, permanently
+ * supported types and runtime helpers. Anything not re-exported here is
+ * host-internal and may change without notice.
  *
- * It is also the entry point the API-reference generator (TypeDoc) reads, so
+ * **What's here:** the types-first extension contract (see `types.ts`) plus a
+ * small set of blessed runtime helpers (`Tooltip`, `useFocusGroup`,
+ * `useServiceState`, `DND_MIME`, `PathDeniedError`, `NetworkError`). The SDK
+ * peer-depends on React 19; changes to the runtime helpers can be breaking
+ * even when the types are unchanged.
+ *
+ * This is also the entry point the API-reference generator (TypeDoc) reads, so
  * the published reference is exactly this surface — no more, no less.
  *
  * @packageDocumentation
@@ -12,7 +18,7 @@
 export type { Disposable, DockPanelApi, DockPanelProps, EditorProps, EditorCapabilities, Editor, NewFileTemplate, FileType, Command, MenuId, MenuItemContribution, Keybinding, SidePanelProps, SidePanel, DockPanelKind, StatusItem, SettingsPage, ExtensionContext, Extension, ExtensionManifest, ExtensionHandle, } from "./types";
 export type { Workspace, EditorMode, EditorRecord, SidePanelSlot, } from "./domain-types";
 export type { WorkspaceService, WorkspaceState, CreateWorkspaceInput, WorkspaceStatusRow, WorkspaceStatusProvider, WorkspaceSectionProps, WorkspaceSectionProvider, WorkspaceBadge, WorkspaceBadgeProvider, } from "./workspace-service";
-export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo, OpenDiffSpec, DiffContent, DiffContentRequest, DiffContentProvider, } from "./editor-service";
+export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo, OpenDiffSpec, DiffContent, DiffContentRequest, DiffContentProvider, ActiveEditorInfo, EditorsState, EditorSaveEvent, } from "./editor-service";
 export type { LayoutService, LayoutState, SidePanelColumnState, SideLocation, } from "./layout-service";
 export type { ProcessService, ProcessSession, ProcessSpawnOptions, ProcessExecOptions, ProcessExecResult, } from "./process-service";
 export type { ProcessesService, ProcessInfo, ProcessStats, } from "./processes-service";
@@ -27,10 +33,12 @@ export type { DndService, DndItem, DndMime, DragInit, DndMode, DropContext, Drop
 export { DND_MIME } from "./dnd-service";
 export type { UiService, FileFilter, MenuItem, MenuItemTrailing, MenuSeparator, MenuHeader, MenuEntry, ShowMenuOptions, ConfirmOptions, PromptOptions, ModalOptions, NotifyAction, NotifyOptions, } from "./ui-service";
 export { NetworkError } from "./network-service";
-export type { NetworkService, NetworkRequestOptions, NetworkResponse, } from "./network-service";
+export type { NetworkService, NetworkRequestOptions, NetworkResponse, NetworkBytesResponse, } from "./network-service";
 export type { SystemService, SystemInfo } from "./system-service";
 export type { LogService, LogLevel } from "./output-service";
 export type { ContextKeys } from "./context-keys";
+export type { Event } from "./event";
+export { path } from "./path";
 export { Tooltip } from "./Tooltip";
 export { useServiceState } from "./use-service-state";
 export type { ReactiveService } from "./use-service-state";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,10 +1,16 @@
 /**
- * The public Silo extension API surface — the single curated entry point an
- * extension author imports from. This is the seed of the future `@silo-code/sdk`
- * package: it re-exports **only** the blessed, permanently supported types.
- * Anything not re-exported here is host-internal and may change without notice.
+ * The `@silo-code/sdk` public surface — the single curated entry point an
+ * extension author imports from. Re-exports **only** the blessed, permanently
+ * supported types and runtime helpers. Anything not re-exported here is
+ * host-internal and may change without notice.
  *
- * It is also the entry point the API-reference generator (TypeDoc) reads, so
+ * **What's here:** the types-first extension contract (see `types.ts`) plus a
+ * small set of blessed runtime helpers (`Tooltip`, `useFocusGroup`,
+ * `useServiceState`, `DND_MIME`, `PathDeniedError`, `NetworkError`). The SDK
+ * peer-depends on React 19; changes to the runtime helpers can be breaking
+ * even when the types are unchanged.
+ *
+ * This is also the entry point the API-reference generator (TypeDoc) reads, so
  * the published reference is exactly this surface — no more, no less.
  *
  * @packageDocumentation
@@ -13,6 +19,10 @@ export { PathDeniedError } from "./permissions";
 export { DND_MIME } from "./dnd-service";
 // Server-side HTTP client — bypasses CORS, readable response headers.
 export { NetworkError } from "./network-service";
+// Pure path utilities — cross-platform replacement for `node:path` (banned in
+// extensions). All outputs use forward-slash separators. Both "/" and "\" are
+// accepted as input. Exported as a namespaced `path` object.
+export { path } from "./path";
 // Tooltip — the same styled hover popup the host uses in the status bar.
 // Extensions use this instead of native `title` attributes to match host chrome.
 export { Tooltip } from "./Tooltip";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA6BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAoBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBjD,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2GH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA6BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAoBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/network-service.d.ts

@@ -34,8 +34,12 @@ export interface NetworkRequestOptions {
     method?: "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "PATCH";
     /** Request headers to send. */
     headers?: Record<string, string>;
-    /** Request body (string). Only meaningful for methods that carry a body. */
-    body?: string;
+    /**
+     * Request body. A string is sent as-is; an `ArrayBuffer` / `Uint8Array` is
+     * sent as raw bytes (e.g. uploading a file). Only meaningful for methods that
+     * carry a body.
+     */
+    body?: string | ArrayBuffer | Uint8Array;
     /** Follow HTTP redirects. Defaults to `true`. */
     followRedirects?: boolean;
     /** Request timeout in milliseconds. Omit for the platform default (~30 s). */
@@ -60,6 +64,23 @@ export interface NetworkResponse {
     /** Final URL after redirects. */
     finalUrl: string;
 }
+/**
+ * Response from {@link NetworkService.fetchBytes} — identical to
+ * {@link NetworkResponse} but with the body delivered as raw bytes.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface NetworkBytesResponse {
+    /** HTTP status code. */
+    status: number;
+    /** Response headers, lowercased (multi-value joined with `", "`). */
+    headers: Record<string, string>;
+    /** Response body as raw bytes. */
+    body: ArrayBuffer;
+    /** Final URL after redirects. */
+    finalUrl: string;
+}
 /**
  * Server-side HTTP client exposed as {@link ExtensionContext.net}. Requests
  * run in the Rust backend via `reqwest`, so they bypass the browser's CORS
@@ -91,6 +112,29 @@ export interface NetworkService {
      * ```
      */
     fetch(url: string, options?: NetworkRequestOptions): Promise<NetworkResponse>;
+    /**
+     * Like {@link NetworkService.fetch}, but resolves the response body as raw
+     * bytes ({@link NetworkBytesResponse}) instead of decoding it as UTF-8 text —
+     * for downloading images, archives, or any binary payload.
+     *
+     * @param url - The URL to fetch.
+     * @param options - Method, headers, body, redirect and timeout controls. The
+     *   body may itself be binary (`ArrayBuffer` / `Uint8Array`).
+     * @throws {@link NetworkError} if the request fails.
+     *
+     * @remarks
+     * The body rides Tauri's binary IPC channel (no base64), but the whole
+     * response is still buffered in memory on both sides — suitable for typical
+     * asset downloads (up to a few tens of MB), not for streaming multi-hundred-MB
+     * files.
+     *
+     * @example
+     * ```ts
+     * const { body } = await ctx.net.fetchBytes("https://example.com/logo.png");
+     * await ctx.files.writeBytes("logo.png", body);
+     * ```
+     */
+    fetchBytes(url: string, options?: NetworkRequestOptions): Promise<NetworkBytesResponse>;
     /**
      * Send a `HEAD` request and return only the response headers — no body is
      * downloaded. More efficient than {@link NetworkService.fetch} when you only

package/dist/network-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-service.d.ts","sourceRoot":"","sources":["../src/network-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CASzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,WAAW,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC"}
+{"version":3,"file":"network-service.d.ts","sourceRoot":"","sources":["../src/network-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CASzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACzC,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,kCAAkC;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CACR,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,WAAW,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC"}

package/dist/path.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Path utilities for extensions — a cross-platform replacement for
+ * `node:path`, which extensions are banned from importing. All output paths
+ * use forward-slash separators (the form {@link FileService} accepts on every
+ * platform). Both `/` and `\` are accepted as input separators.
+ *
+ * @example
+ * ```ts
+ * import { path } from "@silo-code/sdk";
+ *
+ * const dir  = path.dirname(filePath);            // "/home/user/docs"
+ * const full = path.join(dir, "images/fig.png");  // "/home/user/docs/images/fig.png"
+ * const rel  = path.relative(dir, full);           // "images/fig.png"
+ * const ext  = path.extname(full);                 // ".png"
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export declare const path: {
+    /**
+     * Join path segments and normalize the result. Empty segments are ignored;
+     * `\` separators in any segment are treated as `/`.
+     */
+    join(...parts: string[]): string;
+    /**
+     * Return the directory portion of a path — everything up to (not including)
+     * the last `/`. Returns `"."` for a bare filename with no directory component.
+     */
+    dirname(p: string): string;
+    /**
+     * Return the final component of a path. If `ext` is supplied and the
+     * basename ends with that string, it is stripped from the result.
+     */
+    basename(p: string, ext?: string): string;
+    /**
+     * Return the extension of a path — the portion from the last `.` of the
+     * basename, including the dot. Returns `""` for paths with no extension and
+     * for dotfiles with no secondary extension (e.g. `".gitignore"` → `""`).
+     */
+    extname(p: string): string;
+    /**
+     * Compute the relative path from `from` to `to`. Both should be absolute
+     * paths on the same drive. When they are on different Windows drive letters,
+     * `to` (normalized) is returned unchanged — no relative path exists between
+     * drives.
+     */
+    relative(from: string, to: string): string;
+    /**
+     * Return `true` if `p` is an absolute path: starts with `/` (POSIX), has a
+     * drive letter followed by a slash (`C:/`, `C:\`), or is a UNC path
+     * (`\\server\share` / `//server/share`). Note: `C:foo` (drive-relative,
+     * no slash) is NOT absolute.
+     */
+    isAbsolute(p: string): boolean;
+    /**
+     * Normalize a path: convert `\` to `/`, collapse duplicate slashes, and
+     * resolve `.` and `..` segments.
+     */
+    normalize(p: string): string;
+};
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAiDA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB;;;OAGG;IACH,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CA+E9B,CAAC"}