disk 0.8.10 → 0.8.11

package/dist/cli.js

@@ -338,6 +338,12 @@ var Tokens = class {
 };
 
 // src/archil.ts
+function isExecMountSpec(m) {
+  return typeof m === "object" && m !== null && "disk" in m;
+}
+function diskIdFromMount(m) {
+  return typeof m === "string" ? m : m.id;
+}
 var Archil = class {
   disks;
   tokens;
@@ -369,7 +375,16 @@ var Archil = class {
   async exec(opts) {
     const disks = {};
     for (const [relPath, mount] of Object.entries(opts.disks)) {
-      disks[relPath] = typeof mount === "string" ? mount : mount.id;
+      if (isExecMountSpec(mount)) {
+        const entry = {
+          disk: diskIdFromMount(mount.disk),
+          readOnly: mount.readOnly ?? false
+        };
+        if (mount.subdirectory !== void 0) entry.subdirectory = mount.subdirectory;
+        disks[relPath] = entry;
+      } else {
+        disks[relPath] = diskIdFromMount(mount);
+      }
     }
     return unwrap(
       this._client.POST("/api/exec", {

package/dist/index.cjs

@@ -381,6 +381,12 @@ var Tokens = class {
 };
 
 // src/archil.ts
+function isExecMountSpec(m) {
+  return typeof m === "object" && m !== null && "disk" in m;
+}
+function diskIdFromMount(m) {
+  return typeof m === "string" ? m : m.id;
+}
 var Archil = class {
   disks;
   tokens;
@@ -412,7 +418,16 @@ var Archil = class {
   async exec(opts) {
     const disks = {};
     for (const [relPath, mount] of Object.entries(opts.disks)) {
-      disks[relPath] = typeof mount === "string" ? mount : mount.id;
+      if (isExecMountSpec(mount)) {
+        const entry = {
+          disk: diskIdFromMount(mount.disk),
+          readOnly: mount.readOnly ?? false
+        };
+        if (mount.subdirectory !== void 0) entry.subdirectory = mount.subdirectory;
+        disks[relPath] = entry;
+      } else {
+        disks[relPath] = diskIdFromMount(mount);
+      }
     }
     return unwrap(
       this._client.POST("/api/exec", {

package/dist/index.d.cts

@@ -711,13 +711,21 @@ interface components {
              * @description Map of relative path under `/mnt/archil` to the disk to mount
              *     there. At least one entry is required. Relative paths must be
              *     non-empty, non-absolute, and contain no `.` or `..` segments.
+             *
+             *     Each value is either a plain disk ID string (mounts the disk's
+             *     root, read-write) or an object that additionally selects a
+             *     subdirectory of the disk and/or marks the mount as read-only.
              * @example {
              *       "data": "dsk-abc123",
-             *       "logs": "dsk-def456"
+             *       "logs": {
+             *         "disk": "dsk-def456",
+             *         "subdirectory": "app/logs",
+             *         "readOnly": true
+             *       }
              *     }
              */
             disks: {
-                [key: string]: string;
+                [key: string]: string | components["schemas"]["ExecMount"];
             };
             /**
              * @description Shell command to execute inside the container
@@ -725,6 +733,26 @@ interface components {
              */
             command: string;
         };
+        ExecMount: {
+            /**
+             * @description Disk ID to mount at this relative path
+             * @example dsk-abc123
+             */
+            disk: string;
+            /**
+             * @description Subdirectory of the disk to expose at the mountpoint. Must be a
+             *     relative path with no `.` or `..` segments. When omitted, the
+             *     disk's root is exposed.
+             * @example app/logs
+             */
+            subdirectory?: string;
+            /**
+             * @description When true, the disk is mounted read-only inside the container.
+             *     Writes against the mount fail with EROFS.
+             * @default false
+             */
+            readOnly: boolean;
+        };
         ApiResponse_Exec: {
             /** @example true */
             success: boolean;
@@ -1344,11 +1372,34 @@ interface ArchilOptions {
     baseUrl?: string;
 }
 /**
- * One disk to mount, identified by a Disk instance or a raw disk id string.
- * Used by Archil#exec — the map key is the relative path under /mnt/archil
- * at which to mount the disk.
+ * Options that apply to a single mounted disk in an exec request.
+ * Use this object form when you need to pin the mount to a subdirectoryectory
+ * of the disk and/or mount it read-only; for the default case (mount
+ * the disk's root, read-write), pass a `Disk` or disk-id string instead.
+ */
+interface ExecMountSpec {
+    /** Disk to mount, by `Disk` instance or raw disk id string. */
+    disk: Disk | string;
+    /**
+     * Subdirectory of the disk to expose at the mountpoint. Must be a
+     * relative path with no `.` or `..` segments. When omitted, the disk's
+     * root is exposed.
+     */
+    subdirectory?: string;
+    /**
+     * When true, mount the disk read-only inside the container. Writes
+     * against the mount fail with EROFS. Defaults to false.
+     */
+    readOnly?: boolean;
+}
+/**
+ * One disk to mount in an exec request. Either a `Disk`/disk-id string
+ * (mounts the disk's root, read-write) or an `ExecMountSpec` object that
+ * additionally selects a subdirectoryectory of the disk and/or marks the mount
+ * as read-only. Used by Archil#exec — the map key is the relative path
+ * under /mnt/archil at which to mount the disk.
  */
-type ExecMount = Disk | string;
+type ExecMount = Disk | string | ExecMountSpec;
 interface ExecOptions {
     /**
      * Disks to mount, keyed by the relative path under `/mnt/archil` at which
@@ -1395,4 +1446,4 @@ declare function deleteApiKey(id: string): Promise<void>;
  */
 declare function exec(opts: ExecOptions): Promise<ExecDiskResult>;
 
-export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecOptions, type ExecRequest, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, exec, getDisk, listApiKeys, listDisks };
+export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecMountSpec, type ExecOptions, type ExecRequest, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, exec, getDisk, listApiKeys, listDisks };

package/dist/index.d.ts

@@ -711,13 +711,21 @@ interface components {
              * @description Map of relative path under `/mnt/archil` to the disk to mount
              *     there. At least one entry is required. Relative paths must be
              *     non-empty, non-absolute, and contain no `.` or `..` segments.
+             *
+             *     Each value is either a plain disk ID string (mounts the disk's
+             *     root, read-write) or an object that additionally selects a
+             *     subdirectory of the disk and/or marks the mount as read-only.
              * @example {
              *       "data": "dsk-abc123",
-             *       "logs": "dsk-def456"
+             *       "logs": {
+             *         "disk": "dsk-def456",
+             *         "subdirectory": "app/logs",
+             *         "readOnly": true
+             *       }
              *     }
              */
             disks: {
-                [key: string]: string;
+                [key: string]: string | components["schemas"]["ExecMount"];
             };
             /**
              * @description Shell command to execute inside the container
@@ -725,6 +733,26 @@ interface components {
              */
             command: string;
         };
+        ExecMount: {
+            /**
+             * @description Disk ID to mount at this relative path
+             * @example dsk-abc123
+             */
+            disk: string;
+            /**
+             * @description Subdirectory of the disk to expose at the mountpoint. Must be a
+             *     relative path with no `.` or `..` segments. When omitted, the
+             *     disk's root is exposed.
+             * @example app/logs
+             */
+            subdirectory?: string;
+            /**
+             * @description When true, the disk is mounted read-only inside the container.
+             *     Writes against the mount fail with EROFS.
+             * @default false
+             */
+            readOnly: boolean;
+        };
         ApiResponse_Exec: {
             /** @example true */
             success: boolean;
@@ -1344,11 +1372,34 @@ interface ArchilOptions {
     baseUrl?: string;
 }
 /**
- * One disk to mount, identified by a Disk instance or a raw disk id string.
- * Used by Archil#exec — the map key is the relative path under /mnt/archil
- * at which to mount the disk.
+ * Options that apply to a single mounted disk in an exec request.
+ * Use this object form when you need to pin the mount to a subdirectoryectory
+ * of the disk and/or mount it read-only; for the default case (mount
+ * the disk's root, read-write), pass a `Disk` or disk-id string instead.
+ */
+interface ExecMountSpec {
+    /** Disk to mount, by `Disk` instance or raw disk id string. */
+    disk: Disk | string;
+    /**
+     * Subdirectory of the disk to expose at the mountpoint. Must be a
+     * relative path with no `.` or `..` segments. When omitted, the disk's
+     * root is exposed.
+     */
+    subdirectory?: string;
+    /**
+     * When true, mount the disk read-only inside the container. Writes
+     * against the mount fail with EROFS. Defaults to false.
+     */
+    readOnly?: boolean;
+}
+/**
+ * One disk to mount in an exec request. Either a `Disk`/disk-id string
+ * (mounts the disk's root, read-write) or an `ExecMountSpec` object that
+ * additionally selects a subdirectoryectory of the disk and/or marks the mount
+ * as read-only. Used by Archil#exec — the map key is the relative path
+ * under /mnt/archil at which to mount the disk.
  */
-type ExecMount = Disk | string;
+type ExecMount = Disk | string | ExecMountSpec;
 interface ExecOptions {
     /**
      * Disks to mount, keyed by the relative path under `/mnt/archil` at which
@@ -1395,4 +1446,4 @@ declare function deleteApiKey(id: string): Promise<void>;
  */
 declare function exec(opts: ExecOptions): Promise<ExecDiskResult>;
 
-export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecOptions, type ExecRequest, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, exec, getDisk, listApiKeys, listDisks };
+export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecMountSpec, type ExecOptions, type ExecRequest, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, exec, getDisk, listApiKeys, listDisks };

package/dist/index.js

@@ -332,6 +332,12 @@ var Tokens = class {
 };
 
 // src/archil.ts
+function isExecMountSpec(m) {
+  return typeof m === "object" && m !== null && "disk" in m;
+}
+function diskIdFromMount(m) {
+  return typeof m === "string" ? m : m.id;
+}
 var Archil = class {
   disks;
   tokens;
@@ -363,7 +369,16 @@ var Archil = class {
   async exec(opts) {
     const disks = {};
     for (const [relPath, mount] of Object.entries(opts.disks)) {
-      disks[relPath] = typeof mount === "string" ? mount : mount.id;
+      if (isExecMountSpec(mount)) {
+        const entry = {
+          disk: diskIdFromMount(mount.disk),
+          readOnly: mount.readOnly ?? false
+        };
+        if (mount.subdirectory !== void 0) entry.subdirectory = mount.subdirectory;
+        disks[relPath] = entry;
+      } else {
+        disks[relPath] = diskIdFromMount(mount);
+      }
     }
     return unwrap(
       this._client.POST("/api/exec", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "disk",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "description": "Pure-JS client and CLI for Archil disks",
   "type": "module",
   "main": "dist/index.cjs",