@dxos/plugin-file 0.10.0 → 0.11.0

package/PLUGIN.mdl

@@ -1,14 +1,16 @@
 ---
 id: org.dxos.plugin.file
 name: FilePlugin
-version: 0.1.0
+version: 0.2.0
 ---
 
 FilePlugin enables DXOS Composer to store and preview binary files — images, videos, and PDFs — as first-class ECHO objects.
-Uploaded bytes are routed through a pluggable backend system: the built-in `inline` backend serialises the file directly
-onto the ECHO document, while external backends (e.g. WNFS) can be contributed by other plugins.
-A URL-resolver capability lets external-storage backends convert opaque storage URIs into renderable blob, data, or HTTP URLs
-at view time, keeping the ECHO object schema backend-agnostic.
+A File object's `data` field is a reference to a `Blob` ECHO object (defined in `@dxos/echo`), which abstracts where the
+bytes actually live and how they're read. Uploads are routed through a pluggable storage system: the built-in `inline`
+storage embeds bytes on the Blob object itself, while external storage (e.g. WNFS, edge) can be contributed by other
+plugins by registering a `BlobBackend` on the ECHO Hypergraph. `Blob.url`/`Blob.read` resolve a renderable URL or raw
+bytes uniformly regardless of backend, so the File schema and preview surfaces stay backend-agnostic without a
+dedicated URL-resolver capability.
 
 ## Extensions
 
@@ -25,55 +27,33 @@ Each extension is defined in the Appendix or resolved via its URI.
 
 ## Types
 
-```mdl
-type FileDataInline
-  desc: File bytes stored directly on the ECHO object.
-  fields:
-    _tag: 'inline'
-    bytes: Uint8Array
-```
-
-```mdl
-type FileDataExternal
-  desc: File bytes stored outside ECHO; referenced by URL.
-  fields:
-    _tag: 'external'
-    url: string
-    cid?: string             # optional content-addressed identifier
-```
-
-```mdl
-type FileData
-  desc: Discriminated union of inline and external storage.
-  literals: FileDataInline | FileDataExternal
-```
-
 ```mdl
 type File
-  desc: ECHO object (typename dxos.org.type.file) representing an uploaded binary asset.
+  desc: ECHO object (typename org.dxos.type.file, version 0.2.0) representing an uploaded binary asset.
   fields:
     name?: string
     type: string             # MIME type
     size: number             # byte count
-    data: FileData
+    data: Ref<Blob>          # reference to a Blob object (org.dxos.type.blob, defined in @dxos/echo)
     timestamp?: string       # ISO 8601 upload time
 ```
 
 ```mdl
-type UploadResult
-  desc: Normalised return value from a Backend.upload call.
+type BackendDescriptor
+  desc: |
+    UI-facing descriptor for a registered storage option. Carries no upload/read behavior itself —
+    that lives in the matching `BlobBackend` registered on the ECHO Hypergraph under `storage`.
   fields:
-    name: string
-    type: string
-    size: number
-    data: FileData
+    name: string               # display label shown in settings
+    description?: string       # description shown next to the backend in settings
+    storage: string             # Blob.fromBytes's `storage` option; also the settings key (e.g. 'inline', 'wnfs', 'edge')
 ```
 
 ```mdl
 type Settings
   desc: Per-user plugin settings stored in the ECHO space.
   fields:
-    backend?: string         # active backend id; defaults to 'inline'
+    backend?: string         # active backend's storage name; defaults to 'inline'
 ```
 
 ## Components
@@ -86,7 +66,7 @@ component FilePreview
     all other types fall back to a download link.
   props:
     type: string             # MIME type
-    url: string              # renderable blob:, data:, or http(s): URL
+    url: string              # renderable data:, blob:, or http(s): URL
   layout: |
     ┌──────────────────────────────┐
     │  <img> / <video> / <iframe>  │
@@ -118,7 +98,7 @@ component FileSettings
     ┌──────────────────────────────┐
     │  Storage backend: [select ▼] │
     │  (one row per registered     │
-    │   backend with description)  │
+    │   BackendDescriptor)         │
     └──────────────────────────────┘
 ```
 
@@ -126,9 +106,11 @@ component FileSettings
 component FileArticle
   desc: |
     Full-viewport article container rendered for article, section, and slide
-    roles. Resolves a renderable URL from the File object via inline blob
-    conversion or registered UrlResolver capabilities, then delegates to
-    FilePreview. Shows an empty state while the URL is resolving.
+    roles. Loads the File's referenced Blob and resolves a renderable URL via
+    Blob.url; if the backend has no getUrl, falls back to Blob.read and
+    constructs a blob: object URL (revoked on unmount). Delegates to
+    FilePreview. Shows an empty state while the URL is resolving or if the
+    File is not attached to a database.
   props:
     role: AppSurface.Role
     subject: File
@@ -147,17 +129,20 @@ component FileArticle
 op Create
   key: org.dxos.plugin.file.operation.create
   desc: |
-    Validates a browser File object (MIME type and size), routes the upload to the
-    active Backend capability, and constructs a File ECHO object from the result.
-    Does not add the object to the space — callers do that separately.
+    Validates a browser File object's MIME type, resolves the active
+    BackendDescriptor, and composes File.fromBytes (which hashes/uploads the
+    bytes via the Blob API and adds the resulting Blob to the database) to
+    construct a File ECHO object. Does not add the File object itself to the
+    space — callers do that separately.
   input:
     file: BrowserFile        # browser File (globalThis.File)
     db: Database
   output: { object: File }
   errors:
     UnsupportedFileTypeError: MIME type is not image/*, video/*, or application/pdf
-    FileTooLargeError: file exceeds the 4 MB inline limit
-    NoBackendError: no Backend capability is registered
+    FileTooLargeError: file exceeds the 4 MB inline limit (only possible when the
+      resolved backend's storage is 'inline'; other backends scale beyond it)
+    NoBackendError: no BackendDescriptor capability is registered
 ```
 
 ## Features
@@ -168,47 +153,57 @@ feat F-1: File upload
   req F-1.1: Accepted MIME types MUST be image/* (jpg, jpeg, png, gif, webp, svg),
     video/* (mp4, webm, mov), and application/pdf only.
 
-  req F-1.2: Maximum upload size MUST be 4 MB for the inline backend.
+  req F-1.2: Maximum upload size MUST be 4 MB when the resolved backend's storage
+    is 'inline'. Other backends (e.g. edge, wnfs) are not subject to this cap.
 
   req F-1.3:
     when: user submits the Create Object form with a valid file
     then:
       - op:Create is invoked with the selected file and active database
       - the resulting File object is added to the space via SpaceOperation.AddObject
-      - FileUploader capability returns metadata to the caller (name, type, url/cid)
+      - FileUploader capability returns metadata to the caller (name, type, and a
+        renderable url resolved via Blob.url, if one is available)
 
   req F-1.4:
     when: file MIME type is not accepted
     then: UnsupportedFileTypeError returned; no ECHO write occurs
 
   req F-1.5:
-    when: file size exceeds the limit
+    when: file size exceeds the limit and the resolved backend's storage is 'inline'
     then: FileTooLargeError returned; no ECHO write occurs
 ```
 
 ```mdl
 feat F-2: Backend capability system
 
-  req F-2.1: Any plugin may contribute a Backend capability. Multiple backends
-    may be registered simultaneously.
+  req F-2.1: Any plugin may contribute a BackendDescriptor capability. Multiple
+    descriptors may be registered simultaneously.
 
-  req F-2.2: The inline backend MUST always be registered by FilePlugin itself.
-    It serialises bytes directly onto the ECHO object.
+  req F-2.2: The inline BackendDescriptor MUST always be registered by FilePlugin
+    itself, mapping to Blob's built-in 'inline' storage (bytes embedded on the
+    Blob object; no separate BlobBackend registration needed).
 
   req F-2.3: The active backend is determined by Settings.backend. If the
     configured id is absent or unrecognised, the inline backend is used.
 
-  req F-2.4: A UrlResolver capability allows external backends to convert an
-    opaque storage URI (e.g. wnfs://…) into a renderable URL at view time.
-    FileArticle iterates registered resolvers and uses the first that matches.
+  req F-2.4: A BackendDescriptor's `storage` names the Blob storage used by
+    File.fromBytes; the actual upload/read/getUrl implementation lives in a
+    separate `BlobBackend` registered on the ECHO Hypergraph (via
+    `client.graph.registerBlobBackend`), typically by the same plugin that
+    contributes the descriptor (e.g. plugin-wnfs, or `@dxos/client` itself for
+    'edge'). FilePlugin's descriptor and the Hypergraph's BlobBackend registry
+    are independent — a descriptor with no matching registered backend fails at
+    upload time with a `backend-not-registered` error, not at settings-selection time.
 ```
 
 ```mdl
 feat F-3: File preview
 
-  req F-3.1: FileArticle MUST resolve a renderable URL before rendering
-    FilePreview. For inline files a blob: URL is created from the stored bytes
-    and revoked on unmount.
+  req F-3.1: FileArticle MUST resolve a renderable URL via Blob.url before
+    rendering FilePreview. For inline files this is always a data: URL
+    (constructed synchronously from the stored bytes, no Blob.read needed). For
+    external files with no registered getUrl, FileArticle falls back to
+    Blob.read and constructs a blob: URL, revoked on unmount.
 
   req F-3.2: FilePreview MUST render the appropriate element for each MIME class:
     image/* → <img>, video/* → <video controls>, application/pdf → <iframe>,
@@ -222,14 +217,16 @@ feat F-3: File preview
 feat F-4: Markdown integration
 
   req F-4.1: A Markdown extension contributed at MarkdownEvents.SetupExtensions
-    MUST allow files to be embedded in Markdown documents as inline attachments.
+    MUST allow files to be embedded in Markdown documents as inline attachments,
+    resolving each embedded File's Blob URL the same way as FileArticle (Blob.url,
+    falling back to Blob.read + blob: URL).
 ```
 
 ```mdl
 feat F-5: Settings
 
-  req F-5.1: The Settings panel MUST list all registered backends with their
-    id, display name, and optional description.
+  req F-5.1: The Settings panel MUST list all registered BackendDescriptor
+    capabilities with their id, display name, and optional description.
 
   req F-5.2: Selecting a backend MUST persist the choice to Settings.backend
     via the SettingsAtom capability.
@@ -239,17 +236,17 @@ feat F-5: Settings
 
 ```mdl
 test T-1: Upload image inline
-  given: only the inline backend is registered
+  given: only the inline BackendDescriptor is registered
   when: user uploads a 1 MB PNG via the Create Object form
   then:
-    - op:Create returns a File with data._tag === 'inline'
+    - op:Create returns a File whose data Ref resolves to a Blob with data._tag === 'inline'
     - File.type === 'image/png', File.size === byte count
     - File is added to the space
 ```
 
 ```mdl
 test T-2: Reject oversized file
-  given: inline backend registered, 4 MB limit
+  given: inline backend selected, 4 MB limit
   when: user uploads a 5 MB JPEG
   then:
     - FileTooLargeError is returned
@@ -268,41 +265,53 @@ test T-3: Reject unsupported MIME type
 
 ```mdl
 test T-4: Preview inline image
-  given: a File with data._tag === 'inline' and type === 'image/png'
+  given: a File whose data Ref resolves to a Blob with data._tag === 'inline' and type === 'image/png'
   when: FileArticle is rendered
   then:
-    - a blob: URL is created from File.data.bytes
+    - Blob.url resolves a data: URL synchronously from the Blob's bytes (no Blob.read call)
     - FilePreview renders an <img> element with that URL
-    - the blob: URL is revoked on unmount
 ```
 
 ```mdl
 test T-5: Preview PDF
-  given: a File with type === 'application/pdf' and a resolved HTTP URL
+  given: a File with type === 'application/pdf' and a Blob resolved to an HTTP or data URL
   when: FilePreview is rendered
   then: an <iframe> element is rendered with the file URL as src
 ```
 
 ```mdl
 test T-6: Backend fallback to inline
-  given: Settings.backend is 'wnfs' but no WNFS backend is registered
+  given: Settings.backend is 'wnfs' but no BackendDescriptor with storage 'wnfs' is registered
   when: op:Create is invoked
   then: the inline backend is used and the file is stored inline
 ```
 
 ```mdl
-test T-7: External URL resolved by UrlResolver
-  given: a File with data._tag === 'external' and data.url === 'wnfs://cid/file.jpg'
-  and: a UrlResolver capability registered that handles 'wnfs://' URIs
+test T-7: External blob resolved via a registered BlobBackend's getUrl
+  given: a File whose data Ref resolves to a Blob with data._tag === 'external' and a
+    BlobBackend registered on the ECHO Hypergraph that resolves the Blob's URI scheme
+    and implements getUrl
   when: FileArticle is rendered
   then:
-    - UrlResolver.resolve is called with the wnfs:// URL
+    - Blob.url calls the registered backend's getUrl and resolves Some(url)
     - FilePreview receives the resolved renderable URL
+    - Blob.read is never called
+```
+
+```mdl
+test T-8: External blob without getUrl falls back to reading bytes
+  given: a File whose data Ref resolves to an external Blob whose registered
+    BlobBackend implements get but not getUrl
+  when: FileArticle is rendered
+  then:
+    - Blob.url resolves None
+    - Blob.read is called to fetch the bytes
+    - a blob: object URL is created from the bytes and revoked on unmount
 ```
 
 ```mdl
-test T-8: No backend error
-  given: no Backend capability is registered
+test T-9: No backend error
+  given: no BackendDescriptor capability is registered
   when: op:Create is invoked
   then: NoBackendError is returned
 ```

package/dist/lib/FilePlugin.mjs

@@ -0,0 +1,37 @@
+import { meta } from "#meta";
+import { Plugin } from "@dxos/app-framework";
+import { Blob } from "@dxos/echo";
+import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
+import { ClientEvents } from "@dxos/plugin-client";
+import { MarkdownEvents } from "@dxos/plugin-markdown";
+import { CreateObject, EdgeBackend, FileUploader, InlineBackend, Markdown, OperationHandler, ReactSurface, Settings, SkillDefinition } from "#capabilities";
+import { translations } from "#translations";
+import { File } from "#types";
+//#endregion
+//#region src/FilePlugin.tsx
+var FilePlugin = Plugin.define(meta).pipe(AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }), AppPlugin.addCreateObjectModule({ activate: CreateObject }), AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addSchemaModule({ schema: [File.File, Blob.Blob] }), AppPlugin.addSettingsModule({ activate: Settings }), AppPlugin.addSurfaceModule({ activate: ReactSurface }), AppPlugin.addTranslationsModule({ translations }), Plugin.addModule({
+	id: "inline-backend",
+	activatesOn: AppActivationEvents.SetupSchema,
+	activate: InlineBackend
+}), Plugin.addModule({
+	id: "file-uploader",
+	activatesOn: ClientEvents.ClientReady,
+	activate: FileUploader
+}), Plugin.addModule({
+	id: "edge-backend",
+	activatesOn: ClientEvents.ClientReady,
+	activate: EdgeBackend
+}), Plugin.addModule({
+	id: "markdown",
+	activatesOn: MarkdownEvents.SetupExtensions,
+	activate: Markdown
+}), AppPlugin.addPluginAssetModule({ asset: {
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: "---\nid: org.dxos.plugin.file\nname: FilePlugin\nversion: 0.2.0\n---\n\nFilePlugin enables DXOS Composer to store and preview binary files — images, videos, and PDFs — as first-class ECHO objects.\nA File object's `data` field is a reference to a `Blob` ECHO object (defined in `@dxos/echo`), which abstracts where the\nbytes actually live and how they're read. Uploads are routed through a pluggable storage system: the built-in `inline`\nstorage embeds bytes on the Blob object itself, while external storage (e.g. WNFS, edge) can be contributed by other\nplugins by registering a `BlobBackend` on the ECHO Hypergraph. `Blob.url`/`Blob.read` resolve a renderable URL or raw\nbytes uniformly regardless of backend, so the File schema and preview surfaces stay backend-agnostic without a\ndedicated URL-resolver capability.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype File\n  desc: ECHO object (typename org.dxos.type.file, version 0.2.0) representing an uploaded binary asset.\n  fields:\n    name?: string\n    type: string             # MIME type\n    size: number             # byte count\n    data: Ref<Blob>          # reference to a Blob object (org.dxos.type.blob, defined in @dxos/echo)\n    timestamp?: string       # ISO 8601 upload time\n```\n\n```mdl\ntype BackendDescriptor\n  desc: |\n    UI-facing descriptor for a registered storage option. Carries no upload/read behavior itself —\n    that lives in the matching `BlobBackend` registered on the ECHO Hypergraph under `storage`.\n  fields:\n    name: string               # display label shown in settings\n    description?: string       # description shown next to the backend in settings\n    storage: string             # Blob.fromBytes's `storage` option; also the settings key (e.g. 'inline', 'wnfs', 'edge')\n```\n\n```mdl\ntype Settings\n  desc: Per-user plugin settings stored in the ECHO space.\n  fields:\n    backend?: string         # active backend's storage name; defaults to 'inline'\n```\n\n## Components\n\n```mdl\ncomponent FilePreview\n  desc: |\n    Renders a File object using the appropriate HTML element for its MIME type.\n    Images use <img>, videos use <video controls>, PDFs use <iframe>, and\n    all other types fall back to a download link.\n  props:\n    type: string             # MIME type\n    url: string              # renderable data:, blob:, or http(s): URL\n  layout: |\n    ┌──────────────────────────────┐\n    │  <img> / <video> / <iframe>  │\n    │  or [Download file] link     │\n    └──────────────────────────────┘\n```\n\n```mdl\ncomponent FileInput\n  desc: Drag-and-drop / browse file picker used inside the Create Object form.\n  props:\n    schema: Schema           # effect/Schema with UploadAnnotation on the file field\n  emits:\n    onChange(file: File)\n  layout: |\n    ┌──────────────────────────────┐\n    │  [ Drop file or click here ] │\n    └──────────────────────────────┘\n```\n\n```mdl\ncomponent FileSettings\n  desc: Plugin settings panel rendered in the Composer settings surface.\n  props:\n    settings: Settings\n  emits:\n    onSettingsChange(settings: Settings)\n  layout: |\n    ┌──────────────────────────────┐\n    │  Storage backend: [select ▼] │\n    │  (one row per registered     │\n    │   BackendDescriptor)         │\n    └──────────────────────────────┘\n```\n\n```mdl\ncomponent FileArticle\n  desc: |\n    Full-viewport article container rendered for article, section, and slide\n    roles. Loads the File's referenced Blob and resolves a renderable URL via\n    Blob.url; if the backend has no getUrl, falls back to Blob.read and\n    constructs a blob: object URL (revoked on unmount). Delegates to\n    FilePreview. Shows an empty state while the URL is resolving or if the\n    File is not attached to a database.\n  props:\n    role: AppSurface.Role\n    subject: File\n  layout: |\n    ┌──────────────────────────────┐\n    │                              │\n    │      FilePreview             │\n    │      (fills container)       │\n    │                              │\n    └──────────────────────────────┘\n```\n\n## Operations\n\n```mdl\nop Create\n  key: org.dxos.plugin.file.operation.create\n  desc: |\n    Validates a browser File object's MIME type, resolves the active\n    BackendDescriptor, and composes File.fromBytes (which hashes/uploads the\n    bytes via the Blob API and adds the resulting Blob to the database) to\n    construct a File ECHO object. Does not add the File object itself to the\n    space — callers do that separately.\n  input:\n    file: BrowserFile        # browser File (globalThis.File)\n    db: Database\n  output: { object: File }\n  errors:\n    UnsupportedFileTypeError: MIME type is not image/*, video/*, or application/pdf\n    FileTooLargeError: file exceeds the 4 MB inline limit (only possible when the\n      resolved backend's storage is 'inline'; other backends scale beyond it)\n    NoBackendError: no BackendDescriptor capability is registered\n```\n\n## Features\n\n```mdl\nfeat F-1: File upload\n\n  req F-1.1: Accepted MIME types MUST be image/* (jpg, jpeg, png, gif, webp, svg),\n    video/* (mp4, webm, mov), and application/pdf only.\n\n  req F-1.2: Maximum upload size MUST be 4 MB when the resolved backend's storage\n    is 'inline'. Other backends (e.g. edge, wnfs) are not subject to this cap.\n\n  req F-1.3:\n    when: user submits the Create Object form with a valid file\n    then:\n      - op:Create is invoked with the selected file and active database\n      - the resulting File object is added to the space via SpaceOperation.AddObject\n      - FileUploader capability returns metadata to the caller (name, type, and a\n        renderable url resolved via Blob.url, if one is available)\n\n  req F-1.4:\n    when: file MIME type is not accepted\n    then: UnsupportedFileTypeError returned; no ECHO write occurs\n\n  req F-1.5:\n    when: file size exceeds the limit and the resolved backend's storage is 'inline'\n    then: FileTooLargeError returned; no ECHO write occurs\n```\n\n```mdl\nfeat F-2: Backend capability system\n\n  req F-2.1: Any plugin may contribute a BackendDescriptor capability. Multiple\n    descriptors may be registered simultaneously.\n\n  req F-2.2: The inline BackendDescriptor MUST always be registered by FilePlugin\n    itself, mapping to Blob's built-in 'inline' storage (bytes embedded on the\n    Blob object; no separate BlobBackend registration needed).\n\n  req F-2.3: The active backend is determined by Settings.backend. If the\n    configured id is absent or unrecognised, the inline backend is used.\n\n  req F-2.4: A BackendDescriptor's `storage` names the Blob storage used by\n    File.fromBytes; the actual upload/read/getUrl implementation lives in a\n    separate `BlobBackend` registered on the ECHO Hypergraph (via\n    `client.graph.registerBlobBackend`), typically by the same plugin that\n    contributes the descriptor (e.g. plugin-wnfs, or `@dxos/client` itself for\n    'edge'). FilePlugin's descriptor and the Hypergraph's BlobBackend registry\n    are independent — a descriptor with no matching registered backend fails at\n    upload time with a `backend-not-registered` error, not at settings-selection time.\n```\n\n```mdl\nfeat F-3: File preview\n\n  req F-3.1: FileArticle MUST resolve a renderable URL via Blob.url before\n    rendering FilePreview. For inline files this is always a data: URL\n    (constructed synchronously from the stored bytes, no Blob.read needed). For\n    external files with no registered getUrl, FileArticle falls back to\n    Blob.read and constructs a blob: URL, revoked on unmount.\n\n  req F-3.2: FilePreview MUST render the appropriate element for each MIME class:\n    image/* → <img>, video/* → <video controls>, application/pdf → <iframe>,\n    other → <a download>.\n\n  req F-3.3: FileArticle surfaces are registered for article, section,\n    and slide roles so files embed correctly in Markdown and Presenter layouts.\n```\n\n```mdl\nfeat F-4: Markdown integration\n\n  req F-4.1: A Markdown extension contributed at MarkdownEvents.SetupExtensions\n    MUST allow files to be embedded in Markdown documents as inline attachments,\n    resolving each embedded File's Blob URL the same way as FileArticle (Blob.url,\n    falling back to Blob.read + blob: URL).\n```\n\n```mdl\nfeat F-5: Settings\n\n  req F-5.1: The Settings panel MUST list all registered BackendDescriptor\n    capabilities with their id, display name, and optional description.\n\n  req F-5.2: Selecting a backend MUST persist the choice to Settings.backend\n    via the SettingsAtom capability.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Upload image inline\n  given: only the inline BackendDescriptor is registered\n  when: user uploads a 1 MB PNG via the Create Object form\n  then:\n    - op:Create returns a File whose data Ref resolves to a Blob with data._tag === 'inline'\n    - File.type === 'image/png', File.size === byte count\n    - File is added to the space\n```\n\n```mdl\ntest T-2: Reject oversized file\n  given: inline backend selected, 4 MB limit\n  when: user uploads a 5 MB JPEG\n  then:\n    - FileTooLargeError is returned\n    - no File object is created\n    - no ECHO write occurs\n```\n\n```mdl\ntest T-3: Reject unsupported MIME type\n  given: inline backend registered\n  when: user uploads a .zip file\n  then:\n    - UnsupportedFileTypeError is returned\n    - no File object is created\n```\n\n```mdl\ntest T-4: Preview inline image\n  given: a File whose data Ref resolves to a Blob with data._tag === 'inline' and type === 'image/png'\n  when: FileArticle is rendered\n  then:\n    - Blob.url resolves a data: URL synchronously from the Blob's bytes (no Blob.read call)\n    - FilePreview renders an <img> element with that URL\n```\n\n```mdl\ntest T-5: Preview PDF\n  given: a File with type === 'application/pdf' and a Blob resolved to an HTTP or data URL\n  when: FilePreview is rendered\n  then: an <iframe> element is rendered with the file URL as src\n```\n\n```mdl\ntest T-6: Backend fallback to inline\n  given: Settings.backend is 'wnfs' but no BackendDescriptor with storage 'wnfs' is registered\n  when: op:Create is invoked\n  then: the inline backend is used and the file is stored inline\n```\n\n```mdl\ntest T-7: External blob resolved via a registered BlobBackend's getUrl\n  given: a File whose data Ref resolves to a Blob with data._tag === 'external' and a\n    BlobBackend registered on the ECHO Hypergraph that resolves the Blob's URI scheme\n    and implements getUrl\n  when: FileArticle is rendered\n  then:\n    - Blob.url calls the registered backend's getUrl and resolves Some(url)\n    - FilePreview receives the resolved renderable URL\n    - Blob.read is never called\n```\n\n```mdl\ntest T-8: External blob without getUrl falls back to reading bytes\n  given: a File whose data Ref resolves to an external Blob whose registered\n    BlobBackend implements get but not getUrl\n  when: FileArticle is rendered\n  then:\n    - Blob.url resolves None\n    - Blob.read is called to fetch the bytes\n    - a blob: object URL is created from the bytes and revoked on unmount\n```\n\n```mdl\ntest T-9: No backend error\n  given: no BackendDescriptor capability is registered\n  when: op:Create is invoked\n  then: NoBackendError is returned\n```\n\n---\n\n## Appendix: Extension Definitions\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: A named operation with typed inputs, outputs, and declared errors.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n",
+	mimeType: "application/x-mdl"
+} }), Plugin.make);
+//#endregion
+export { FilePlugin, FilePlugin as default };
+
+//# sourceMappingURL=FilePlugin.mjs.map

package/dist/lib/FilePlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePlugin.mjs","names":[],"sources":["../../src/FilePlugin.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\nimport { Blob } from '@dxos/echo';\nimport { ClientEvents } from '@dxos/plugin-client';\nimport { MarkdownEvents } from '@dxos/plugin-markdown';\n\nimport {\n  CreateObject,\n  EdgeBackend,\n  FileUploader,\n  InlineBackend,\n  Markdown,\n  OperationHandler,\n  ReactSurface,\n  Settings,\n  SkillDefinition,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { File } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const FilePlugin = Plugin.define(meta).pipe(\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSchemaModule({ schema: [File.File, Blob.Blob] }),\n  AppPlugin.addSettingsModule({ activate: Settings }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    id: 'inline-backend',\n    activatesOn: AppActivationEvents.SetupSchema,\n    activate: InlineBackend,\n  }),\n  Plugin.addModule({\n    id: 'file-uploader',\n    activatesOn: ClientEvents.ClientReady,\n    activate: FileUploader,\n  }),\n  Plugin.addModule({\n    id: 'edge-backend',\n    activatesOn: ClientEvents.ClientReady,\n    activate: EdgeBackend,\n  }),\n  Plugin.addModule({\n    id: 'markdown',\n    activatesOn: MarkdownEvents.SetupExtensions,\n    activate: Markdown,\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default FilePlugin;\n"],"mappings":";;;;;;;;;;;AA4BA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAC5C,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,gBAAgB,EAAE,QAAQ,CAAC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,GAC5D,UAAU,kBAAkB,EAAE,UAAU,SAAS,CAAC,GAClD,UAAU,iBAAiB,EAAE,UAAU,aAAa,CAAC,GACrD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,oBAAoB;CACjC,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,aAAa;CAC1B,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,aAAa;CAC1B,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,eAAe;CAC5B,UAAU;AACZ,CAAC,GACD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT"}

package/dist/lib/FilePlugin.node.mjs

@@ -0,0 +1,12 @@
+import { meta } from "#meta";
+import { Plugin } from "@dxos/app-framework";
+import { Blob } from "@dxos/echo";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { CreateObject, OperationHandler } from "#capabilities";
+import { File } from "#types";
+//#region src/FilePlugin.node.ts
+var FilePlugin = Plugin.define(meta).pipe(AppPlugin.addCreateObjectModule({ activate: CreateObject }), AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addSchemaModule({ schema: [File.File, Blob.Blob] }), Plugin.make);
+//#endregion
+export { FilePlugin, FilePlugin as default };
+
+//# sourceMappingURL=FilePlugin.node.mjs.map

package/dist/lib/FilePlugin.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePlugin.node.mjs","names":[],"sources":["../../src/FilePlugin.node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\nimport { Blob } from '@dxos/echo';\n\nimport { CreateObject, OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\nimport { File } from '#types';\n\nexport const FilePlugin = Plugin.define(meta).pipe(\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSchemaModule({ schema: [File.File, Blob.Blob] }),\n  Plugin.make,\n);\n\nexport default FilePlugin;\n"],"mappings":";;;;;;;AAYA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAC5C,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,gBAAgB,EAAE,QAAQ,CAAC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,GAC5D,OAAO,IACT"}

package/dist/lib/capabilities/node.mjs

@@ -0,0 +1,8 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/node.ts
+var CreateObject = Capability.lazy("CreateObject", () => import("../chunk-create-object.mjs"));
+var OperationHandler = Capability.lazy("OperationHandler", () => import("../chunk-operation-handler.mjs"));
+//#endregion
+export { CreateObject, OperationHandler };
+
+//# sourceMappingURL=node.mjs.map

package/dist/lib/capabilities/node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.mjs","names":[],"sources":["../../../src/capabilities/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport { OperationHandlerSet } from '@dxos/compute';\n\n// The capabilities `FilePlugin.node` activates, and only those. `Capability.lazy` defers the\n// import at runtime but a bundler still walks it, so listing the React surfaces here would pull\n// the plugin's components into every node and bun build.\n\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\n"],"mappings":";;AAWA,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,6BAAkB;AAC3F,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,iCACf"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,15 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/index.ts
+var SkillDefinition = Capability.lazy("SkillDefinition", () => import("./chunk-skill-definition.mjs"));
+var CreateObject = Capability.lazy("CreateObject", () => import("./chunk-create-object.mjs"));
+var EdgeBackend = Capability.lazy("EdgeBackend", () => import("./chunk-edge-backend.mjs"));
+var FileUploader = Capability.lazy("FileUploader", () => import("./chunk-file-uploader.mjs"));
+var InlineBackend = Capability.lazy("InlineBackend", () => import("./chunk-inline-backend.mjs"));
+var Markdown = Capability.lazy("MarkdownExtension", () => import("./chunk-markdown-extension.mjs"));
+var OperationHandler = Capability.lazy("OperationHandler", () => import("./chunk-operation-handler.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
+var Settings = Capability.lazy("Settings", () => import("./chunk-settings.mjs"));
+//#endregion
+export { CreateObject, EdgeBackend, FileUploader, InlineBackend, Markdown, OperationHandler, ReactSurface, Settings, SkillDefinition };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport { OperationHandlerSet } from '@dxos/compute';\n\nexport const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const EdgeBackend = Capability.lazy('EdgeBackend', () => import('./edge-backend'));\nexport const FileUploader = Capability.lazy('FileUploader', () => import('./file-uploader'));\nexport const InlineBackend = Capability.lazy('InlineBackend', () => import('./inline-backend'));\nexport const Markdown = Capability.lazy('MarkdownExtension', () => import('./markdown-extension'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\nexport const Settings = Capability.lazy('Settings', () => import('./settings'));\n"],"mappings":";;AAOA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,+BAAqB;AACpG,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,cAAc,WAAW,KAAK,qBAAqB,OAAO,2BAAiB;AACxF,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,gBAAgB,WAAW,KAAK,uBAAuB,OAAO,6BAAmB;AAC9F,IAAa,WAAW,WAAW,KAAK,2BAA2B,OAAO,iCAAuB;AACjG,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,gCACf;AACA,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,WAAW,WAAW,KAAK,kBAAkB,OAAO,uBAAa"}

package/dist/lib/chunk-FileArticle.mjs

@@ -0,0 +1,62 @@
+import { Blob, Database, Obj } from "@dxos/echo";
+import { useEffect, useState } from "react";
+import { EffectEx } from "@dxos/effect";
+import { Panel } from "@dxos/react-ui";
+import { jsx } from "react/jsx-runtime";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { FilePreview } from "#components";
+//#region src/containers/FileArticle/FileArticle.tsx
+var FileArticle = ({ role, subject: file }) => {
+	const [rendered, setRendered] = useState(void 0);
+	useEffect(() => {
+		setRendered(void 0);
+		const db = Obj.getDatabase(file);
+		if (!db) return;
+		let cancelled = false;
+		let createdBlobUrl;
+		const program = Effect.gen(function* () {
+			const blob = yield* Database.load(file.data);
+			const type = blob.type ?? "application/octet-stream";
+			const urlOption = yield* Blob.url(blob);
+			if (Option.isSome(urlOption)) return {
+				url: urlOption.value,
+				type
+			};
+			const bytes = yield* Blob.read(blob);
+			return {
+				url: URL.createObjectURL(new globalThis.Blob([bytes], { type })),
+				type
+			};
+		}).pipe(Effect.provide(Database.layer(db)), Effect.catchAll(() => Effect.succeed(void 0)));
+		EffectEx.runPromise(program).then((result) => {
+			if (cancelled) {
+				if (result?.url.startsWith("blob:")) URL.revokeObjectURL(result.url);
+				return;
+			}
+			if (result?.url.startsWith("blob:")) createdBlobUrl = result.url;
+			setRendered(result);
+		});
+		return () => {
+			cancelled = true;
+			if (createdBlobUrl) URL.revokeObjectURL(createdBlobUrl);
+		};
+	}, [file.id]);
+	if (!rendered) return null;
+	return /* @__PURE__ */ jsx(Panel.Root, {
+		role,
+		classNames: "dx-document",
+		children: /* @__PURE__ */ jsx(Panel.Content, {
+			asChild: true,
+			children: /* @__PURE__ */ jsx(FilePreview, {
+				type: rendered.type,
+				url: rendered.url
+			})
+		})
+	});
+};
+FileArticle.displayName = "FileArticle";
+//#endregion
+export { FileArticle as default };
+
+//# sourceMappingURL=chunk-FileArticle.mjs.map

package/dist/lib/chunk-FileArticle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-FileArticle.mjs","names":[],"sources":["../../src/containers/FileArticle/FileArticle.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\nimport React, { useEffect, useState } from 'react';\n\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Blob, Database, Obj } from '@dxos/echo';\nimport { EffectEx } from '@dxos/effect';\nimport { Panel } from '@dxos/react-ui';\n\nimport { FilePreview } from '#components';\nimport { File } from '#types';\n\nexport type FileArticleProps = AppSurface.ObjectArticleProps<File.File>;\n\nexport const FileArticle = ({ role, subject: file }: FileArticleProps) => {\n  const [rendered, setRendered] = useState<{ url: string; type: string } | undefined>(undefined);\n\n  useEffect(() => {\n    setRendered(undefined);\n\n    const db = Obj.getDatabase(file);\n    if (!db) {\n      return;\n    }\n\n    let cancelled = false;\n    let createdBlobUrl: string | undefined;\n\n    const program = Effect.gen(function* () {\n      const blob = yield* Database.load(file.data);\n      const type = blob.type ?? 'application/octet-stream';\n      const urlOption = yield* Blob.url(blob);\n      if (Option.isSome(urlOption)) {\n        return { url: urlOption.value, type };\n      }\n      const bytes = yield* Blob.read(blob);\n      // `Uint8Array` is generic over `ArrayBufferLike` (incl. `SharedArrayBuffer`) while DOM's\n      // `BlobPart` only covers `ArrayBuffer`-backed views — a gap between the DOM lib types and\n      // the TS standard lib, not fixable by typing `bytes` differently.\n      const url = URL.createObjectURL(new globalThis.Blob([bytes as BlobPart], { type }));\n      return { url, type };\n    }).pipe(\n      Effect.provide(Database.layer(db)),\n      Effect.catchAll(() => Effect.succeed(undefined)),\n    );\n\n    void EffectEx.runPromise(program).then((result) => {\n      if (cancelled) {\n        if (result?.url.startsWith('blob:')) {\n          URL.revokeObjectURL(result.url);\n        }\n        return;\n      }\n      if (result?.url.startsWith('blob:')) {\n        createdBlobUrl = result.url;\n      }\n      setRendered(result);\n    });\n\n    return () => {\n      cancelled = true;\n      if (createdBlobUrl) {\n        URL.revokeObjectURL(createdBlobUrl);\n      }\n    };\n    // Keyed on `file.id` rather than `file`/`file.data` directly: ECHO's reactive proxy returns a\n    // fresh `Ref` wrapper for `.data` on every access, so including it (or the proxy object itself)\n    // here would rerun this effect on every render — clearing the render state and re-resolving it\n    // each time, which flickers the image while the object settles.\n  }, [file.id]);\n\n  if (!rendered) {\n    return null;\n  }\n\n  return (\n    <Panel.Root role={role} classNames='dx-document'>\n      <Panel.Content asChild>\n        <FilePreview type={rendered.type} url={rendered.url} />\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nexport default FileArticle;\n\nFileArticle.displayName = 'FileArticle';\n"],"mappings":";;;;;;;;;AAkBA,IAAa,eAAe,EAAE,MAAM,SAAS,WAA6B;CACxE,MAAM,CAAC,UAAU,eAAe,SAAoD,KAAA,CAAS;CAE7F,gBAAgB;EACd,YAAY,KAAA,CAAS;EAErB,MAAM,KAAK,IAAI,YAAY,IAAI;EAC/B,IAAI,CAAC,IACH;EAGF,IAAI,YAAY;EAChB,IAAI;EAEJ,MAAM,UAAU,OAAO,IAAI,aAAa;GACtC,MAAM,OAAO,OAAO,SAAS,KAAK,KAAK,IAAI;GAC3C,MAAM,OAAO,KAAK,QAAQ;GAC1B,MAAM,YAAY,OAAO,KAAK,IAAI,IAAI;GACtC,IAAI,OAAO,OAAO,SAAS,GACzB,OAAO;IAAE,KAAK,UAAU;IAAO;GAAK;GAEtC,MAAM,QAAQ,OAAO,KAAK,KAAK,IAAI;GAKnC,OAAO;IAAE,KADG,IAAI,gBAAgB,IAAI,WAAW,KAAK,CAAC,KAAiB,GAAG,EAAE,KAAK,CAAC,CACxE;IAAK;GAAK;EACrB,CAAC,CAAC,CAAC,KACD,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,GACjC,OAAO,eAAe,OAAO,QAAQ,KAAA,CAAS,CAAC,CACjD;EAEA,SAAc,WAAW,OAAO,CAAC,CAAC,MAAM,WAAW;GACjD,IAAI,WAAW;IACb,IAAI,QAAQ,IAAI,WAAW,OAAO,GAChC,IAAI,gBAAgB,OAAO,GAAG;IAEhC;GACF;GACA,IAAI,QAAQ,IAAI,WAAW,OAAO,GAChC,iBAAiB,OAAO;GAE1B,YAAY,MAAM;EACpB,CAAC;EAED,aAAa;GACX,YAAY;GACZ,IAAI,gBACF,IAAI,gBAAgB,cAAc;EAEtC;CAKF,GAAG,CAAC,KAAK,EAAE,CAAC;CAEZ,IAAI,CAAC,UACH,OAAO;CAGT,OACE,oBAAC,MAAM,MAAP;EAAkB;EAAM,YAAW;YACjC,oBAAC,MAAM,SAAP;GAAe,SAAA;aACb,oBAAC,aAAD;IAAa,MAAM,SAAS;IAAM,KAAK,SAAS;GAAM,CAAA;EACzC,CAAA;CACL,CAAA;AAEhB;AAIA,YAAY,cAAc"}

package/dist/lib/chunk-create-object.mjs

@@ -0,0 +1,28 @@
+import { Operation } from "@dxos/compute";
+import { Capability } from "@dxos/app-framework";
+import { Type } from "@dxos/echo";
+import { File, FileAction, FileOperation } from "#types";
+import * as Effect from "effect/Effect";
+import { SpaceCapabilities, SpaceOperation } from "@dxos/plugin-space";
+//#region src/capabilities/create-object.ts
+var create_object_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {
+		id: Type.getTypename(File.File),
+		inputSchema: FileAction.CreateFileSchema,
+		createObject: (props, options) => Effect.gen(function* () {
+			const { object } = yield* Operation.invoke(FileOperation.Create, {
+				...props,
+				db: options.db
+			});
+			return yield* Operation.invoke(SpaceOperation.AddObject, {
+				object,
+				target: options.target,
+				targetNodeId: options.targetNodeId
+			});
+		})
+	});
+}));
+//#endregion
+export { create_object_default as default };
+
+//# sourceMappingURL=chunk-create-object.mjs.map

package/dist/lib/chunk-create-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-create-object.mjs","names":[],"sources":["../../src/capabilities/create-object.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\nimport { Type } from '@dxos/echo';\nimport { SpaceCapabilities, SpaceOperation } from '@dxos/plugin-space';\n\nimport { File, FileAction, FileOperation } from '#types';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {\n      id: Type.getTypename(File.File),\n      inputSchema: FileAction.CreateFileSchema,\n      createObject: (props, options) =>\n        Effect.gen(function* () {\n          const { object } = yield* Operation.invoke(FileOperation.Create, { ...props, db: options.db });\n          return yield* Operation.invoke(SpaceOperation.AddObject, {\n            object,\n            target: options.target,\n            targetNodeId: options.targetNodeId,\n          });\n        }),\n    });\n  }),\n);\n"],"mappings":";;;;;;;AAaA,IAAA,wBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,WAAW,YAAY,kBAAkB,mBAAmB;EACjE,IAAI,KAAK,YAAY,KAAK,IAAI;EAC9B,aAAa,WAAW;EACxB,eAAe,OAAO,YACpB,OAAO,IAAI,aAAa;GACtB,MAAM,EAAE,WAAW,OAAO,UAAU,OAAO,cAAc,QAAQ;IAAE,GAAG;IAAO,IAAI,QAAQ;GAAG,CAAC;GAC7F,OAAO,OAAO,UAAU,OAAO,eAAe,WAAW;IACvD;IACA,QAAQ,QAAQ;IAChB,cAAc,QAAQ;GACxB,CAAC;EACH,CAAC;CACL,CAAC;AACH,CAAC,CACH"}