<?xml version="1.0" encoding="UTF-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.32 (Ruby 3.3.0) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>


<rfc ipr="trust200902" docName="draft-ietf-jmap-filenode-21" category="std" consensus="true" submissionType="IETF" updates="8620" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="JMAP FileNode">JMAP File Storage extension</title>

    <author initials="B." surname="Gondwana" fullname="Bron Gondwana">
      <organization>Fastmail</organization>
      <address>
        <email>brong@fastmailteam.com</email>
      </address>
    </author>

    <date year="2026" month="November" day="15"/>

    
    
    <keyword>Internet-Draft</keyword>

    <abstract>


<?line 54?>

<t>The JMAP base protocol (RFC 8620) provides the ability to upload and download
arbitrary binary data.  This binary data is called a "blob", and can be used
in all other JMAP extensions.</t>

<t>This extension adds a FileNode data type and methods to expose blobs as a
filesystem, along with the types of metadata that are provided by other remote
filesystem protocols.</t>



    </abstract>



  </front>

  <middle>


<?line 64?>

<section anchor="introduction"><name>Introduction</name>

<t>JMAP (<xref target="JMAP-CORE"/> — JSON Meta Application Protocol) is a generic
protocol for synchronizing data between a client and a server.
It is optimized for mobile and web environments, and aims to
provide a consistent interface to different data types.</t>

<t>In the same way that JMAP Calendars (<xref target="JMAP-CALENDARS"/>) replaces
CalDAV (<xref target="CALDAV"/>) and JMAP Contacts (<xref target="JMAP-CONTACTS"/>) replaces
CardDAV (<xref target="CARDDAV"/>), this document replaces the use of WebDAV (<xref target="WEBDAV"/>)
for remote filesystem access.</t>

<section anchor="conventions-used-in-this-document"><name>Conventions Used in This Document</name>

<t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>

<?line -18?>

<t>Where this document compares names case-insensitively, it compares
the default case folding (toCasefold(), Section 3.13 of
<xref target="UNICODE-STD"/>) of each name.  As every name is in Normalization
Form C (see "name"), this needs no further normalization.  It does
not apply compatibility decomposition: "file1" and "file" followed by
a circled digit one are different names, as they are on every common
filesystem.</t>

</section>
</section>
<section anchor="addition-to-the-capabilities-object"><name>Addition to the Capabilities Object</name>

<t>The capabilities object is returned as part of the JMAP Session
object; see <xref section="2" sectionFormat="of" target="JMAP-CORE"/>.</t>

<t>This document defines an additional capability URI.</t>

<section anchor="urnietfparamsjmapfilenode"><name>urn:ietf:params:jmap:filenode</name>

<t>The capability <spanx style="verb">urn:ietf:params:jmap:filenode</spanx> being present in the
"accountCapabilities" property of an account represents support
for the FileNode data type.  Servers that include the capability
in one or more "accountCapabilities" properties <bcp14>MUST</bcp14> also include
the property in the "capabilities" property.</t>

<t>The value of this property in the JMAP session "capabilities"
property <bcp14>MUST</bcp14> be an empty object.</t>

<t>The value of this property in an account's "accountCapabilities"
property is an object that <bcp14>MUST</bcp14> contain the following information
on server capabilities and permissions for that account:</t>

<t><list style="symbols">
  <t>maxFileNodeDepth: "UnsignedInt|null"  <vspace blankLines='1'/>
The maximum number of levels in the FileNode hierarchy, or null
  for no limit.  A FileNode may have at most one fewer ancestors
  than this value, so 1 allows only top-level nodes.</t>
  <t>maxSizeFileNodeName: "UnsignedInt"  <vspace blankLines='1'/>
The maximum length, in (UTF-8) octets, allowed for the name of a
  FileNode.  This <bcp14>MUST</bcp14> be at least 100, although it is recommended
  servers allow more.</t>
  <t>forbiddenNameChars: "String|null"  <vspace blankLines='1'/>
A string where each character is forbidden in FileNode names.
  If null, the server does not restrict name characters beyond
  the requirements of the <spanx style="verb">name</spanx> property: a non-empty Net-Unicode
  string with no "/".
  The server <bcp14>MUST</bcp14> reject names containing any of these
  characters with an "invalidProperties" error.</t>
  <t>supportedNodeTypes: "String[]"  <vspace blankLines='1'/>
The <spanx style="verb">@type</spanx> values that the server allows clients to create
  in this account (see "FileNode Objects" below).  This <bcp14>MUST</bcp14>
  include "Directory" and "File".  It <bcp14>MAY</bcp14> include "SymLink" and
  any other value registered in the "JMAP FileNode Types"
  registry.  Clients <bcp14>MUST</bcp14> ignore values they do not recognize.</t>
  <t>fileNodeQuerySortOptions: "String[]"  <vspace blankLines='1'/>
A list of all the values the server supports for the "property"
  field of the Comparator object in a "FileNode/query" sort (see
  "FileNode/query" below).  This <bcp14>MAY</bcp14> include properties the
  client does not recognize (for example, custom properties specified in a vendor
  extension).  Clients <bcp14>MUST</bcp14> ignore any unknown properties in the
  list.</t>
  <t>mayCreateTopLevelFileNode: "Boolean"  <vspace blankLines='1'/>
If true, the user may create a FileNode (see "FileNode/set"
  below) in this account with a null parentId.  If false, creating
  a node with a null parentId, or moving one there, fails with
  "forbidden": the request is valid, but not allowed.  (Permission
  for creating a child of an existing FileNode is given by the
  "myRights" property on that FileNode.)</t>
  <t>webTrashUrl: "String|null"  <vspace blankLines='1'/>
The URL at which the Directory with the "trash" role can be viewed
  on the web.  If null, there is no web URL available.</t>
  <t>caseInsensitiveNames: "Boolean"  <vspace blankLines='1'/>
If true, the server treats node names as case-insensitive for
  all name collision checks, including the sibling uniqueness
  constraint and <spanx style="verb">onExists</spanx> handling.  The server preserves the
  original case as provided by the client.</t>
  <t>webUrlTemplate: "String|null"  <vspace blankLines='1'/>
A template by which any node can be viewed on the web, in URI
  Template (level 1) format <xref target="URI-TEMPLATE"/>.  The available
  variable is <spanx style="verb">{id}</spanx>, which is the FileNode id.  If null, there
  is no web URL available.</t>
  <t>webWriteUrlTemplate: "String|null"  <vspace blankLines='1'/>
A URI Template (level 1) <xref target="URI-TEMPLATE"/> for writing content
  to a FileNode with <spanx style="verb">@type</spanx> "File".  The available variable is
  <spanx style="verb">{id}</spanx>, which is the FileNode id.  If null, direct HTTP writes are not
  supported and clients must use FileNode/set to update content.
  See "Direct HTTP Write" below for the HTTP semantics.</t>
</list></t>

<section anchor="capability-example"><name>Capability Example</name>

<figure><sourcecode type="json"><![CDATA[
{
  "urn:ietf:params:jmap:filenode": {
    "maxFileNodeDepth": 50,
    "maxSizeFileNodeName": 255,
    "fileNodeQuerySortOptions": [
      "name", "mediaType", "size", "created", "modified",
      "nodeType", "tree"
    ],
    "supportedNodeTypes": ["Directory", "File", "SymLink"],
    "forbiddenNameChars": "/<>:\"\\|?*",
    "caseInsensitiveNames": false,
    "mayCreateTopLevelFileNode": false,
    "webTrashUrl": "https://files.example.com/trash",
    "webUrlTemplate": "https://files.example.com/view/{id}",
    "webWriteUrlTemplate": "https://files.example.com/write/{id}"
  }
}
]]></sourcecode></figure>

</section>
</section>
</section>
<section anchor="filenode-data-type"><name>FileNode Data Type</name>

<t>A FileNode is a set of metadata which behaves similarly to an inode in
a filesystem.  In <xref target="WEBDAV"/> terminology a Directory corresponds to
a collection and a File to a resource.</t>

<t>The <spanx style="verb">urn:ietf:params:jmap:filenode</spanx> capability selects the
FileNode data type and the methods defined below.</t>

<section anchor="filenode-objects"><name>FileNode Objects</name>

<t>Every FileNode has a type, given by its <spanx style="verb">@type</spanx> property.  This
document defines three types: "File", "Directory", and "SymLink".
Each type has its own set of properties in addition to the
properties common to all FileNodes.</t>

<t>Properties that this document defines for one type <bcp14>MUST NOT</bcp14>
appear on a FileNode of another type; they are omitted rather
than set to null.  An attempt to create or update a FileNode
that sets a property not defined for its <spanx style="verb">@type</spanx> to a non-null
value is an "invalidProperties" error.  The server <bcp14>MUST</bcp14> ignore a
null value for such a property, both on create and on update.</t>

<t>As in <xref section="5.3" sectionFormat="of" target="JMAP-CORE"/>, setting a property that has a
default value to null, on create or update, sets it to that
default, unless the property's description says otherwise.</t>

<t>FileNode/get has additional rules for these properties (see
"FileNode/get" below).  In particular, for a node the user can
discover but not read, it returns null for most properties, even
those whose type does not otherwise allow null (see "Access
Control").</t>

<section anchor="common-properties"><name>Common Properties</name>

<t>The following properties are defined for every FileNode,
regardless of its type:</t>

<t><list style="symbols">
  <t>@type: "String" (immutable)  <vspace blankLines='1'/>
The type of the node.  Values are registered in the "JMAP
  FileNode Types" registry (see "IANA Considerations").  This
  document defines the values "File", "Directory", and
  "SymLink".  This <bcp14>MUST</bcp14> be provided on creation.  Attempting to
  change <spanx style="verb">@type</spanx> after creation is an "invalidProperties"
  error.  A server <bcp14>MUST</bcp14> reject the creation of a node with an
  <spanx style="verb">@type</spanx> that is not in the <spanx style="verb">supportedNodeTypes</spanx> capability
  with an "invalidProperties" error.  Clients <bcp14>MUST</bcp14> be prepared
  to receive nodes with <spanx style="verb">@type</spanx> values they do not recognize,
  and <bcp14>SHOULD NOT</bcp14>
  interpret any of their properties other than the common
  properties.</t>
  <t>id: "Id" (immutable; server-set)  <vspace blankLines='1'/>
The Id of the FileNode.</t>
  <t>parentId: "Id|null"  <vspace blankLines='1'/>
The Id of the parent node, or null if this is a top-level
  node.  The parent <bcp14>MUST</bcp14> be a node whose <spanx style="verb">@type</spanx> permits
  children; of the types defined in this document, only
  "Directory" does.  Setting parentId to any other node is an
  "invalidProperties" error.</t>
  <t>name: "String"  <vspace blankLines='1'/>
User-visible name for the FileNode.  This <bcp14>MUST</bcp14> be a
  Net-Unicode string <xref target="UNICODE"/> of at least 1 character in length,
  subject to the maximum size given in the capability object.
  Net-Unicode requires Normalization Form C <xref target="UAX15"/>, and names
  are compared octet by octet, so a name in any other form could
  sit beside an identical-looking sibling that a client on a
  normalization-insensitive filesystem cannot hold as well.  A
  name <bcp14>MUST NOT</bcp14> contain "/", and <bcp14>MUST NOT</bcp14> be "." or "..".  There
  <bcp14>MUST NOT</bcp14> be two sibling FileNodes with both the same parent and
  the same name.  <vspace blankLines='1'/>
The server <bcp14>MUST</bcp14> reject, with an "invalidProperties" error, a
  name that a client gives which is not Net-Unicode (including
  one not in Normalization Form C), contains "/", is "." or "..",
  or contains any character listed in <spanx style="verb">forbiddenNameChars</spanx>.  It
  <bcp14>MAY</bcp14> also reject other names it cannot store in the same way.  A
  client on a platform that produces names in another form (macOS
  file APIs commonly give Normalization Form D) <bcp14>MUST</bcp14> convert them
  to Normalization Form C before sending them.  See
  "Implementation Considerations" for guidance on which
  characters and names to forbid.</t>
  <t>created: "UTCDate" (default: current server time)  <vspace blankLines='1'/>
The date the node was created.  The server never updates it
  automatically.</t>
  <t>modified: "UTCDate" (default: current server time)  <vspace blankLines='1'/>
The date the content of the node was last modified.  The
  server updates it automatically only on a Direct HTTP Write.
  See "Modification Timestamps" for usage guidance.</t>
  <t>accessed: "UTCDate" (default: current server time)  <vspace blankLines='1'/>
The date the node was last accessed.  The server never updates
  it automatically.  Clients <bcp14>SHOULD</bcp14> provide an updated value when appropriate (see
  "Access Time Updates").</t>
  <t>changed: "UTCDate" (server-set)  <vspace blankLines='1'/>
The date the server last recorded a change to a property of
  this node that has the same value for every user.  The server
  <bcp14>MUST</bcp14> automatically update this value whenever such a property
  is modified, including <spanx style="verb">blobId</spanx>, <spanx style="verb">name</spanx>, <spanx style="verb">parentId</spanx>,
  <spanx style="verb">shareWith</spanx>, <spanx style="verb">executable</spanx>, <spanx style="verb">metadata</spanx>, and the other mutable
  properties that are not per-user.  This is not settable by
  clients.  <vspace blankLines='1'/>
A change to a per-user property (<spanx style="verb">isSubscribed</spanx>, or
  <spanx style="verb">privateMetadata</spanx> (see "Extended Attributes and Named
  Streams")), or to the node's rights because of a change to an
  ancestor's <spanx style="verb">shareWith</spanx> or a move (see "Access Control"), need
  not update <spanx style="verb">changed</spanx>.  The server <bcp14>SHOULD</bcp14>
  report a per-user change in FileNode/changes only to the
  users whose value changed.  It <bcp14>MAY</bcp14> instead update <spanx style="verb">changed</spanx>,
  and report the node in FileNode/changes to other users too,
  when it cannot efficiently determine which users are
  affected, such as when the value is held for a group.</t>
</list></t>

</section>
<section anchor="container-properties"><name>Container Properties</name>

<t>The following properties are defined for every FileNode whose
<spanx style="verb">@type</spanx> permits children; of the types defined in this document,
only "Directory" does.  They do not appear on other nodes, whose
rights come from their parent (see "Access Control").</t>

<t><list style="symbols">
  <t>isSubscribed: "Boolean" (default: true)  <vspace blankLines='1'/>
This property is stored per user, and if true, the node should
  be displayed to the current user.  Setting it changes only the
  current user's value, and requires no rights beyond being able
  to discover the node.</t>
  <t>myRights: "FilesRights" (server-set)  <vspace blankLines='1'/>
The set of rights the user has on this node.  A <strong>FilesRights</strong> object has the following properties:  <list style="symbols">
      <t>mayRead: <spanx style="verb">Boolean</spanx> The user may read all properties and
the blob content of this node.  Without it, some properties
are still visible (see "Access Control").</t>
      <t>mayAddChildren: <spanx style="verb">Boolean</spanx> The user may create child nodes
in this directory, or move nodes into it.</t>
      <t>mayRename: <spanx style="verb">Boolean</spanx> The user may rename or move this node,
or change its <spanx style="verb">role</spanx>.</t>
      <t>mayDelete: <spanx style="verb">Boolean</spanx> The user may destroy this node.</t>
      <t>mayModifyContent: <spanx style="verb">Boolean</spanx> The user may update the
content-related properties of this node (<spanx style="verb">blobId</spanx>, <spanx style="verb">mediaType</spanx>,
<spanx style="verb">target</spanx>, <spanx style="verb">created</spanx>, <spanx style="verb">modified</spanx>, <spanx style="verb">accessed</spanx>, <spanx style="verb">executable</spanx>).</t>
      <t>mayShare: <spanx style="verb">Boolean</spanx> The user may change the sharing of this
node (see <xref target="JMAP-SHARING"/>), granting or removing any right
for any other user, including rights the user does not have.</t>
    </list></t>
  <t>shareWith: "Id[FilesRights]|null"  <vspace blankLines='1'/>
A map of userId to rights for users this node is shared with.
  This is the access control list set on this node only; rights
  inherited from ancestors do not appear in it (see "Access
  Control").  The owner of the node <bcp14>MUST NOT</bcp14> be in this set.
  This is <spanx style="verb">null</spanx> if the user requesting the object does not have
  <spanx style="verb">myRights.mayShare</spanx>, or if the node is not shared with anyone.  <vspace blankLines='1'/>
Changing <spanx style="verb">shareWith</spanx> requires <spanx style="verb">mayShare</spanx>.  A user <bcp14>MUST NOT</bcp14> change
  their own entry: the server rejects an update that would change
  the user's own rights with "forbidden", though one that leaves
  them as they are is not a change.  A server <bcp14>MAY</bcp14> limit which
  users a node can be shared with, rejecting others with
  "forbidden".  A server <bcp14>MAY</bcp14> also leave out entries for users the
  requesting user is not allowed to know of; an update from that
  user then leaves those entries as they are unless it names them,
  whether it replaces <spanx style="verb">shareWith</spanx> or patches it.</t>
</list></t>

</section>
<section anchor="file-properties"><name>File Properties</name>

<t>A FileNode with <spanx style="verb">@type</spanx> "File" is a regular file with blob
content.  In addition to the common properties, it has the
following properties:</t>

<t><list style="symbols">
  <t>blobId: "Id"  <vspace blankLines='1'/>
The blobId for the content of this file.  This <bcp14>MUST</bcp14> be
  provided on creation, including for zero byte files.
  Setting blobId to null is an "invalidProperties" error.
  Updating the blobId replaces the file's content; the server
  <bcp14>MUST</bcp14> update <spanx style="verb">size</spanx> to match the new blob.  A blob referenced
  by a FileNode <bcp14>MUST NOT</bcp14> be expired or garbage collected by the
  server while the FileNode exists.</t>
  <t>size: "UnsignedInt" (server-set)  <vspace blankLines='1'/>
The size in bytes of the associated blob data.  Size is
  optional on create and update, but if provided it <bcp14>MUST</bcp14> match
  the size of the provided blobId.  If the client updates
  <spanx style="verb">blobId</spanx> without providing <spanx style="verb">size</spanx>, the server sets <spanx style="verb">size</spanx>
  from the new blob and returns the size in the "updated"
  response.</t>
  <t>mediaType: "String" (default: "application/octet-stream")  <vspace blankLines='1'/>
The media type of the file.  If not provided on creation,
  or if set to null, the server sets it to
  "application/octet-stream".  Values are normally those
  registered in the IANA media-types registry, but servers <bcp14>MUST
  NOT</bcp14> reject media types that are not recognized.  Servers <bcp14>MUST</bcp14> reject media
  types if the value does not conform to the ABNF of
  <xref section="4.2" sectionFormat="of" target="MEDIA-TYPES"/>.</t>
  <t>executable: "Boolean" (default: false)  <vspace blankLines='1'/>
If true, the file should be treated as an executable by
  operating systems that support this flag.</t>
</list></t>

</section>
<section anchor="directory-properties"><name>Directory Properties</name>

<t>A FileNode with <spanx style="verb">@type</spanx> "Directory" is a collection that may
contain child nodes.  In addition to the common properties, it
has the following property:</t>

<t><list style="symbols">
  <t>role: "String|null" (default: null)  <vspace blankLines='1'/>
An indication that this directory has a special role.  A
  directory with the "root" role should have a null parentId.
  Clients <bcp14>MUST</bcp14> ignore unrecognized role values.  Values are
  registered in the "JMAP FileNode Roles" registry (see IANA
  Considerations).  <vspace blankLines='1'/>
A client may set <spanx style="verb">role</spanx> on create or update, and may set it
  to null to clear it.  Changing <spanx style="verb">role</spanx> on an existing node
  requires <spanx style="verb">mayRename</spanx> on that node.  At most one Directory in
  an account has a given role; setting a role that another
  Directory already has is an "alreadyExists" error, whose
  <spanx style="verb">existingId</spanx> is that Directory.  As
  for sibling names, the server checks this against the result
  of all the creates, updates and destroys in a FileNode/set
  together, so a client can move a role from one Directory to
  another in a single method.  A server <bcp14>MAY</bcp14> reject setting or
  clearing a role for policy reasons with "forbidden": for
  example, a role that it manages itself, such as "root" or
  "trash", or a role that it allows only on a top-level
  Directory or within a limited depth of the tree.</t>
</list></t>

</section>
<section anchor="symlink-properties"><name>SymLink Properties</name>

<t>A FileNode with <spanx style="verb">@type</spanx> "SymLink" is a symbolic link to another
path in the tree.  In addition to the common properties, it has
the following property:</t>

<t><list style="symbols">
  <t>target: "String[]"  <vspace blankLines='1'/>
The target path of the symlink, as an array of path
  elements.  Each element is a node name in the path.  An
  empty string as the first element indicates an absolute
  path from the root of the tree; otherwise the path is
  relative to the symlink's parent.  An element of ".." refers
  to the parent directory.  The root of the tree is the set of
  nodes with a null parentId, not a Directory with the "root"
  role.  A relative target on a node with a null parentId
  resolves from the root, and a ".." element at the root does
  not resolve.  The target is not required to
  resolve to an existing node (symlinks may dangle).  The
  target is mutable; updating it changes where the symlink
  points.  This <bcp14>MUST</bcp14> be provided on creation.  Setting
  target to null is an "invalidProperties" error.</t>
</list></t>

</section>
<section anchor="filenode-examples"><name>FileNode Examples</name>

<t>A directory, a file inside it, and a symlink pointing to the
file.  Common properties other than <spanx style="verb">@type</spanx>, <spanx style="verb">id</spanx>, <spanx style="verb">parentId</spanx>,
and <spanx style="verb">name</spanx> are omitted for brevity:</t>

<figure><sourcecode type="json"><![CDATA[
[
  {
    "@type": "Directory",
    "id": "n1",
    "parentId": null,
    "name": "Documents",
    "role": "documents"
  },
  {
    "@type": "File",
    "id": "n3",
    "parentId": "n1",
    "name": "report.pdf",
    "blobId": "Bfa61c0",
    "size": 48576,
    "mediaType": "application/pdf",
    "executable": false
  },
  {
    "@type": "SymLink",
    "id": "n7",
    "parentId": null,
    "name": "latest-report",
    "target": ["Documents", "report.pdf"]
  }
]
]]></sourcecode></figure>

</section>
</section>
<section anchor="filenode-methods"><name>FileNode Methods</name>

<section anchor="filenodeget"><name>FileNode/get</name>

<t>This is a standard Foo/get method, with the following differences:</t>

<t><list style="symbols">
  <t>The <spanx style="verb">@type</spanx> property is always returned, even if it is not
included in the <spanx style="verb">properties</spanx> argument.</t>
  <t>If the <spanx style="verb">properties</spanx> argument includes a property that is
defined for some FileNode type but not for a node's <spanx style="verb">@type</spanx>,
the server omits that property from that node in the response.
It does not return the property with a null value.</t>
  <t>For a node the user can discover but not read, the server
returns null for most properties (see "Access Control").</t>
</list></t>

<t>There is one additional request argument:</t>

<t><list style="symbols">
  <t>fetchParents: "Boolean" (default: false)  <vspace blankLines='1'/>
If true, the server returns all ancestor nodes of the
  requested ids, as additional entries in the <spanx style="verb">list</spanx> array.
  Each node appears in the list only once.</t>
</list></t>

</section>
<section anchor="filenodechanges"><name>FileNode/changes</name>

<t>This is a standard Foo/changes method.  A node can be reported as
changed without any change to its own properties: see <spanx style="verb">changed</spanx>
for per-user properties, and "Access Control" for changes to a
node's rights or discoverability.</t>

</section>
<section anchor="filenodeset"><name>FileNode/set</name>

<t>This is a standard Foo/set method, with the following differences:</t>

<t>An attempt to move a node beneath itself is rejected with an
"invalidProperties" error.</t>

<t>Within a single FileNode/set, the server <bcp14>MUST</bcp14> check the uniqueness
of sibling names against the result of all its creates, updates
and destroys together, so that a client can destroy a node and
create its replacement in the same method.</t>

<t>There are these additional top-level arguments:</t>

<t><list style="symbols">
  <t>onDestroyRemoveChildren: "Boolean" (default: false)  <vspace blankLines='1'/>
If false, an attempt to destroy a FileNode that has children is
  rejected with a "nodeHasChildren" error.  If all the children
  are destroyed in the same method, the server <bcp14>MUST NOT</bcp14> return
  this error: it either destroys children before their parents,
  or checks this constraint only against the final state.  <vspace blankLines='1'/>
If true, destroying a node also destroys all its descendants,
  and the server <bcp14>MUST</bcp14> include the ids of all of them in the
  "destroyed" list of the response.  A destroy that would remove a
  Directory with a role among the descendants fails with
  "forbidden", as destroying that Directory itself would.</t>
  <t>onExists: "String|null" (default: null)  <vspace blankLines='1'/>
Controls what happens when a create or update would give a
  FileNode the same name as an existing sibling.  <vspace blankLines='1'/>
If null, the server rejects the create or update with an
  "alreadyExists" error.  <vspace blankLines='1'/>
If "replace", the server destroys the existing node, and <bcp14>MUST</bcp14>
  include its id, and the ids of any descendants destroyed with
  it, in the "destroyed" list of the response.  A node
  of any <spanx style="verb">@type</spanx> may replace a node of any other <spanx style="verb">@type</spanx>.  <vspace blankLines='1'/>
If "rename", the server changes the "name" property so that it
  does not clash, using an algorithm of its choice, and <bcp14>MUST</bcp14>
  include the new name in the "created" or "updated" entry for
  that id.  <vspace blankLines='1'/>
Any other value is rejected with an "invalidArguments" error.  <vspace blankLines='1'/>
"replace" destroys whichever node holds the name when the method
  runs.  To replace only the node it expects, a client instead
  destroys that node and creates the new one in the same
  FileNode/set, with an "ifUnchangedBy" precondition
  (<xref target="JMAP-CONDITIONAL"/>) on the node it destroys, and "atomic"
  true.  Without "atomic", <xref target="JMAP-CORE"/> lets the destroy succeed
  while the create fails, losing the node with nothing in its
  place.  <vspace blankLines='1'/>
For "replace", the server makes these checks in order, and
  stops at the first that fails:  <list style="numbers" type="1">
      <t>If the existing node is not discoverable by the user (see
"Access Control"), the operation fails with "forbidden", and
the server <bcp14>MUST NOT</bcp14> destroy that node or reveal its id.
Servers may also return "forbidden" for other reasons, such
as a file name policy, so the error does not confirm that the
name is taken.</t>
      <t>If more than one existing node matches the name (as a
case-insensitive comparison can find), or another update in
the same method renames or moves the existing node, the
operation fails with "alreadyExists".  The server does not
choose which of several nodes to destroy, nor destroy a node
the client has asked to keep under another name or parent,
even when it cannot order the method so that the node moves
out of the way first.</t>
      <t>If the existing node is the node being moved or copied, or
one of its ancestors, the operation fails with
"invalidProperties": destroying it would destroy the node
being placed.</t>
      <t>If the existing node, or any node beneath it, is a Directory
with a role, the operation fails with "forbidden".</t>
      <t>If the user does not have <spanx style="verb">mayDelete</spanx> on the existing node,
the operation fails with "forbidden".</t>
      <t>If the existing node has children, the operation fails with
"nodeHasChildren" if onDestroyRemoveChildren is false, or
with "forbidden" if replacing it would remove nodes the user
cannot discover (see "Access Control").</t>
    </list>
"rename" applies whether or not the user can discover the
  existing node.</t>
  <t>compareCaseInsensitively: "Boolean" (default: false)  <vspace blankLines='1'/>
If true, name collision checks (including <spanx style="verb">onExists</spanx> handling)
  treat names as case-insensitive for this request.  This has no
  effect if the server already has <spanx style="verb">caseInsensitiveNames</spanx> set to
  true in its capability.  See "Case Sensitivity" for its use.</t>
</list></t>

<t>Errors (in addition to standard SetError codes from <xref target="JMAP-CORE"/>):</t>

<t><list style="symbols">
  <t>"alreadyExists" — a create or update would cause a name collision
with a discoverable sibling FileNode, and onExists did not
resolve it, or would give a Directory a role that another
Directory in the account already has.  The SetError object <bcp14>MUST</bcp14>
include an <spanx style="verb">existingId</spanx> property with the id of the existing
FileNode: the sibling, or the Directory with the role.</t>
  <t>"blobNotFound" — a create or update gives a <spanx style="verb">blobId</spanx> that does not
exist or that the user cannot access.  As in Email/set
(<xref section="4.6" sectionFormat="of" target="JMAP-MAIL"/>), the SetError object <bcp14>MUST</bcp14> include a
<spanx style="verb">notFound</spanx> property listing that blobId.</t>
  <t>"forbidden" — among other cases: a name collision with a sibling
the user cannot discover; an onExists replacement without the
required rights on the existing node (see onExists above); a
destroy that would remove nodes the user cannot discover; a
rename, move, role change or destroy without the rights it
needs, or a rename, move or destroy of a Directory with a role; a change to a role that server policy
does not allow; or a create or move to the top level
without <spanx style="verb">mayCreateTopLevelFileNode</spanx> (see "Access Control").</t>
  <t>"invalidProperties" — among other cases: an attempt to move a
node to a descendant of itself, creating a cycle in the tree, to
make a node the child of a node whose <spanx style="verb">@type</spanx> does not permit
children, to change the <spanx style="verb">@type</spanx> of a node, to set a property
that is not defined for the node's <spanx style="verb">@type</spanx> to a non-null value,
a <spanx style="verb">parentId</spanx> that names no node the user can discover (a
reference to a record that does not exist, as
<xref section="5.3" sectionFormat="of" target="JMAP-CORE"/> has it), or a create or move that
would give the
node, or any of its descendants, more ancestors than
<spanx style="verb">maxFileNodeDepth</spanx> allows.</t>
  <t>"nodeHasChildren" — a destroy or onExists replacement of a
FileNode that has children, with onDestroyRemoveChildren false.</t>
</list></t>

</section>
<section anchor="filenodecopy"><name>FileNode/copy</name>

<t>This is a standard Foo/copy method with the same additional
top-level arguments as FileNode/set (onDestroyRemoveChildren,
onExists, and compareCaseInsensitively), with the same behavior.
These arguments apply to the nodes created and replaced in the
destination account.</t>

<t>Each copy is a new node, with a new id and a new <spanx style="verb">changed</spanx> value.
It has the same <spanx style="verb">created</spanx>, <spanx style="verb">modified</spanx> and <spanx style="verb">accessed</spanx> values as its
original, unless the client gives others.  For a File, the server
copies the content of its blob into the destination account; the
blob need not already exist there, and the new <spanx style="verb">blobId</spanx> may
differ.  <spanx style="verb">shareWith</spanx> and <spanx style="verb">role</spanx> are not copied, even within one
account: the copy takes its rights from its new parent, and
<spanx style="verb">isSubscribed</spanx> takes its default value.  <spanx style="verb">metadata</spanx> and
<spanx style="verb">privateMetadata</spanx> are copied as <xref target="JMAP-METADATA"/> describes.</t>

<t>Copying a Directory copies its whole subtree: each descendant is
copied, by the rules above and with the same name, beneath the
copy of its parent.  The copy
of a Directory and all its descendants succeeds or fails as a
whole; if the destination cannot hold any descendant (for example,
a SymLink where "SymLink" is not in <spanx style="verb">supportedNodeTypes</spanx>), the
copy fails.</t>

<t>Copying a node requires <spanx style="verb">mayRead</spanx> on it and <spanx style="verb">mayAddChildren</spanx> on
the destination parent (or <spanx style="verb">mayCreateTopLevelFileNode</spanx>).
The response gives only the id of the new Directory; FileNode/query
with an <spanx style="verb">ancestorId</spanx> condition finds the copied descendants.</t>

<t>If onSuccessDestroyOriginal is true, the implicit FileNode/set
call that destroys the originals (<xref section="5.4" sectionFormat="of" target="JMAP-CORE"/>)
has onDestroyRemoveChildren true.  A client that must not lose a
node added to the tree between the copy and the destroy passes
destroyFromIfInState.</t>

<t>Unlike other Foo/copy methods (<xref section="5.4" sectionFormat="of" target="JMAP-CORE"/>),
FileNode/copy allows <spanx style="verb">accountId</spanx> to be the same as
<spanx style="verb">fromAccountId</spanx>, so a client can copy a node or a tree within one
account.  An attempt to copy a Directory into itself or one of its
descendants is rejected with "invalidProperties".</t>

<t>The response has one additional property:</t>

<t><list style="symbols">
  <t>destroyed: "Id[]|null"  <vspace blankLines='1'/>
The ids of the FileNodes in the destination account that were
  destroyed because onExists replaced them, including any
  descendants removed with onDestroyRemoveChildren.  This is
  null if no FileNodes were destroyed.</t>
</list></t>

<t>Errors: the same additional errors as FileNode/set apply.</t>

</section>
<section anchor="filenodequery"><name>FileNode/query</name>

<t>This is a standard Foo/query method except for the following:</t>

<t>There is one additional request argument:</t>

<t><list style="symbols">
  <t>depth: "UnsignedInt|null" (default: null)  <vspace blankLines='1'/>
The maximum depth in the tree, counted from the top level, at
  which a node can match: nodes with a null parentId are at depth
  0, their children at depth 1, and so on.  This applies whatever
  the filter; conditions such as <spanx style="verb">parentId</spanx> and <spanx style="verb">ancestorId</spanx> only
  select among the nodes within it, and depth is never counted
  from them.  So <spanx style="verb">ancestorId</spanx> without <spanx style="verb">depth</spanx> matches the whole
  subtree.  If null, there is no limit.</t>
</list></t>

<t>The following filter criteria are defined:</t>

<t><list style="symbols">
  <t>isTopLevel: "Boolean"  <vspace blankLines='1'/>
If true, the node must have a null parentId to match the
  condition.</t>
  <t>parentId: "Id"  <vspace blankLines='1'/>
A FileNode id.  A node must have a parentId equal to this to
  match the condition.</t>
  <t>ancestorId: "Id"  <vspace blankLines='1'/>
A FileNode id.  A node must have an ancestor (parent, parent
  of parent, etc.) with an id equal to this to match the
  condition.</t>
  <t>descendantId: "Id"  <vspace blankLines='1'/>
A FileNode id.  A node must be an ancestor (parent, parent
  of parent, etc.) of the node with this id to match the
  condition.  This is the inverse of <spanx style="verb">ancestorId</spanx>.</t>
  <t>nodeType: "String"  <vspace blankLines='1'/>
A node type value.  Only nodes whose <spanx style="verb">@type</spanx> is precisely
  this value match this condition.  This filter, and the
  <spanx style="verb">nodeType</spanx> sort property below, are named <spanx style="verb">nodeType</spanx> rather
  than <spanx style="verb">@type</spanx>; they operate on the <spanx style="verb">@type</spanx> property.</t>
  <t>role: "String"  <vspace blankLines='1'/>
A role name.  Only nodes with precisely this role match this
  condition.</t>
  <t>hasAnyRole: "Boolean"  <vspace blankLines='1'/>
If true, any node with a defined role matches this condition.
  If false, any node which has a role does not match this
  condition.</t>
  <t>blobId: "Id"  <vspace blankLines='1'/>
A FileNode must have a blobId equal to this to match the
  condition.</t>
  <t>isExecutable: "Boolean"  <vspace blankLines='1'/>
If true, the FileNode must have a true executable value.</t>
  <t>createdBefore: "UTCDate"  <vspace blankLines='1'/>
The creation date of the node must be before this date to
  match the condition.</t>
  <t>createdAfter: "UTCDate"  <vspace blankLines='1'/>
The creation date of the node must be on or after this date
  to match the condition.</t>
  <t>modifiedBefore: "UTCDate"  <vspace blankLines='1'/>
The modified date of the node must be before this date to
  match the condition.</t>
  <t>modifiedAfter: "UTCDate"  <vspace blankLines='1'/>
The modified date of the node must be on or after this date
  to match the condition.</t>
  <t>accessedBefore: "UTCDate"  <vspace blankLines='1'/>
The accessed date of the node must be before this date to
  match the condition.</t>
  <t>accessedAfter: "UTCDate"  <vspace blankLines='1'/>
The accessed date of the node must be on or after this date
  to match the condition.</t>
  <t>minSize: "UnsignedInt"  <vspace blankLines='1'/>
The size of the node in bytes must be equal to or greater
  than this number to match the condition.</t>
  <t>maxSize: "UnsignedInt"  <vspace blankLines='1'/>
The size of the node in bytes must be less than this number
  to match the condition.</t>
  <t>name: "String"  <vspace blankLines='1'/>
A FileNode must have exactly the same octets in its name
  property to match the condition.</t>
  <t>nameMatch: "String"  <vspace blankLines='1'/>
Matches the <em>name</em> property of the node using glob syntax.
  <spanx style="verb">*</spanx> matches any sequence of characters and <spanx style="verb">?</spanx> matches any
  single character; every other character, brackets included,
  matches itself literally, so no value is malformed.  The match
  is case-insensitive.</t>
  <t>mediaType: "String"  <vspace blankLines='1'/>
A FileNode must have exactly the same octets in its mediaType
  property to match the condition.</t>
  <t>mediaTypeMatch: "String"  <vspace blankLines='1'/>
Matches the <em>mediaType</em> property of the node using the same
  glob syntax as <em>nameMatch</em>.</t>
  <t>body: "String"  <vspace blankLines='1'/>
Match the content of the referenced blob, see the definition
  of <em>body</em> in <xref section="4.4.1" sectionFormat="of" target="JMAP-MAIL"/>.  The server may
  use any technology to extract meaningful text from the blob
  for searching, or interpret the string in any way, to choose
  the nodes that it believes the user wants to see.</t>
  <t>text: "String"  <vspace blankLines='1'/>
Matches a node if the <em>body</em> condition with this value
  matches, or if its name or mediaType contains this value,
  compared case-insensitively.</t>
</list></t>

<t>The blobId, isExecutable, minSize, maxSize, mediaType,
mediaTypeMatch, and body conditions match only nodes whose <spanx style="verb">@type</spanx> is "File".  The
role and hasAnyRole conditions match only nodes whose <spanx style="verb">@type</spanx> is
"Directory".  This applies to both true and false values.  For
example, a hasAnyRole condition of false matches only Directories
without a role, and an isExecutable condition of false matches
only Files that are not executable.</t>

<t>For a node the user can discover but not read, a condition on a
property that FileNode/get returns as null for that node (see
"Access Control") does not match the node, whatever its value.
The body condition, and the body part of the text condition,
never match such a node.</t>

<t>It also supports the following additional sort properties:</t>

<t><list style="symbols">
  <t>tree:  <vspace blankLines='1'/>
Sort by tree; which means by name, but any Directory node is
  immediately followed by the recursive application of
  the same sort to its child nodes.  This is similar to the
  output of the <spanx style="verb">find</spanx> command on a filesystem.</t>
  <t>nodeType:  <vspace blankLines='1'/>
Sort by <spanx style="verb">@type</spanx>.  Directories sort first, then symlinks,
  then files, then nodes of any other <spanx style="verb">@type</spanx> ordered by the
  <spanx style="verb">@type</spanx> value.</t>
</list></t>

<t>When sorting by a property that is not defined for a node's
<spanx style="verb">@type</spanx> (for example <spanx style="verb">size</spanx> on a Directory), or that FileNode/get
returns as null because the user cannot read the node (see
"Access Control"), nodes without the property sort before
nodes that have it when isAscending is true.  Nodes that lack the
property are ordered among themselves as if that Comparator were
absent from the sort.</t>

</section>
<section anchor="filenodequerychanges"><name>FileNode/queryChanges</name>

<t>This is a standard Foo/queryChanges method, which also takes the
<spanx style="verb">depth</spanx> argument of FileNode/query, with the same meaning.</t>

</section>
</section>
</section>
<section anchor="direct-http-write"><name>Direct HTTP Write</name>

<t>When the server advertises a <spanx style="verb">webWriteUrlTemplate</spanx>, clients can
update the content of a File directly via HTTP without using
FileNode/set.  The URL is constructed by expanding the template
with the FileNode id.  This is only valid for nodes with
<spanx style="verb">@type</spanx> "File"; requests targeting any other type of node <bcp14>MUST</bcp14>
be rejected with 400 (Bad Request).  A request for a node that does
not exist, or that the user cannot discover, <bcp14>MUST</bcp14> be rejected with
404 (Not Found).</t>

<t>The user <bcp14>MUST</bcp14> have <spanx style="verb">mayModifyContent</spanx> on the node, which for a File
is in its parent's <spanx style="verb">myRights</spanx> (see "Access Control").  Requests
without it <bcp14>MUST</bcp14> be rejected with 403 (Forbidden).  Authentication
uses the same mechanism as other JMAP HTTP endpoints.</t>

<t>A request that would take the account over its quota (see
"Quotas") <bcp14>MUST</bcp14> be rejected with 507 (Insufficient Storage)
(<xref section="11.5" sectionFormat="of" target="WEBDAV"/>).  Whenever the server rejects a
request, with this or any other status, it <bcp14>MUST NOT</bcp14> change the
node.</t>

<section anchor="preventing-lost-updates"><name>Preventing Lost Updates</name>

<t>The server assigns a strong entity tag (<xref section="8.8.3" sectionFormat="of" target="HTTP"/>) to a File's content at the write URL: the node's current
<spanx style="verb">blobId</spanx> as the opaque value (for example, <spanx style="verb">"Bfa61c0"</spanx> for a node
with <spanx style="verb">blobId</spanx> "Bfa61c0").  A client forms it from FileNode/get, so
it can make even its first write conditional.  On success, the
server <bcp14>MUST</bcp14> include an ETag header field with the new entity tag in
the response to a PUT or PATCH.</t>

<t>The server <bcp14>MUST</bcp14> support If-Match (<xref section="13.1.1" sectionFormat="of" target="HTTP"/>) on
PUT and PATCH.  If the condition is false, the server <bcp14>MUST</bcp14> respond
with 412 (Precondition Failed).  The server <bcp14>MUST</bcp14> evaluate the
condition atomically with the change it makes: two requests carrying
the same entity tag <bcp14>MUST NOT</bcp14> both succeed.  A client
<bcp14>SHOULD</bcp14> send If-Match on every PATCH, and on a PUT unless it intends
to overwrite whatever content the node has.</t>

</section>
<section anchor="put"><name>PUT</name>

<t>A PUT request replaces the entire content of the node.  The
request body is the new content.  The type and subtype of the
Content-Type header field set the <spanx style="verb">mediaType</spanx> of the node; the
server does not store any parameters (such as "charset").  If the
request has no Content-Type header field, the server sets
<spanx style="verb">mediaType</spanx> to "application/octet-stream".  If the Content-Type
header field does not conform to the ABNF of <xref section="8.3" sectionFormat="of" target="HTTP"/>, the server <bcp14>MUST</bcp14> respond with 400 (Bad Request).</t>

<t>On success, the server <bcp14>MUST</bcp14> update the node's <spanx style="verb">blobId</spanx>, <spanx style="verb">size</spanx>,
and <spanx style="verb">mediaType</spanx> properties, and set <spanx style="verb">modified</spanx> to the current
server time (a PUT cannot carry a client timestamp; a client that
wants a different one sets it with FileNode/set afterwards).  It
returns 200 (OK) with a JSON body:</t>

<figure><sourcecode type="json"><![CDATA[
{
  "blobId": "Bnewblob123",
  "size": 48576,
  "mediaType": "text/plain"
}
]]></sourcecode></figure>

</section>
<section anchor="patch"><name>PATCH</name>

<t>A PATCH request applies a partial modification to the node's
current content.  The Content-Type of the request indicates the
patch format.  The supported patch formats are those listed in
the <spanx style="verb">supportedPatchTypes</spanx> capability of <xref target="JMAP-BLOBEXT"/> (for example,
<spanx style="verb">application/x-rdiff-delta</spanx>, <spanx style="verb">application/x-bsdiff</spanx>,
<spanx style="verb">text/x-diff</spanx>).  The server applies the delta to the node's
current blob to produce the new content.</t>

<t>On success, the server <bcp14>MUST</bcp14> update the node's <spanx style="verb">blobId</spanx> and
<spanx style="verb">size</spanx> properties, and set <spanx style="verb">modified</spanx> to the current server time,
as for PUT.  The server <bcp14>MUST NOT</bcp14> change the node's <spanx style="verb">mediaType</spanx>.
A client that needs to change it uses PUT, or updates <spanx style="verb">mediaType</spanx>
with FileNode/set.  The response is 200 (OK) with the same JSON
body as PUT:</t>

<figure><sourcecode type="json"><![CDATA[
{
  "blobId": "Bpatched456",
  "size": 49152,
  "mediaType": "text/plain"
}
]]></sourcecode></figure>

<t>A patch applies exactly or not at all: for <spanx style="verb">text/x-diff</spanx>, every
hunk's context lines <bcp14>MUST</bcp14> match the current content at the place
the hunk gives, with no fuzz or offset.  A patch made against
other content would otherwise land somewhere near and give content
nobody wrote.</t>

<t>Errors in applying a patch are handled as described in
<xref section="2.2" sectionFormat="of" target="HTTP-PATCH"/>.  In particular, the server <bcp14>MUST</bcp14>
respond with 415 (Unsupported Media Type) for a patch format it
does not support, 400 (Bad Request) for a malformed patch, and 409
(Conflict) for a patch that cannot be applied to the node's current
content.</t>

</section>
<section anchor="integrity"><name>Integrity</name>

<t>A PUT or PATCH request <bcp14>MAY</bcp14> carry <spanx style="verb">Repr-Digest</spanx> or <spanx style="verb">Content-Digest</spanx>
header fields <xref target="DIGEST-FIELDS"/> for the data it sends: for PUT, the
new content of the node; for PATCH, the patch.  The server <bcp14>MUST</bcp14>
verify each digest whose algorithm it supports.  If any does not
match, the server <bcp14>MUST</bcp14> respond with 400 (Bad Request).  As
<xref target="DIGEST-FIELDS"/> describes, a digest whose algorithm the server
does not support is ignored, but only if the request also has one
the server does support: if every digest in the request is in an
algorithm the server does not support, it <bcp14>MUST</bcp14> respond with 400
(Bad Request), so that a client never believes content the server
did not check was verified.  This matches Blob/set in
<xref target="JMAP-BLOBEXT"/>.  The algorithms a server
supports are those in the <spanx style="verb">supportedDigestAlgorithms</spanx> capability of
<xref target="JMAP-BLOBEXT"/>, which lists them in the server's order of
preference; clients <bcp14>SHOULD</bcp14> use the first one they support.</t>

<t>A client can ask for a digest of the node's new content by sending
<spanx style="verb">Want-Repr-Digest</spanx> <xref target="DIGEST-FIELDS"/>.  On success, for each
algorithm it lists that the server supports, the server <bcp14>SHOULD</bcp14>
include a member named "digest:" followed by the algorithm name
(for example "digest:sha-256") in the JSON response body, holding
the base64-encoded digest of the node's new content, as Blob/get
does in <xref target="JMAP-BLOBEXT"/>.  The digest is in the body because any
digest header fields on the response describe the response body
itself, not the node.</t>

<figure><sourcecode type="json"><![CDATA[
{
  "blobId": "Bpatched456",
  "size": 49152,
  "mediaType": "text/plain",
  "digest:sha-256": "lu2dEm1cr1Hg2GqVDXMTGP3sgQfFYyp8XUd2ZTgp5Qc="
}
]]></sourcecode></figure>

</section>
</section>
<section anchor="access-control"><name>Access Control</name>

<t>Access control lists are set with <spanx style="verb">shareWith</spanx>, which only nodes
whose <spanx style="verb">@type</spanx> permits children can have.  Rights are inherited
down the tree: a node's <spanx style="verb">myRights</spanx> is the union of the rights
granted to the user by the <spanx style="verb">shareWith</spanx> entries on the node and on
all its ancestors.  Inherited rights are a floor.  A <spanx style="verb">shareWith</spanx>
entry on a descendant can grant a user more rights on that
subtree, but it cannot take away rights granted higher up.</t>

<t>A node whose <spanx style="verb">@type</spanx> does not permit children has no <spanx style="verb">myRights</spanx>.
The user's rights on it are those in its parent's <spanx style="verb">myRights</spanx>;
<spanx style="verb">mayAddChildren</spanx> and <spanx style="verb">mayShare</spanx> do not apply to it.  Such a node
with a null parentId is discoverable only by the account owner,
who has all rights on it.</t>

<t>Nodes which are not "discoverable" <bcp14>MUST</bcp14> be reported in <spanx style="verb">notFound</spanx>
if fetched with FileNode/get and <bcp14>MUST NOT</bcp14> be returned in response to
FileNode/query.  Nodes are discoverable in one of two ways:</t>

<t><list style="numbers" type="1">
  <t>If the node or an ancestor of the node has mayRead true.</t>
  <t>If the node or a descendant of the node has a <spanx style="verb">shareWith</spanx>
entry that grants the user any right.</t>
</list></t>

<t>A node that is discoverable only through the second rule has
mayRead false.  A query with that node as the parent returns only
those of its children that are themselves discoverable.</t>

<t>For a node that is discoverable but does not have <spanx style="verb">mayRead</spanx>,
FileNode/get returns the real values of <spanx style="verb">id</spanx>, <spanx style="verb">@type</spanx>, <spanx style="verb">name</spanx>,
<spanx style="verb">parentId</spanx>, <spanx style="verb">myRights</spanx>, <spanx style="verb">isSubscribed</spanx>, and <spanx style="verb">shareWith</spanx> (which
follows its own rule for <spanx style="verb">mayShare</spanx>).  It returns null for every
other property defined for the node's <spanx style="verb">@type</spanx>, including
<spanx style="verb">created</spanx>, <spanx style="verb">changed</spanx>, and <spanx style="verb">role</spanx>, even where that property's type
does not otherwise allow null.  A change to a property the user
sees as null is not visible to the user, so the server <bcp14>SHOULD NOT</bcp14>
report the node as updated in FileNode/changes because of it, but
<bcp14>MAY</bcp14> do so if it cannot efficiently determine whether any property
visible to the user changed.</t>

<t>Such a node can have descendants the user cannot discover.  A
destroy that would remove any of them, either through
onDestroyRemoveChildren or as part of a node replaced through
onExists, <bcp14>MUST</bcp14> be rejected with "forbidden", and the server <bcp14>MUST
NOT</bcp14> destroy any node in that subtree.  Without
onDestroyRemoveChildren, destroying such a node while it has
children fails with "nodeHasChildren" whether or not the user can
discover those children.</t>

<t>This leads to a sharee seeing the full path to anything that they
have access to, but nothing else.</t>

<t>For example, in a Unix home directory layout where Alice has shared
her "forBob" directory, Bob might see:</t>

<figure><sourcecode type="artwork"><![CDATA[
/home
  /alice
    /shared
      /forBob
        file1.jpg
        file2.txt
        ...
  /bob
    bobfile.txt
    ...
]]></sourcecode></figure>

<t>Alice sees many more files and directories under "/home".</t>

<t>To rename or move a node, or change its role, the server checks
<spanx style="verb">mayRename</spanx>, and to destroy it <spanx style="verb">mayDelete</spanx>, in the rights of the node itself; for a
node with no <spanx style="verb">myRights</spanx>, these are its parent's rights.  Moving a
node also requires <spanx style="verb">mayRead</spanx> on it, and <spanx style="verb">mayAddChildren</spanx> on the new
parent or <spanx style="verb">mayCreateTopLevelFileNode</spanx> to move it to the top level.
Without <spanx style="verb">mayRead</spanx>, a user could move a subtree they cannot read
beneath a parent where they can, and read it through the rights it
inherits there.  Without
these rights, the operation fails with "forbidden".</t>

<t>A Directory with a role cannot be destroyed, renamed or moved; the
server rejects any attempt with "forbidden".  This does not change
the rights it reports in <spanx style="verb">myRights</spanx>, which its children with no
<spanx style="verb">myRights</spanx> of their own take as theirs: files in a directory with
the "trash" role, for example, can still be destroyed.  A client
that needs to destroy, rename or move such a Directory first clears
its role (see "role" in "Directory Properties").</t>

<t>A node's rights can change without any change to the node
itself: through a change to <spanx style="verb">shareWith</spanx> on an ancestor, or when
the node or an ancestor moves to a parent whose inherited rights
differ.  The server <bcp14>MUST</bcp14> report every node whose rights for a user
changed as changed in FileNode/changes for that user, including
nodes that have no <spanx style="verb">myRights</spanx> of their own and take their rights
from their parent.</t>

<t>Otherwise, moving or renaming a node changes only that node.  Its
descendants keep all their properties (their path is not a
property), so the server does not report them in FileNode/changes
unless their rights changed.</t>

<t>When a node stops being discoverable by the user, for example
because a <spanx style="verb">shareWith</spanx> entry was removed or the node was moved out
of a shared Directory, the server reports it as destroyed in
FileNode/changes.</t>

<t>Sharing can make large changes to the set of nodes a user can see:
when Alice first shared that directory, Bob would have been told
of a large number of new nodes in response to a FileNode/changes
query.  The server might report these as
"created" or "updated" — it is not always possible for the server
to know whether a node was previously visible to the user.</t>

</section>
<section anchor="quotas"><name>Quotas</name>

<t>Servers that support JMAP Quotas (<xref target="JMAP-QUOTAS"/>) <bcp14>SHOULD</bcp14>
provide Quota objects with <spanx style="verb">"FileNode"</spanx> in the <spanx style="verb">types</spanx> array.
Both the <spanx style="verb">octets</spanx> resource type (total storage used by FileNode
blobs) and the <spanx style="verb">count</spanx> resource type (number of FileNode
objects) are applicable.</t>

</section>
<section anchor="integration-with-jmap-blob-extensions"><name>Integration with JMAP Blob Extensions</name>

<t>The extensions in this section apply to a request whose <spanx style="verb">using</spanx>
includes both <spanx style="verb">urn:ietf:params:jmap:filenode</spanx> and
<spanx style="verb">urn:ietf:params:jmap:blob2</spanx>.  What the server supports doesn't
change them: in a request whose <spanx style="verb">using</spanx> lacks
<spanx style="verb">urn:ietf:params:jmap:filenode</spanx>, the properties they add are unknown
properties, and the server rejects an object that has them with an
"invalidProperties" SetError, so that a request means the same on
every server.</t>

<t>The ArchiveEntry object type (defined in <xref target="JMAP-BLOBEXT"/>) is
extended with two additional properties:</t>

<t><list style="symbols">
  <t>nodeId: "Id|null"  <vspace blankLines='1'/>
A FileNode id.  When present, the server populates the
  archive entry from the referenced FileNode's properties.
  The <spanx style="verb">blobId</spanx>, <spanx style="verb">name</spanx>, <spanx style="verb">created</spanx>, and <spanx style="verb">modified</spanx> are taken
  from the FileNode.  The user's rights on the
  FileNode (specifically the <spanx style="verb">mayModifyContent</spanx> right) and,
  for a File, the <spanx style="verb">executable</spanx> property inform the <spanx style="verb">mode</spanx> field in the
  archive entry (for example, permissions and executable bit).
  If the ArchiveEntry also provides explicit values for
  any of these properties, the explicit values take
  precedence.  Mutually exclusive with providing <spanx style="verb">blobId</spanx>
  directly when the FileNode's <spanx style="verb">@type</spanx> is "File".</t>
  <t>recurse: "Boolean" (default: false)  <vspace blankLines='1'/>
Only valid when the referenced FileNode's <spanx style="verb">@type</spanx> is
  "Directory".
  When true, the server recursively includes all children
  of the directory in the archive.  Each descendant's
  <spanx style="verb">name</spanx> is the <spanx style="verb">name</spanx> of the referencing entry followed by
  its path relative to the directory.
  Directory names <bcp14>MUST</bcp14> include a trailing <spanx style="verb">/</spanx>.</t>
</list></t>

<t>An archive built from <spanx style="verb">nodeId</spanx> entries holds what those nodes held
when the server processed the Blob/convert, even if the server
generates it later (<xref target="JMAP-BLOBEXT"/>).</t>

<t>For Blob/lookup (<xref target="JMAP-BLOBEXT"/>), a FileNode references a blob
only if the blob is its own <spanx style="verb">blobId</spanx>.  A Directory does not
reference the blobs of the nodes beneath it: otherwise a user who
can discover a Directory, but not read what is in it, could test
whether it holds a file with known content.  As for any type, the
server returns only the ids of nodes the user can discover.</t>

<t>A FileNode with <spanx style="verb">@type</spanx> "SymLink", whether referenced directly by
<spanx style="verb">nodeId</spanx> or reached by <spanx style="verb">recurse</spanx>, is added to the archive as an
entry with <spanx style="verb">entryType</spanx> "symlink".  The server never follows the
symlink.  The entry's <spanx style="verb">linkTarget</spanx> is the elements of the
SymLink's <spanx style="verb">target</spanx> joined with "/".  An absolute target, whose
first element is the empty string, therefore produces a
<spanx style="verb">linkTarget</spanx> that starts with "/".</t>

<t>Some archive formats cannot hold every node type.  For example,
"application/zip" has no symlink entries.  The ArchiveRecipe
(defined in <xref target="JMAP-BLOBEXT"/>) is extended with one additional
property that controls how the server handles such nodes:</t>

<t><list style="symbols">
  <t>onUnsupportedEntry: "String" (default: "error")  <vspace blankLines='1'/>
This applies to any node, referenced by <spanx style="verb">nodeId</spanx> or reached by
  <spanx style="verb">recurse</spanx>, that the archive format cannot represent.  If
  "error", the server rejects the Blob/convert creation with an
  "unsupportedEntry" SetError, and creates no archive.  If
  "skip", the server leaves such nodes out of the archive.  Any
  other value is an "invalidProperties" error.</t>
</list></t>

<t>This property applies only to entries that the server builds
from FileNodes.  An entry that the client gives in full, with an
unsupported <spanx style="verb">entryType</spanx>, is still an "invalidProperties" error as
<xref target="JMAP-BLOBEXT"/> requires.</t>

<t>If <spanx style="verb">nodeId</spanx> references a FileNode that the user does not have
permission to read, or that does not exist, the server <bcp14>MUST</bcp14>
reject the Blob/convert creation with an "invalidProperties"
SetError whose <spanx style="verb">properties</spanx> includes "nodeId", as for any
reference to a record that does not exist
(<xref section="5.3" sectionFormat="of" target="JMAP-CORE"/>).</t>

<section anchor="examples"><name>Examples</name>

<t>To archive an entire directory tree rooted at FileNode
"dirabc" into a zip file:</t>

<figure><sourcecode type="json"><![CDATA[
[["Blob/convert", {
  "accountId": "account1",
  "create": {
    "myarchive": {
      "archive": {
        "type": "application/zip",
        "entries": [{
          "nodeId": "dirabc",
          "name": "project/",
          "recurse": true
        }]
      }
    }
  }
}, "R1"]]
]]></sourcecode></figure>

<t>To archive specific files from different locations along with
a full subdirectory:</t>

<figure><sourcecode type="json"><![CDATA[
[["Blob/convert", {
  "accountId": "account1",
  "create": {
    "selective": {
      "archive": {
        "type": "application/zip",
        "entries": [
          {
            "nodeId": "filenode1",
            "name": "README.txt"
          },
          {
            "nodeId": "dirnode2",
            "name": "docs/",
            "recurse": true
          }
        ]
      }
    }
  }
}, "R1"]]
]]></sourcecode></figure>

</section>
<section anchor="extracting-archives-into-filenodes"><name>Extracting Archives into FileNodes</name>

<t>The ExtractRecipe (defined in <xref target="JMAP-BLOBEXT"/>) is extended with
the following additional properties (see the start of this section
for when they apply):</t>

<t><list style="symbols">
  <t>parentNodeId: "Id|null"  <vspace blankLines='1'/>
The id of a FileNode with <spanx style="verb">@type</spanx> "Directory".  When
  present, the server extracts the archive contents into this
  directory, creating FileNode objects for each entry.
  Subdirectories in the archive are created as FileNodes with
  <spanx style="verb">@type</spanx> "Directory".  File entries become FileNodes with
  <spanx style="verb">@type</spanx> "File" and their <spanx style="verb">blobId</spanx> set to the extracted
  content.  The FileNode's <spanx style="verb">created</spanx> and <spanx style="verb">modified</spanx> are taken
  from the archive entry's, when it has them.  If the archive entry
  includes a <spanx style="verb">mode</spanx> field, the server <bcp14>SHOULD</bcp14> use it to set the
  <spanx style="verb">executable</spanx> property on the created FileNode.  <vspace blankLines='1'/>
Symlink entries become FileNodes with <spanx style="verb">@type</spanx> "SymLink" if
  "SymLink" is in the <spanx style="verb">supportedNodeTypes</spanx> capability.  The
  server splits the entry's <spanx style="verb">linkTarget</spanx> on "/" to produce the
  <spanx style="verb">target</spanx> path elements.  A <spanx style="verb">linkTarget</spanx> that starts with "/"
  produces an empty string as the first element, which marks an
  absolute path.  The server drops any other empty elements.  <vspace blankLines='1'/>
An entry is unsupported if the server cannot create a FileNode
  for it.  These are symlink entries when "SymLink" is not in
  <spanx style="verb">supportedNodeTypes</spanx>, and entries of any type that has no
  FileNode equivalent ("hardlink", "fifo", "blockDevice", and
  "charDevice").  The server splits each entry's name on "/" into
  path components.  It treats every name as relative to
  <spanx style="verb">parentNodeId</spanx>: it ignores any
  leading "/" and the trailing "/" of a directory entry, and
  drops any "." component, so "/docs/", "./docs/" and "docs/" all
  name the same directory.  It converts each component to
  Normalization Form C <xref target="UAX15"/>: archives made on some
  platforms hold names in other forms that nobody chose to write,
  so the server converts them rather than rejecting them as it
  would a name a client gives.  An entry is also unsupported if its
  name contains a ".." component or an empty component (as in
  "docs//readme.txt"), or would produce a name or depth that the
  server would reject in FileNode/set.  The <spanx style="verb">onUnsupportedEntry</spanx>
  property controls how the server handles them.</t>
  <t>onUnsupportedEntry: "String" (default: "error")  <vspace blankLines='1'/>
If "error", the server rejects the Blob/convert creation with
  an "unsupportedEntry" SetError, and creates no FileNodes.  If
  "skip", the server does not create a FileNode for an
  unsupported entry, and extracts the other entries as usual.  A
  skipped entry still appears in the response <spanx style="verb">entries</spanx> array,
  with a null <spanx style="verb">nodeId</spanx>.  Any other value is an
  "invalidProperties" error.</t>
  <t>onExists: "String|null" (default: null)  <vspace blankLines='1'/>
Controls the behavior when an extracted entry would collide
  with an existing FileNode name under the same parent.  The
  values and semantics are the same as for FileNode/set (see
  above): null rejects with an "alreadyExists" SetError,
  "replace" destroys the existing node, and "rename" gives the new
  node a server-chosen name.  <vspace blankLines='1'/>
A directory entry that collides with an existing Directory
  the user can discover does not use <spanx style="verb">onExists</spanx>: the server
  merges the entry into the existing Directory.  It creates no new node for that entry,
  leaves the existing Directory's properties unchanged, and
  extracts the entries beneath it into the existing Directory,
  where their own collisions are handled in the same way.
  Adding a node to an existing Directory requires
  <spanx style="verb">mayAddChildren</spanx> on it, as for FileNode/set.  <vspace blankLines='1'/>
<spanx style="verb">onExists</spanx> applies to every other collision: a file or symlink
  entry with any existing node, or a directory entry with an
  existing node that is not a Directory.  When "rename" renames
  a directory entry, the entries beneath it are extracted into
  the renamed Directory.  The extraction has no equivalent of
  onDestroyRemoveChildren, so "replace" of an existing node
  that has children fails with "nodeHasChildren".</t>
</list></t>

<t>If extraction fails for any reason, the server rejects the
Blob/convert creation with the SetError for that failure (for
example "alreadyExists", "forbidden", "nodeHasChildren", or
"unsupportedEntry"), and <bcp14>MUST NOT</bcp14> create, destroy or change any
FileNode.  An extraction either succeeds as a whole or has no
effect.  An archive that is damaged or ends early, which without
<spanx style="verb">parentNodeId</spanx> would give a result with <spanx style="verb">isIncomplete</spanx> true
(<xref target="JMAP-BLOBEXT"/>), is a failure here: the server rejects the
creation with "conversionFailed" rather than extracting the entries
before the damage.</t>

<t>When <spanx style="verb">parentNodeId</spanx> is set, each ArchiveEntry in the response
<spanx style="verb">entries</spanx> array includes an additional <spanx style="verb">nodeId</spanx> property
containing the id of the FileNode that was created for that
entry, the id of the existing Directory for a directory entry
that was merged into it, or null if the server skipped the entry.</t>

<t>When <spanx style="verb">parentNodeId</spanx> is set, the result also has a <spanx style="verb">destroyed</spanx>
property, as the response to FileNode/set has:</t>

<t><list style="symbols">
  <t>destroyed: "Id[]|null"  <vspace blankLines='1'/>
The ids of the FileNodes that "replace" in <spanx style="verb">onExists</spanx> destroyed
  (which never have children; see <spanx style="verb">onExists</spanx>).  This is null if
  no FileNodes were destroyed.  A node the same extraction created
  and then replaced, as an archive that holds two entries of one
  name can make happen, was never reported to the client, and is
  not listed.</t>
</list></t>

<t>If <spanx style="verb">parentNodeId</spanx> references a FileNode that does not exist,
is not a Directory, or for which the user does not have
<spanx style="verb">mayAddChildren</spanx> permission, the server <bcp14>MUST</bcp14> reject the Blob/convert
creation with an appropriate SetError: "invalidProperties", whose
<spanx style="verb">properties</spanx> includes "parentNodeId", if it does not exist or is
not a Directory, and "forbidden" without <spanx style="verb">mayAddChildren</spanx>.</t>

<section anchor="example"><name>Example</name>

<t>Extracting a zip file into a directory:</t>

<figure><sourcecode type="json"><![CDATA[
[["Blob/convert", {
  "accountId": "account1",
  "create": {
    "e1": {
      "extract": {
        "blobId": "Barchive123",
        "type": "application/zip",
        "parentNodeId": "dir456"
      }
    }
  }
}, "R1"]]
]]></sourcecode></figure>

<t>The response includes a <spanx style="verb">nodeId</spanx> for each created entry:</t>

<figure><sourcecode type="json"><![CDATA[
[["Blob/convert", {
  "accountId": "account1",
  "created": {
    "e1": {
      "id": "Barchive123",
      "type": "application/zip",
      "size": 104857,
      "entries": [
        {
          "name": "docs/",
          "entryType": "directory",
          "nodeId": "node001"
        },
        {
          "name": "docs/readme.txt",
          "blobId": "Bdd001",
          "entryType": "file",
          "modified": "2026-03-01T12:00:00Z",
          "mode": "0644",
          "nodeId": "node002"
        },
        {
          "name": "docs/logo.png",
          "blobId": "Bdd002",
          "entryType": "file",
          "modified": "2026-02-15T09:30:00Z",
          "mode": "0644",
          "nodeId": "node003"
        }
      ],
      "destroyed": null
    }
  },
  "notCreated": {}
}, "R1"]]
]]></sourcecode></figure>

</section>
</section>
<section anchor="the-unsupportedentry-error"><name>The unsupportedEntry Error</name>

<t>An "unsupportedEntry" SetError means that an archive or
extraction with <spanx style="verb">onUnsupportedEntry</spanx> set to "error" found one or
more entries that it could not handle.  The SetError object <bcp14>MUST</bcp14>
include an <spanx style="verb">entryNames</spanx> property: a "String[]" that lists the
<spanx style="verb">name</spanx> of each such entry.  For an archive, this is the name that
the entry would have had in the archive.</t>

</section>
</section>
<section anchor="extended-attributes-and-named-streams"><name>Extended Attributes and Named Streams</name>

<t>Operating systems associate named side-channel data with files: POSIX extended
attributes (getxattr/setxattr), macOS extended attributes (including Finder
tags and the quarantine flag) and resource forks, NTFS and SMB2 alternate data
streams, and NFSv4 named attributes.  A FileNode carries these using the JMAP
Object Metadata extension (<xref target="JMAP-METADATA"/>).  A server that supports named
attributes on FileNodes lists "FileNode" in the "dataTypes" of its
<spanx style="verb">urn:ietf:params:jmap:metadata</spanx> capability.  Clients then read and write the
attributes through the "metadata" property, and through the "privateMetadata"
property where the server sets <spanx style="verb">supportsPrivate</spanx>.  That extension adds both
properties to the FileNode object, on FileNodes of every <spanx style="verb">@type</spanx>.</t>

<section anchor="the-xattr-namespace"><name>The "xattr" Namespace</name>

<t>This document defines the "xattr" namespace for the "metadata" and
"privateMetadata" properties.  Its value is an object mapping an attribute name
to the attribute's value.  The attribute name is the platform-native name of
the attribute or stream, stored verbatim (for example "user.comment",
"com.apple.metadata:_kMDItemUserTags", or "Zone.Identifier").  Servers and
clients <bcp14>MUST NOT</bcp14> normalize attribute names across platforms.  The server keeps
an attribute that one platform writes, even where another platform has no
equivalent for it.</t>

<t>An attribute value whose bytes are valid UTF-8 <bcp14>MAY</bcp14> be a String holding that
text.  Any other value <bcp14>MUST</bcp14> be a Binary value as defined in <xref target="JMAP-METADATA"/>
(for example "com.apple.FinderInfo", a binary plist, or a resource fork).
The server returns a value in the form the client stored it.</t>

<t>Attribute values are ordinary metadata: they count against the size limits
and quota of <xref target="JMAP-METADATA"/>, and are copied, shared and protected by the
rules there like any other namespace value.  A server rejects an attribute
too large for its limits with the errors <xref target="JMAP-METADATA"/> defines, so a
large named stream such as a resource fork can only be stored where the
server's limits allow it.</t>

<t>Attributes shared with every reader of the node (for example a quarantine flag)
are stored under "metadata".  Attributes private to the current user (for
example that user's own tags) are stored under "privateMetadata" where the
server supports it.</t>

<t>Example — a textual attribute and a binary one:</t>

<figure><sourcecode type="json"><![CDATA[
{
  "metadata": {
    "xattr": {
      "user.comment": "draft copy",
      "com.apple.FinderInfo": {
        "@type": "Binary",
        "base64": "VEVYVHR0eHQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
      }
    }
  }
}
]]></sourcecode></figure>

<t>To set or remove a single attribute without disturbing the others, a client
patches the path directly.  RFC 6901 escaping applies to any "/" or "~" in the
attribute name ("/" as "~1", "~" as "~0"):</t>

<figure><sourcecode type="json"><![CDATA[
[["FileNode/set", {
  "accountId": "u1",
  "update": {
    "f42": {
      "metadata/xattr/Zone.Identifier":
        "[ZoneTransfer]\r\nZoneId=3\r\n"
    }
  }
}, "0"]]
]]></sourcecode></figure>

<t>Setting an attribute's path to null removes it, following the "metadata" patch
semantics of <xref target="JMAP-METADATA"/>.</t>

</section>
</section>
<section anchor="implementation-considerations"><name>Implementation Considerations</name>

<section anchor="modification-timestamps"><name>Modification Timestamps</name>

<t>Clients <bcp14>SHOULD</bcp14> provide an updated <spanx style="verb">modified</spanx> value when changing
the content of a node.  This gives clients control over the
timestamp, for example when preserving original modification times
during file synchronization.  Clients that do not care about
preserving timestamps can set <spanx style="verb">modified</spanx> to null to have the server
use the current time.</t>

<t>Renaming or moving a node does not change its <spanx style="verb">modified</spanx> time, as
on common local filesystems.  A client <bcp14>SHOULD NOT</bcp14> include
<spanx style="verb">modified</spanx> in an update that only renames or moves a node.</t>

<t>Clients may also choose to update the <spanx style="verb">modified</spanx> timestamp on a
parent directory when moving a child node in or out, to reflect
that the directory's contents have changed.</t>

</section>
<section anchor="timestamp-precision"><name>Timestamp Precision</name>

<t>The UTCDate type (<xref section="1.4" sectionFormat="of" target="JMAP-CORE"/>) supports
fractional seconds.
Servers <bcp14>SHOULD</bcp14> include sub-second precision in <spanx style="verb">created</spanx>,
<spanx style="verb">modified</spanx>, <spanx style="verb">accessed</spanx>, and <spanx style="verb">changed</spanx> timestamps where their
storage backend supports it.  Clients <bcp14>MUST</bcp14> preserve fractional
seconds when they send timestamps back to the server.</t>

<t>A server <bcp14>MAY</bcp14> store timestamps with less precision than a client
sends, down to whole seconds.  It then truncates the value it
stores, and returns the stored value in FileNode/get, so a client
can learn the precision in use.  Clients comparing a local time
with a server timestamp (for example to recognize their own
changes) need to allow for this.  Comparisons the server makes
between timestamps use the stored precision.</t>

</section>
<section anchor="filename-character-restrictions"><name>Filename Character Restrictions</name>

<t>Servers should set <spanx style="verb">forbiddenNameChars</spanx> to include characters
that are problematic for their storage backend and for the
broadest set of clients, and may reject names that are
problematic (see "name" in "Common Properties").</t>

<t>The following characters are problematic on common platforms:</t>

<t><list style="symbols">
  <t>Windows: <spanx style="verb">&lt;</spanx>, <spanx style="verb">&gt;</spanx>, <spanx style="verb">:</spanx>, <spanx style="verb">"</spanx>, <spanx style="verb">\</spanx>, <spanx style="verb">|</spanx>, <spanx style="verb">?</spanx>, <spanx style="verb">*</spanx>, and
control characters (U+0000-U+001F).  Windows also forbids
trailing dots and spaces in names.</t>
  <t>macOS: <spanx style="verb">:</spanx> (HFS+ legacy; displayed as <spanx style="verb">/</spanx> in Finder).</t>
  <t>Linux: the null byte (U+0000).</t>
</list></t>

<t>Every server rejects "/", "." and ".." (see "name").  The
following names are also problematic:</t>

<t><list style="symbols">
  <t>Windows: reserved device names CON, PRN, AUX, NUL,
COM0-COM9, and LPT0-LPT9.  These are reserved regardless
of file extension (for example, "CON.txt" is also forbidden).</t>
</list></t>

<t>A server targeting broad client compatibility should include
at least <spanx style="verb">&lt;&gt;:"\|?*</spanx> in <spanx style="verb">forbiddenNameChars</spanx>.  Clients that sync to platforms with further
restrictions, such as the Windows reserved names, need to handle
those names locally, since other clients may create them.</t>

</section>
<section anchor="case-sensitivity"><name>Case Sensitivity</name>

<t>Windows and macOS filesystems are typically case-insensitive
(treating "Foo" and "foo" as the same name), while Linux
filesystems are typically case-sensitive.  Clients syncing to
case-insensitive platforms should use <spanx style="verb">compareCaseInsensitively</spanx>
on FileNode/set requests to prevent creating sibling nodes
whose names differ only in case, as these cannot coexist on
the target platform.</t>

<t>macOS filesystems also treat names that differ only in Unicode
normalization as the same name.  Requiring Normalization Form C
(see "name") keeps two such names from being siblings, but a
client on macOS has to convert the names its platform gives it
before sending them.</t>

</section>
<section anchor="access-time-updates"><name>Access Time Updates</name>

<t>Updating <spanx style="verb">accessed</spanx> on every file read generates significant
API traffic for little value.  Clients are encouraged to use a
"relatime" strategy similar to modern POSIX filesystems: only
update <spanx style="verb">accessed</spanx> if the current value is older than <spanx style="verb">modified</spanx>,
or if more than 24 hours have elapsed since the last <spanx style="verb">accessed</spanx>
update.  Clients should batch access time updates with their
next JMAP request rather than making a dedicated call.</t>

</section>
</section>
<section anchor="security-considerations"><name>Security Considerations</name>

<t>All security considerations from <xref target="JMAP-CORE"/> apply to this document.</t>

<section anchor="path-traversal"><name>Path Traversal</name>

<t>Clients that reconstruct filesystem paths from FileNode hierarchies
<bcp14>MUST</bcp14> validate the resulting paths and reject any that would escape
the intended directory tree.  Servers reject names containing "/"
and the names "." and ".." (see "name"), so no node name, and no
path a server builds by joining names with "/" (as in an archive),
can traverse.  When extracting
an archive into FileNodes, the server builds the tree itself, so
it resolves every entry name relative to <spanx style="verb">parentNodeId</spanx>, even one
with a leading "/", and treats entry names that could escape it as
unsupported entries (see "Extracting Archives into FileNodes").</t>

</section>
<section anchor="symlink-targets"><name>Symlink Targets</name>

<t>Symlink targets are not validated by the server to point to
existing nodes.  Clients that resolve symlinks <bcp14>MUST</bcp14> guard
against symlink loops (a symlink pointing to an ancestor of
itself) and <bcp14>MUST NOT</bcp14> follow symlinks outside the FileNode tree.
Servers <bcp14>SHOULD</bcp14> impose a limit on the length of <spanx style="verb">target</spanx> values
and <bcp14>MAY</bcp14> reject targets containing ".." path components.</t>

</section>
<section anchor="denial-of-service"><name>Denial of Service</name>

<t>Deep nesting of FileNodes or very large numbers of children under a
single parent can consume significant server resources.  Servers
<bcp14>SHOULD</bcp14> enforce reasonable limits via <spanx style="verb">maxFileNodeDepth</spanx> and <bcp14>MAY</bcp14>
impose additional limits on the number of children per node.
Recursive operations, such as destroying a subtree with
<spanx style="verb">onDestroyRemoveChildren</spanx> or copying a Directory with
FileNode/copy, can be expensive; servers <bcp14>SHOULD</bcp14> impose limits on
the size of subtrees that can be destroyed or copied in a single
operation.</t>

</section>
<section anchor="access-control-1"><name>Access Control</name>

<t>The discoverability rules defined in this document mean that ancestor
nodes of shared content are visible (with <spanx style="verb">mayRead</spanx> false) to users
who have access to descendants.  While these ancestor nodes do not
expose file content, their names and structure may reveal information
about the file hierarchy.  Server administrators and users sharing
content should be aware of this.</t>

<t>A user who can destroy a node, but cannot discover all of its
descendants, can still learn that the node has children: the
destroy fails with "nodeHasChildren", or with "forbidden" when
onDestroyRemoveChildren is true.  Any failure reveals this.
The alternatives would be to reveal the ids of the hidden nodes,
or to destroy data the user cannot see, and both are worse.</t>

<t>In the same way, a user who can add children to a Directory, but
cannot discover all of its children, can learn which names its
hidden children have: creating a node fails when the name is taken
and succeeds when it isn't, and "rename" in <spanx style="verb">onExists</spanx> returns a
name derived from the one taken.  A server that wants a Directory
others can add to without learning its contents (a "drop box") has
to accept this, or give each user a Directory of their own.</t>

<t>Changes to the <spanx style="verb">shareWith</spanx> property on a node affect all
descendants, and so does moving a node to a parent that is shared
differently.  Removing sharing from a parent node, or moving a
subtree out of a shared Directory, makes those nodes
undiscoverable to the affected users, unless a descendant is also
shared with them directly, which may be surprising if those users
had been actively working with the shared files.</t>

</section>
<section anchor="extended-attributes"><name>Extended Attributes</name>

<t>Some extended attributes carry security meaning on the platform that
reads them.  On Linux, "security.capability" grants capabilities to an
executable, "security.selinux" sets its security label, and attributes
under "trusted." and "system." (such as "system.posix_acl_access") change
privileges or access control.  Anyone with write access to a node can set
these values, so a client that restores them lets that user change
privileges on the client's machine.  Clients <bcp14>MUST NOT</bcp14> apply attributes
whose names begin with "security.", "trusted." or "system." to local files
unless explicitly configured to by the local administrator.</t>

<t>Other attributes mark files as downloaded from an untrusted source, such
as "com.apple.quarantine" on macOS and the "Zone.Identifier" stream on
Windows, and the platform warns before such a file is opened.  A client
that drops these markers when it syncs a file lets the file bypass that
warning, so clients <bcp14>SHOULD</bcp14> preserve them.  A client <bcp14>SHOULD NOT</bcp14> treat the
absence of a marker as evidence that a file is safe: any user with write
access to the node can remove it.</t>

</section>
<section anchor="content-security"><name>Content Security</name>

<t>Servers that perform content scanning or malware detection <bcp14>SHOULD</bcp14>
scan blobs referenced by FileNode objects.  The <spanx style="verb">mediaType</spanx> property is
client-asserted and <bcp14>MUST NOT</bcp14> be trusted for security decisions;
servers <bcp14>SHOULD</bcp14> independently verify content types where this matters.</t>

</section>
</section>
<section anchor="iana-considerations"><name>IANA Considerations</name>

<section anchor="jmap-capability-registration-for-filenode"><name>JMAP Capability Registration for "filenode"</name>

<t>IANA is requested to register the "filenode" JMAP Capability as follows:</t>

<t>Capability Name: urn:ietf:params:jmap:filenode</t>

<t>Specification document: this document</t>

<t>Intended use: common</t>

<t>Change Controller: IETF</t>

<t>Security and privacy considerations: this document, Security Considerations</t>

</section>
<section anchor="jmap-error-codes-registration-for-nodehaschildren"><name>JMAP Error Codes Registration for "nodeHasChildren"</name>

<t>IANA is requested to register the "nodeHasChildren" JMAP Error Code as follows:</t>

<t>JMAP Error Code: nodeHasChildren</t>

<t>Intended use: common</t>

<t>Change Controller: IETF</t>

<t>Description: A FileNode could not be destroyed or replaced because it has children, and the client did not ask for them to be destroyed too.</t>

<t>Reference: this document</t>

</section>
<section anchor="jmap-error-codes-registration-for-unsupportedentry"><name>JMAP Error Codes Registration for "unsupportedEntry"</name>

<t>IANA is requested to register the "unsupportedEntry" JMAP Error Code as follows:</t>

<t>JMAP Error Code: unsupportedEntry</t>

<t>Intended use: common</t>

<t>Change Controller: IETF</t>

<t>Description: An archive or extraction found entries that the archive format or the server cannot represent, and the client asked for an error rather than for the entries to be skipped.</t>

<t>Reference: this document</t>

</section>
<section anchor="jmap-data-types-registration-for-filenode"><name>JMAP Data Types Registration for "FileNode"</name>

<t>IANA is requested to register the "FileNode" JMAP Data Type as follows:</t>

<t>Type Name: FileNode</t>

<t>Can Reference Blobs: Yes</t>

<t>Can Use For State Change: Yes</t>

<t>Capability: urn:ietf:params:jmap:filenode</t>

<t>Reference: this document</t>

</section>
<section anchor="jmap-filenode-types-registry"><name>JMAP FileNode Types Registry</name>

<t>IANA is requested to create a new "JMAP FileNode Types" registry
with the following initial values.  New registrations are subject
to Specification Required (<xref target="IANA-GUIDELINES"/>).
A registration <bcp14>MUST</bcp14> reference a specification that defines the
properties specific to the type and whether nodes of the type
may have children.</t>

<texttable>
      <ttcol align='left'>Type</ttcol>
      <ttcol align='left'>Description</ttcol>
      <ttcol align='left'>Children</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>File</c>
      <c>A regular file with blob content</c>
      <c>No</c>
      <c>this document</c>
      <c>Directory</c>
      <c>A collection that may contain child nodes</c>
      <c>Yes</c>
      <c>this document</c>
      <c>SymLink</c>
      <c>A symbolic link to another path in the tree</c>
      <c>No</c>
      <c>this document</c>
</texttable>

</section>
<section anchor="jmap-filenode-roles-registry"><name>JMAP FileNode Roles Registry</name>

<t>IANA is requested to create a new "JMAP FileNode Roles" registry
with the following initial values.  New registrations are subject
to Expert Review (<xref target="IANA-GUIDELINES"/>).  The Designated Expert
checks that a new role is not already covered by an existing one,
and that its description says which directory a client should
give it.</t>

<texttable>
      <ttcol align='left'>Role</ttcol>
      <ttcol align='left'>Description</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>root</c>
      <c>The base of a filesystem</c>
      <c>this document</c>
      <c>home</c>
      <c>A user's home directory</c>
      <c>this document</c>
      <c>temp</c>
      <c>Temporary space; may be cleaned up automatically</c>
      <c>this document</c>
      <c>trash</c>
      <c>Deleted data; may be removed automatically or manually</c>
      <c>this document</c>
      <c>documents</c>
      <c>Document storage</c>
      <c>this document</c>
      <c>downloads</c>
      <c>Downloaded files</c>
      <c>this document</c>
      <c>music</c>
      <c>Audio files</c>
      <c>this document</c>
      <c>pictures</c>
      <c>Photos and images</c>
      <c>this document</c>
      <c>videos</c>
      <c>Video files</c>
      <c>this document</c>
</texttable>

</section>
<section anchor="jmap-metadata-namespace-registration-for-xattr"><name>JMAP Metadata Namespace Registration for "xattr"</name>

<t>IANA is requested to register the "xattr" namespace in the "JMAP Metadata
Namespaces" registry established by <xref target="JMAP-METADATA"/>:</t>

<t>Namespace Identifier: xattr</t>

<t>Value Type: <spanx style="verb">String[String|Binary]</spanx> — an object mapping an attribute name to
its value, as defined in "Extended Attributes and Named Streams" of this
document.</t>

<t>Applicable Properties: metadata, privateMetadata</t>

<t>Applicable Data Types: FileNode</t>

<t>Reference: this document</t>

<t>Intended Usage: common</t>

<t>Change Controller: IETF</t>

</section>
</section>
<section anchor="changes"><name>Changes</name>

<t>EDITOR: please remove this section before publication.</t>

<t>The source of this document exists on github at: https://github.com/brong/draft-gondwana-jmap-filenode/</t>

<t><strong>draft-ietf-jmap-filenode-21</strong></t>

<t><list style="symbols">
  <t>A name <bcp14>MUST</bcp14> be in Normalization Form C, and the server rejects one
a client gives in any other form; archive entry names are converted
instead.  A name <bcp14>MUST NOT</bcp14> contain "/" or be "." or "..", rather
than servers being encouraged to refuse them.</t>
  <t>Case-insensitive comparison is the default case folding of the
(NFC) name, not "i;unicode-casemap", whose compatibility
decomposition made names equal that no filesystem treats as equal.</t>
  <t>onExists "replace" fails with "alreadyExists" when more than one
node matches the name, or when another update in the method renames
or moves the node; with "invalidProperties" when the node is the one
being moved or copied, or its ancestor; and with "forbidden" when it
would remove a Directory with a role.  A recursive destroy can't
remove a Directory with a role either.</t>
  <t><spanx style="verb">mayShare</spanx> lets a user grant or remove any right for any other
user, but not change their own entry.  A server may leave out
entries for users the requester can't know of, and an update then
leaves them alone.</t>
  <t>nameMatch has only <spanx style="verb">*</spanx> and <spanx style="verb">?</spanx>; brackets match literally.</t>
  <t>A File's entity tag at the write URL is its quoted <spanx style="verb">blobId</spanx>, and
If-Match is evaluated atomically with the write.</t>
  <t>A direct write whose digests are all in unsupported algorithms is
rejected, as Blob/set does.</t>
  <t>A <spanx style="verb">text/x-diff</spanx> patch applies exactly, without fuzz.</t>
  <t>Extracting a damaged or truncated archive into FileNodes fails with
"conversionFailed" rather than extracting part of it.</t>
  <t>Security considerations describe how adding to a Directory reveals
which names its hidden children have.</t>
  <t>The properties this document adds to Blob/convert objects apply
when the request's <spanx style="verb">using</spanx> has both capabilities, and are unknown
properties otherwise.</t>
  <t>Extracting into FileNodes returns <spanx style="verb">destroyed</spanx>, as FileNode/set
does.</t>
  <t>Replacing only the expected node takes "atomic" as well as
"ifUnchangedBy" from JMAP-CONDITIONAL, so the destroy can't succeed
without the create.</t>
  <t>Moving a node needs <spanx style="verb">mayRead</spanx> on it, so a move can't give the user
read access to what they couldn't read before.</t>
  <t>Error codes follow RFC8620 and RFC8621: a missing blob in a create
or update is "blobNotFound" with a <spanx style="verb">notFound</spanx> list; a <spanx style="verb">parentId</spanx>,
<spanx style="verb">parentNodeId</spanx> or archive <spanx style="verb">nodeId</spanx> naming no node the user can
discover is "invalidProperties"; a role another Directory already
has is "alreadyExists" with its <spanx style="verb">existingId</spanx>.</t>
  <t>For Blob/lookup, a FileNode references only its own <spanx style="verb">blobId</spanx>, not
the blobs of its descendants.  An archive built from <spanx style="verb">nodeId</spanx>
entries reflects the nodes at the time of Blob/convert.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-20</strong></t>

<t><list style="symbols">
  <t><spanx style="verb">created</spanx> and <spanx style="verb">modified</spanx> map to the ArchiveEntry properties of the
same names in both directions.</t>
  <t>A create or move that would place a node, or any of its
descendants, deeper than <spanx style="verb">maxFileNodeDepth</spanx> fails with
"invalidProperties".  (Thanks to Mark Atwood.)</t>
  <t>Case-insensitive name comparisons use the "i;unicode-casemap"
collation (RFC 5051).  (Thanks to Mark Atwood.)</t>
  <t>The root of the tree for SymLink targets is the set of top-level
nodes, not a Directory with the "root" role.  A relative target on
a top-level node resolves from the root, and ".." at the root does
not resolve.  (Thanks to Mark Atwood.)</t>
  <t>Archive entries reached by <spanx style="verb">recurse</spanx> are named with the referencing
entry's <spanx style="verb">name</spanx> as a prefix, and the example no longer uses "/" as an
entry name.  (Thanks to Mark Atwood.)</t>
  <t>When extracting into FileNodes, an entry whose name has a ".." or
empty component, or would produce a name or depth that FileNode/set
rejects, is an unsupported entry.  Entry names are relative to
<spanx style="verb">parentNodeId</spanx>: a leading "/", the trailing "/" of a directory,
and "." components are ignored.  (Thanks to Mark Atwood.)</t>
  <t><spanx style="verb">changed</spanx> must be updated for properties that have the same value
for every user.  A change to a per-user property, or to <spanx style="verb">myRights</spanx>
through an ancestor's <spanx style="verb">shareWith</spanx>, need not update it, and should
be reported in FileNode/changes only to affected users, but a
server that cannot tell which users are affected may report it to
others.  (Thanks to Mark Atwood.)</t>
  <t>A client can set or clear a Directory's <spanx style="verb">role</spanx> with <spanx style="verb">mayRename</spanx>.
At most one Directory in an account has a given role.  A server
may refuse a role change for policy reasons, such as a role it
manages itself or one allowed only at the top level.  Clearing a role
lifts the restrictions on destroying, renaming and moving the
Directory.  (Thanks to Mark Atwood.)</t>
  <t>FileNode/copy of a Directory copies its whole subtree without
loss, as a whole or not at all, much as if archived and extracted
into the new Directory.  File content is copied into the
destination account; <spanx style="verb">shareWith</spanx> and <spanx style="verb">role</spanx> are not copied;
<spanx style="verb">isSubscribed</spanx> takes its default; and <spanx style="verb">metadata</spanx> and
<spanx style="verb">privateMetadata</spanx> are copied as <xref target="JMAP-METADATA"/> describes.
Copying requires <spanx style="verb">mayRead</spanx> on the original and <spanx style="verb">mayAddChildren</spanx>
on the destination parent.  The implicit destroy for onSuccessDestroyOriginal
removes the descendants too; destroyFromIfInState guards against
changes in between.  FileNode/copy may copy within one account,
relaxing the RFC 8620 rule that the accounts differ.  (Thanks to
Mark Atwood.)</t>
  <t>Moving a node reports its descendants in FileNode/changes only
when their inherited rights change, under the same rule as a
<spanx style="verb">shareWith</spanx> change on an ancestor.</t>
  <t><spanx style="verb">maxFileNodeDepth</spanx> is defined in terms of ancestors, and its
relation to the query <spanx style="verb">depth</spanx> argument (which counts from 0) is
stated.</t>
  <t><spanx style="verb">mayRename</spanx> covers changing a Directory's <spanx style="verb">role</spanx>.</t>
  <t><spanx style="verb">created</spanx> follows the same rules as <spanx style="verb">modified</spanx>, and is settable
with <spanx style="verb">mayModifyContent</spanx>.</t>
  <t>"replace" through onExists lists destroyed descendants in
"destroyed".</t>
  <t><spanx style="verb">modified</spanx> and <spanx style="verb">accessed</spanx> have type "UTCDate", like <spanx style="verb">created</spanx>;
setting them to null still sets the current server time.</t>
  <t>Editorial: Access Control defines discoverability before the rules
that use it; Direct HTTP Write states once that a rejected request
changes nothing; removed restated requirements; FileNode/changes
points to the rules that report nodes without property changes;
Security Considerations cover moves and recursive copies.</t>
  <t>Direct HTTP Write returns a strong entity tag in ETag (the
<spanx style="verb">blobId</spanx> is recommended), and honors If-Match with 412
(Precondition Failed); clients <bcp14>SHOULD</bcp14> send If-Match on PATCH.  Defined the
responses for an over-quota write (507), an invalid Content-Type
(400), and patch errors (as in <xref target="HTTP-PATCH"/>).  <xref target="WEBDAV"/> is now
a normative reference.  (Thanks to Mark Atwood.)</t>
  <t>Extracting an archive merges a directory entry into an existing
Directory of the same name, rather than applying <spanx style="verb">onExists</spanx>;
entries beneath a renamed directory follow it; and an extraction
either succeeds as a whole or has no effect.  (Thanks to Mark
Atwood.)</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-19</strong></t>

<t><list style="symbols">
  <t>The query <spanx style="verb">depth</spanx> argument is counted from the top level of the
account (top-level nodes are at depth 0), whatever the filter, and
absent or null now means no limit rather than "do not recurse".
FileNode/queryChanges takes it too.</t>
  <t>Renaming, moving or destroying a node checks <spanx style="verb">mayRename</spanx> or
<spanx style="verb">mayDelete</spanx> on the node itself, which for a node without
<spanx style="verb">myRights</spanx> are its parent's rights.  Moving also needs
<spanx style="verb">mayAddChildren</spanx> on the new parent.  A Directory with a role
cannot be destroyed, renamed or moved, without changing the
rights it reports.</t>
  <t>A node that stops being discoverable is reported as destroyed in
FileNode/changes.</t>
  <t><spanx style="verb">isSubscribed</spanx> is per user, and setting it needs no rights beyond
discovering the node.</t>
  <t>A <spanx style="verb">shareWith</spanx> change <bcp14>MUST</bcp14> be reported as a change to every node in
the subtree, including nodes without <spanx style="verb">myRights</spanx>, so clients need
not work out which nodes it affects.</t>
  <t>Removed the <spanx style="verb">forbiddenNodeNames</spanx> capability: it could not
express the names that matter (such as "CON.txt"), clients did
not use it, and a server can reject names it cannot store
regardless.</t>
  <t>Removed the "newest" and "unchanged" values of <spanx style="verb">onExists</spanx>.
"newest" compared client clocks and was easily mistaken for a
content precondition.  "unchanged" duplicated, and conflicted
with, <xref target="JMAP-CONDITIONAL"/>: to replace a node only if it is the
one expected, a client destroys it and creates the replacement in
one FileNode/set, with an "ifUnchangedBy" precondition on the
destroy.  <xref target="JMAP-CONDITIONAL"/> is now an informative reference.</t>
  <t>Creating or moving a node to the top level without
<spanx style="verb">mayCreateTopLevelFileNode</spanx> fails with "forbidden".</t>
  <t>Direct HTTP Write PUT and PATCH set <spanx style="verb">modified</spanx> to the current
server time.</t>
  <t>Direct HTTP Write accepts <spanx style="verb">Repr-Digest</spanx> and <spanx style="verb">Content-Digest</spanx>
<xref target="DIGEST-FIELDS"/> on PUT and PATCH, rejecting a mismatch, and
returns digests of the new content requested with
<spanx style="verb">Want-Repr-Digest</spanx>.</t>
  <t>Fixed the blob capability name in the ArchiveEntry text to
<spanx style="verb">urn:ietf:params:jmap:blob2</spanx>, matching <xref target="JMAP-BLOBEXT"/>.</t>
  <t>Renaming or moving a node does not change its <spanx style="verb">modified</spanx> time;
the guidance to update <spanx style="verb">modified</spanx> now applies to content changes.</t>
  <t>A server may store timestamps with less precision than clients
send, down to whole seconds, truncating and returning the stored
value.</t>
  <t>Direct HTTP Write digests use the algorithms listed in the
<spanx style="verb">supportedDigestAlgorithms</spanx> capability of <xref target="JMAP-BLOBEXT"/>, and
clients use the first one they support.</t>
  <t>The "xattr" namespace maps an attribute name directly to its
value: a String for UTF-8 text, or a <xref target="JMAP-METADATA"/> Binary
value.  Removed XattrValue and its "blobId", so attribute values
are ordinary metadata and the metadata quota, copy and access
rules apply to them.  Removed the <spanx style="verb">maxDepth</spanx> requirement, which
was wrong under <xref target="JMAP-METADATA"/>'s depth rules.</t>
  <t>Added security considerations for extended attributes that grant
privileges and for download markers.</t>
  <t>Direct HTTP Write returns 404 for a node that does not exist or
is not discoverable, and <spanx style="verb">mayModifyContent</spanx> for a File is its
parent's.  The <spanx style="verb">modified</spanx> definition notes that Direct HTTP Write
sets it.</t>
  <t>Direct HTTP Write PUT sets <spanx style="verb">mediaType</spanx> from the type and subtype
of Content-Type only, without parameters.</t>
  <t>The <spanx style="verb">text</spanx> query condition matches name and mediaType by
substring rather than as a glob.</t>
  <t>Added a children column to the "JMAP FileNode Types" registry,
and guidance for the Designated Expert of the "JMAP FileNode
Roles" registry.</t>
  <t><xref target="JMAP-BLOBEXT"/> and <xref target="JMAP-CONDITIONAL"/> now reference the
working group drafts.  <xref target="JMAP-MAIL"/>, <xref target="JMAP-QUOTAS"/> and
<xref target="UNICODE"/> are normative references.</t>
  <t>Removed the TODO section, and made editorial fixes throughout:
American spelling, error codes and section references written
consistently, heading case, and list formatting.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-18</strong></t>

<t><list style="symbols">
  <t><spanx style="verb">isSubscribed</spanx>, <spanx style="verb">myRights</spanx>, and <spanx style="verb">shareWith</spanx> are defined only for
nodes whose <spanx style="verb">@type</spanx> permits children.  Other nodes take their
rights from their parent, so a sharing change no longer marks
every descendant File as changed.</t>
  <t><spanx style="verb">shareWith</spanx> is the access control list on that node only;
<spanx style="verb">myRights</spanx> is the union of the lists on the node and its
ancestors, so a descendant cannot narrow inherited rights.</t>
  <t>A node with a <spanx style="verb">shareWith</spanx> entry for the user, or with such a
descendant, is discoverable.</t>
  <t>Defined which properties FileNode/get returns for a node that
is discoverable but not readable, and how FileNode/query
filters and sorts treat it; body never matches it.</t>
  <t>A destroy that would remove undiscoverable nodes fails with
"forbidden".</t>
  <t>onExists checks rights before comparing against the existing
node; "newest" and "unchanged" also require <spanx style="verb">mayRead</spanx>.</t>
  <t>FileNode/copy returns a <spanx style="verb">destroyed</spanx> list for nodes replaced
through onExists.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-17</strong></t>

<t><list style="symbols">
  <t>Setting a property with a default to null resets it to that
default (as in RFC 8620), for example <spanx style="verb">created</spanx> to the current
server time and <spanx style="verb">isSubscribed</spanx> to true.</t>
  <t>Setting <spanx style="verb">mediaType</spanx> to null now resets it to
"application/octet-stream" rather than being an error.
(Thanks to Mark Atwood.)</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-16</strong></t>

<t><list style="symbols">
  <t>A name collision with an undiscoverable node returns "forbidden"
without <spanx style="verb">existingId</spanx>; only onExists "rename" proceeds.  (Thanks to
Mehdi Kouhen.)</t>
  <t>onExists replacement requires <spanx style="verb">mayDelete</spanx> on the existing node.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-15</strong></t>

<t><list style="symbols">
  <t>Replaced <spanx style="verb">nodeType</spanx> with an <spanx style="verb">@type</spanx> property
(File, Directory, SymLink).  Each type defines only the
properties relevant to it; properties of other types are
omitted rather than null.  <spanx style="verb">@type</spanx> is now required on
creation instead of being inferred.</t>
  <t>Moved <spanx style="verb">blobId</spanx>, <spanx style="verb">size</spanx>, <spanx style="verb">type</spanx>, and <spanx style="verb">executable</spanx> to File,
<spanx style="verb">role</spanx> to Directory, and <spanx style="verb">target</spanx> to SymLink.</t>
  <t>Renamed the File <spanx style="verb">type</spanx> property to <spanx style="verb">mediaType</spanx>, with a default
of "application/octet-stream", so that it is not confused with
<spanx style="verb">@type</spanx>.  Renamed the <spanx style="verb">type</spanx> and <spanx style="verb">typeMatch</spanx> filters to
<spanx style="verb">mediaType</spanx> and <spanx style="verb">mediaTypeMatch</spanx>, and the <spanx style="verb">type</spanx> sort property
to <spanx style="verb">mediaType</spanx>.</t>
  <t>Added the <spanx style="verb">supportedNodeTypes</spanx> capability.</t>
  <t>Removed the <spanx style="verb">X-FileNode-Type</spanx> header field.  A Direct HTTP Write
PATCH no longer changes <spanx style="verb">mediaType</spanx>; clients use PUT or FileNode/set.</t>
  <t>Defined how SymLinks are archived (as symlink entries, never
followed) and extracted (created as SymLinks if supported).</t>
  <t>Added <spanx style="verb">onUnsupportedEntry</spanx> ("error", the default, or "skip") to the
archive and extract recipes, for entries the archive format or the
server cannot represent, and the "unsupportedEntry" SetError.</t>
  <t>Defined the order among nodes that lack a sort property.</t>
  <t>Breaking change: the node type values changed from "file",
"directory", and "symlink" to "File", "Directory", and "SymLink".
Clients <bcp14>MUST</bcp14> now provide <spanx style="verb">@type</spanx> on creation.</t>
  <t>FileNode/get always returns <spanx style="verb">@type</spanx>, and omits requested
properties that are not defined for a node's <spanx style="verb">@type</spanx>.</t>
  <t>Query filters on type-specific properties now match only nodes
of that type, for both true and false values.  For example,
<spanx style="verb">hasAnyRole: false</spanx> no longer matches Files or SymLinks, and
<spanx style="verb">isExecutable: false</spanx> no longer matches Directories or SymLinks.</t>
  <t>Added "unchanged" value for <spanx style="verb">onExists</spanx>, replacing a colliding node only
when a precondition on that node, supplied via "ifUnchangedBy"
(<xref target="JMAP-CONDITIONAL"/>), is satisfied.  The precondition binds to the current
id of the node that occupies the contested name, so a client can only
replace the one node it expected.</t>
  <t>Added Extended Attributes and Named Streams: file nodes carry POSIX xattrs,
macOS extended attributes, NTFS/SMB alternate data streams, and NFSv4 named
attributes via the JMAP Object Metadata extension (<xref target="JMAP-METADATA"/>),
defining the "xattr" namespace (attribute name to an XattrValue holding
either inline "data" or a "blobId" for large/binary values).  Registered
the "xattr" namespace with IANA.</t>
  <t>Escaped bracket characters in "String[]" type signatures.</t>
  <t>Editorial: applied a subset of ASD-STE100 Simplified Technical English —
removed "e.g."/"i.e.", split over-long sentences (notably <spanx style="verb">onExists</spanx>
"unchanged"), and reworded noun clusters and idioms.  No normative change.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-14</strong></t>

<t><list style="symbols">
  <t>Added "newest" value for <spanx style="verb">onExists</spanx>.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-13</strong></t>

<t><list style="symbols">
  <t>Reordered methods to get/changes/set/copy/query/queryChanges per
RFC 8620 convention.</t>
  <t>Promoted Direct HTTP Write to top-level section.</t>
  <t>Moved Access Control before Quotas and integrations.</t>
  <t>Added caseInsensitiveNames capability and compareCaseInsensitively
parameter on FileNode/set.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-12</strong></t>

<t><list style="symbols">
  <t>Added symlink support: nodeType property (file, directory,
symlink) with IANA registry, and target property (array of
path elements).</t>
  <t>Replaced isFile/isDirectory query filters and sort with
nodeType.</t>
  <t>Expanded myRights: replaced mayWrite with mayAddChildren,
mayRename, mayDelete, mayModifyContent.</t>
  <t>Added forbiddenNameChars and forbiddenNodeNames capabilities;
removed hardcoded name restrictions from spec.</t>
  <t>Added changed (server-set) timestamp.</t>
  <t>Added Implementation Considerations section with guidance on
timestamps, access times, and filename restrictions.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-11</strong></t>

<t><list style="symbols">
  <t>Updated for blobext recipe renames (ExtractRecipe).</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-10</strong></t>

<t><list style="symbols">
  <t>Added ExtractRecipe parentNodeId extension for extracting
archives directly into FileNode trees.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-09</strong></t>

<t><list style="symbols">
  <t>Renamed hasType filter to isFile and isDirectory (separate filters).</t>
  <t>Renamed hasRole filter to role for consistency.</t>
  <t>Defined glob matching syntax for nameMatch/typeMatch.</t>
  <t>Added fetchParents argument to FileNode/get.</t>
  <t>Added descendantId filter to FileNode/query.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-08</strong></t>

<t><list style="symbols">
  <t>Removed immutability restriction on blobId, size, and type — nodes
can now have their content updated via FileNode/set.</t>
  <t>Added webWriteUrlTemplate capability for direct HTTP PUT/PATCH
writes to file nodes.</t>
  <t>Added documents, downloads, music, pictures, and videos roles.</t>
  <t>Added Quotas section referencing RFC 9425.</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-07</strong></t>

<t><list style="symbols">
  <t>added webTrashUrl and webUrlTemplate to the capabilities object</t>
  <t>added capability example JSON</t>
  <t>added explicit Errors sections to FileNode/set and FileNode/copy</t>
  <t>fixed typos and spelling errors</t>
  <t>added BCP 14 boilerplate</t>
  <t>fleshed out Security Considerations</t>
  <t>replaced role TODO with IANA registry</t>
  <t>documented webUrlTemplate variables</t>
  <t>clarified modified/accessed semantics: client-managed with null
to reset to server time</t>
  <t>clarified blobId constraints and blob lifetime</t>
  <t>documented myRights inheritance and FileNode/changes behaviour
when shareWith changes</t>
  <t>wrapped long lines throughout</t>
  <t>added Integration with JMAP Blob Extensions section
(ArchiveEntry extension with nodeId and recurse)</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-06</strong></t>

<t><list style="symbols">
  <t>Documented FileNode/copy and detailed that it has the same new top-level keys</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-05</strong></t>

<t><list style="symbols">
  <t>Renamed onDuplicate to onExists for name alignment</t>
  <t>added "role" for directories</t>
  <t>added a "TODO" for putting more restrictions on node names</t>
  <t>changed hasParentId to isTopLevel with reversed boolean meaning</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-04</strong></t>

<t><list style="symbols">
  <t>Documented that blobId, size, and type are immutable after creation.</t>
  <t>Documented that creating a file and deleting the old copy of the file within a transaction is legal.</t>
  <t>Added onDuplicate top-level option for FileNode/set, giving both "rename" and "replace" options.</t>
  <t>Updated the definition of shareWith to say that the keys of the hash are Ids, not arbitrary strings</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-03</strong></t>

<t><list style="symbols">
  <t>Added 'text' and 'body' searches (added JMAP-MAIL reference as additional information for body search)</t>
  <t>Updated JMAP-CONTACTS and JMAP-SHARING references to published RFC numbers rather than draft names</t>
  <t>Noted that the server <bcp14>MUST</bcp14> included the nodeids of deleted child nodes.</t>
  <t>Added isSubscribed</t>
  <t>Renamed mayAdmin to mayShare to align with other specs</t>
  <t>Described the inheritance of ACLs</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-02</strong></t>

<t><list style="symbols">
  <t>Convert to Kramdown-RFC format (no intentional changes)</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-01</strong></t>

<t><list style="symbols">
  <t>Refreshing draft only</t>
</list></t>

<t><strong>draft-ietf-jmap-filenode-00</strong></t>

<t><list style="symbols">
  <t>upload as a working group document</t>
</list></t>

<t><strong>draft-gondwana-jmap-filenode-01</strong></t>

<t><list style="symbols">
  <t>require a blobId for the zero-byte file</t>
  <t>make size also null for collections</t>
  <t>add more to the TODO section</t>
  <t>bikeshed; FileNode</t>
  <t>correct UTCDate, UnsignedInt, and normalised UTF-8.</t>
  <t>add some fields to the capabilities object</t>
</list></t>

<t><strong>draft-gondwana-jmap-filenode-00</strong></t>

<t><list style="symbols">
  <t>initial proposal</t>
</list></t>

</section>
<section anchor="acknowledgements"><name>Acknowledgements</name>

<t>Mark Atwood, Ben Bucksch, Mauro De Gennaro, Seph Gentle, Arnt Gulbradson, Neil Jenkins, Mehdi Kouhen, Ricardo Signes, and members of the JMAP Working Group at IETF.</t>

</section>


  </middle>

  <back>


<references title='References' anchor="sec-combined-references">

    <references title='Normative References' anchor="sec-normative-references">



<reference anchor="JMAP-CORE">
  <front>
    <title>The JSON Meta Application Protocol (JMAP)</title>
    <author fullname="N. Jenkins" initials="N." surname="Jenkins"/>
    <author fullname="C. Newman" initials="C." surname="Newman"/>
    <date month="July" year="2019"/>
    <abstract>
      <t>This document specifies a protocol for clients to efficiently query, fetch, and modify JSON-based data objects, with support for push notification of changes and fast resynchronisation and for out-of- band binary data upload/download.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8620"/>
  <seriesInfo name="DOI" value="10.17487/RFC8620"/>
</reference>

<reference anchor="JMAP-SHARING">
  <front>
    <title>JSON Meta Application Protocol (JMAP) Sharing</title>
    <author fullname="N. Jenkins" initials="N." role="editor" surname="Jenkins"/>
    <date month="November" year="2024"/>
    <abstract>
      <t>This document specifies a data model for sharing data between users using the JSON Meta Application Protocol (JMAP). Future documents can reference this document when defining data types to support a consistent model of sharing.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9670"/>
  <seriesInfo name="DOI" value="10.17487/RFC9670"/>
</reference>

<reference anchor="MEDIA-TYPES">
  <front>
    <title>Media Type Specifications and Registration Procedures</title>
    <author fullname="N. Freed" initials="N." surname="Freed"/>
    <author fullname="J. Klensin" initials="J." surname="Klensin"/>
    <author fullname="T. Hansen" initials="T." surname="Hansen"/>
    <date month="January" year="2013"/>
    <abstract>
      <t>This document defines procedures for the specification and registration of media types for use in HTTP, MIME, and other Internet protocols. This memo documents an Internet Best Current Practice.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="13"/>
  <seriesInfo name="RFC" value="6838"/>
  <seriesInfo name="DOI" value="10.17487/RFC6838"/>
</reference>

<reference anchor="URI-TEMPLATE">
  <front>
    <title>URI Template</title>
    <author fullname="J. Gregorio" initials="J." surname="Gregorio"/>
    <author fullname="R. Fielding" initials="R." surname="Fielding"/>
    <author fullname="M. Hadley" initials="M." surname="Hadley"/>
    <author fullname="M. Nottingham" initials="M." surname="Nottingham"/>
    <author fullname="D. Orchard" initials="D." surname="Orchard"/>
    <date month="March" year="2012"/>
    <abstract>
      <t>A URI Template is a compact sequence of characters for describing a range of Uniform Resource Identifiers through variable expansion. This specification defines the URI Template syntax and the process for expanding a URI Template into a URI reference, along with guidelines for the use of URI Templates on the Internet. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6570"/>
  <seriesInfo name="DOI" value="10.17487/RFC6570"/>
</reference>

<reference anchor="IANA-GUIDELINES">
  <front>
    <title>Guidelines for Writing an IANA Considerations Section in RFCs</title>
    <author fullname="M. Cotton" initials="M." surname="Cotton"/>
    <author fullname="B. Leiba" initials="B." surname="Leiba"/>
    <author fullname="T. Narten" initials="T." surname="Narten"/>
    <date month="June" year="2017"/>
    <abstract>
      <t>Many protocols make use of points of extensibility that use constants to identify various protocol parameters. To ensure that the values in these fields do not have conflicting uses and to promote interoperability, their allocations are often coordinated by a central record keeper. For IETF protocols, that role is filled by the Internet Assigned Numbers Authority (IANA).</t>
      <t>To make assignments in a given registry prudently, guidance describing the conditions under which new values should be assigned, as well as when and how modifications to existing values can be made, is needed. This document defines a framework for the documentation of these guidelines by specification authors, in order to assure that the provided guidance for the IANA Considerations is clear and addresses the various issues that are likely in the operation of a registry.</t>
      <t>This is the third edition of this document; it obsoletes RFC 5226.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="26"/>
  <seriesInfo name="RFC" value="8126"/>
  <seriesInfo name="DOI" value="10.17487/RFC8126"/>
</reference>


<reference anchor="JMAP-BLOBEXT">
   <front>
      <title>JMAP Blob Management</title>
      <author fullname="Bron Gondwana" initials="B." surname="Gondwana">
         <organization>Fastmail</organization>
      </author>
      <date day="2" month="November" year="2026"/>
      <abstract>
	 <t>   The JSON Meta Application Protocol (JMAP) base protocol ([JMAP-CORE])
   provides the ability to upload and download arbitrary binary data via
   HTTP POST and GET on a defined endpoint.  This binary data is called
   a &quot;blob&quot;.

   This extension adds additional ways to create and access blobs by
   making inline method calls within a standard JMAP request.  It also
   adds a reverse lookup mechanism to discover where blobs are
   referenced within other data types, support for large blobs via
   chunked construction with server-side optimisation, and server-side
   blob conversion operations including image format conversion, archive
   creation and extraction, compression and decompression, and delta/
   patch operations.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-jmap-blobext-03"/>
   
</reference>


<reference anchor="JMAP-METADATA">
   <front>
      <title>JMAP Object Metadata</title>
      <author fullname="Mauro De Gennaro" initials="M." surname="De Gennaro">
         <organization>Stalwart Labs LLC</organization>
      </author>
      <date day="28" month="October" year="2026"/>
      <abstract>
	 <t>   This document defines an extension to the JSON Meta Application
   Protocol (JMAP) that lets clients and servers attach metadata to
   objects of existing JMAP data types.  Each data type the server lists
   gains two new properties, metadata and privateMetadata, whose values
   are objects keyed by _namespace identifier_. A namespace identifier
   is either a name registered with IANA or a domain name controlled by
   the vendor providing the namespace; the latter allows vendors and
   applications to extend the metadata schema without prior
   coordination.  Because metadata is carried as a property on the
   related object, clients use the existing /get, /set, /changes, and
   /query methods to read, modify, and synchronize it.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-jmap-metadata-05"/>
   
</reference>

<reference anchor="JMAP-MAIL">
  <front>
    <title>The JSON Meta Application Protocol (JMAP) for Mail</title>
    <author fullname="N. Jenkins" initials="N." surname="Jenkins"/>
    <author fullname="C. Newman" initials="C." surname="Newman"/>
    <date month="August" year="2019"/>
    <abstract>
      <t>This document specifies a data model for synchronising email data with a server using the JSON Meta Application Protocol (JMAP). Clients can use this to efficiently search, access, organise, and send messages, and to get push notifications for fast resynchronisation when new messages are delivered or a change is made in another client.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8621"/>
  <seriesInfo name="DOI" value="10.17487/RFC8621"/>
</reference>

<reference anchor="JMAP-QUOTAS">
  <front>
    <title>JSON Meta Application Protocol (JMAP) for Quotas</title>
    <author fullname="R. Cordier" initials="R." role="editor" surname="Cordier"/>
    <date month="June" year="2023"/>
    <abstract>
      <t>This document specifies a data model for handling quotas on accounts with a server using the JSON Meta Application Protocol (JMAP).</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9425"/>
  <seriesInfo name="DOI" value="10.17487/RFC9425"/>
</reference>

<reference anchor="DIGEST-FIELDS">
  <front>
    <title>Digest Fields</title>
    <author fullname="R. Polli" initials="R." surname="Polli"/>
    <author fullname="L. Pardue" initials="L." surname="Pardue"/>
    <date month="February" year="2024"/>
    <abstract>
      <t>This document defines HTTP fields that support integrity digests. The Content-Digest field can be used for the integrity of HTTP message content. The Repr-Digest field can be used for the integrity of HTTP representations. Want-Content-Digest and Want-Repr-Digest can be used to indicate a sender's interest and preferences for receiving the respective Integrity fields.</t>
      <t>This document obsoletes RFC 3230 and the Digest and Want-Digest HTTP fields.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9530"/>
  <seriesInfo name="DOI" value="10.17487/RFC9530"/>
</reference>

<reference anchor="HTTP">
  <front>
    <title>HTTP Semantics</title>
    <author fullname="R. Fielding" initials="R." role="editor" surname="Fielding"/>
    <author fullname="M. Nottingham" initials="M." role="editor" surname="Nottingham"/>
    <author fullname="J. Reschke" initials="J." role="editor" surname="Reschke"/>
    <date month="June" year="2022"/>
    <abstract>
      <t>The Hypertext Transfer Protocol (HTTP) is a stateless application-level protocol for distributed, collaborative, hypertext information systems. This document describes the overall architecture of HTTP, establishes common terminology, and defines aspects of the protocol that are shared by all versions. In this definition are core protocol elements, extensibility mechanisms, and the "http" and "https" Uniform Resource Identifier (URI) schemes.</t>
      <t>This document updates RFC 3864 and obsoletes RFCs 2818, 7231, 7232, 7233, 7235, 7538, 7615, 7694, and portions of 7230.</t>
    </abstract>
  </front>
  <seriesInfo name="STD" value="97"/>
  <seriesInfo name="RFC" value="9110"/>
  <seriesInfo name="DOI" value="10.17487/RFC9110"/>
</reference>

<reference anchor="HTTP-PATCH">
  <front>
    <title>PATCH Method for HTTP</title>
    <author fullname="L. Dusseault" initials="L." surname="Dusseault"/>
    <author fullname="J. Snell" initials="J." surname="Snell"/>
    <date month="March" year="2010"/>
    <abstract>
      <t>Several applications extending the Hypertext Transfer Protocol (HTTP) require a feature to do partial resource modification. The existing HTTP PUT method only allows a complete replacement of a document. This proposal adds a new HTTP method, PATCH, to modify an existing HTTP resource. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="5789"/>
  <seriesInfo name="DOI" value="10.17487/RFC5789"/>
</reference>

<reference anchor="UNICODE">
  <front>
    <title>Unicode Format for Network Interchange</title>
    <author fullname="J. Klensin" initials="J." surname="Klensin"/>
    <author fullname="M. Padlipsky" initials="M." surname="Padlipsky"/>
    <date month="March" year="2008"/>
    <abstract>
      <t>The Internet today is in need of a standardized form for the transmission of internationalized "text" information, paralleling the specifications for the use of ASCII that date from the early days of the ARPANET. This document specifies that format, using UTF-8 with normalization and specific line-ending sequences. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="5198"/>
  <seriesInfo name="DOI" value="10.17487/RFC5198"/>
</reference>


<reference anchor="UNICODE-STD" target="https://www.unicode.org/versions/latest/">
  <front>
    <title>The Unicode Standard</title>
    <author >
      <organization>The Unicode Consortium</organization>
    </author>
    <date year="n.d."/>
  </front>
</reference>
<reference anchor="UAX15" target="https://www.unicode.org/reports/tr15/">
  <front>
    <title>Unicode Standard Annex #15: Unicode Normalization Forms</title>
    <author >
      <organization>The Unicode Consortium</organization>
    </author>
    <date year="n.d."/>
  </front>
</reference>


<reference anchor="WEBDAV">
  <front>
    <title>HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)</title>
    <author fullname="L. Dusseault" initials="L." role="editor" surname="Dusseault"/>
    <date month="June" year="2007"/>
    <abstract>
      <t>Web Distributed Authoring and Versioning (WebDAV) consists of a set of methods, headers, and content-types ancillary to HTTP/1.1 for the management of resource properties, creation and management of resource collections, URL namespace manipulation, and resource locking (collision avoidance).</t>
      <t>RFC 2518 was published in February 1999, and this specification obsoletes RFC 2518 with minor revisions mostly due to interoperability experience. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="4918"/>
  <seriesInfo name="DOI" value="10.17487/RFC4918"/>
</reference>

<reference anchor="RFC2119">
  <front>
    <title>Key words for use in RFCs to Indicate Requirement Levels</title>
    <author fullname="S. Bradner" initials="S." surname="Bradner"/>
    <date month="March" year="1997"/>
    <abstract>
      <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="2119"/>
  <seriesInfo name="DOI" value="10.17487/RFC2119"/>
</reference>

<reference anchor="RFC8174">
  <front>
    <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
    <author fullname="B. Leiba" initials="B." surname="Leiba"/>
    <date month="May" year="2017"/>
    <abstract>
      <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="8174"/>
  <seriesInfo name="DOI" value="10.17487/RFC8174"/>
</reference>




    </references>

    <references title='Informative References' anchor="sec-informative-references">



<reference anchor="CALDAV">
  <front>
    <title>Calendaring Extensions to WebDAV (CalDAV)</title>
    <author fullname="C. Daboo" initials="C." surname="Daboo"/>
    <author fullname="B. Desruisseaux" initials="B." surname="Desruisseaux"/>
    <author fullname="L. Dusseault" initials="L." surname="Dusseault"/>
    <date month="March" year="2007"/>
    <abstract>
      <t>This document defines extensions to the Web Distributed Authoring and Versioning (WebDAV) protocol to specify a standard way of accessing, managing, and sharing calendaring and scheduling information based on the iCalendar format. This document defines the "calendar-access" feature of CalDAV. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="4791"/>
  <seriesInfo name="DOI" value="10.17487/RFC4791"/>
</reference>

<reference anchor="CARDDAV">
  <front>
    <title>CardDAV: vCard Extensions to Web Distributed Authoring and Versioning (WebDAV)</title>
    <author fullname="C. Daboo" initials="C." surname="Daboo"/>
    <date month="August" year="2011"/>
    <abstract>
      <t>This document defines extensions to the Web Distributed Authoring and Versioning (WebDAV) protocol to specify a standard way of accessing, managing, and sharing contact information based on the vCard format. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6352"/>
  <seriesInfo name="DOI" value="10.17487/RFC6352"/>
</reference>


<reference anchor="JMAP-CALENDARS">
   <front>
      <title>JSON Meta Application Protocol (JMAP) for Calendars</title>
      <author fullname="Neil Jenkins" initials="N." surname="Jenkins">
         <organization>Fastmail</organization>
      </author>
      <author fullname="Michael Douglass" initials="M." surname="Douglass">
         <organization>Spherical Cow Group</organization>
      </author>
      <date day="15" month="November" year="2026"/>
      <abstract>
	 <t>   This document specifies a data model for synchronizing calendar data
   with a server using JMAP.  Clients can use this to efficiently read,
   write, and share calendars and events, receive push notifications for
   changes or event reminders, and keep track of changes made by others
   in a multi-user environment.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-jmap-calendars-34"/>
   
</reference>


<reference anchor="JMAP-CONDITIONAL">
   <front>
      <title>JMAP Conditional Set</title>
      <author fullname="Bron Gondwana" initials="B." surname="Gondwana">
         <organization>Fastmail</organization>
      </author>
      <date day="26" month="October" year="2026"/>
      <abstract>
	 <t>   The JMAP base protocol ([JMAP-CORE]) provides the Foo/set method for
   creating, updating, and destroying objects.  It offers a single
   concurrency control, the &quot;ifInState&quot; argument, which guards an entire
   object type: if any object of that type has changed, the whole method
   is rejected.

   This extension adds a finer, per-object conditional mechanism.  A
   client may require that an individual update or destroy proceed only
   if the target object still matches a set of expected property values,
   expressed using the JMAP PatchObject already defined for updates.
   This provides optimistic concurrency control scoped to a single
   object — the equivalent of an HTTP &quot;If-Match&quot; precondition — for any
   JMAP data type.

   This extension also defines an optional &quot;atomic&quot; argument that
   applies an entire Foo/set as a single unit: either every change it
   requests takes effect, or none does.  Combined with the per-object
   precondition, this lets a client express a multi-object change that
   is safe only when applied together — such as an atomic rename that
   exchanges two names.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-jmap-conditional-02"/>
   
</reference>

<reference anchor="JMAP-CONTACTS">
  <front>
    <title>JSON Meta Application Protocol (JMAP) for Contacts</title>
    <author fullname="N. Jenkins" initials="N." role="editor" surname="Jenkins"/>
    <date month="December" year="2024"/>
    <abstract>
      <t>This document specifies a data model for synchronising contact data with a server using the JSON Meta Application Protocol (JMAP).</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9610"/>
  <seriesInfo name="DOI" value="10.17487/RFC9610"/>
</reference>




    </references>

</references>



  </back>

<!-- ##markdown-source:
H4sIAAAAAAAAA7S963bb2JUw+B9PgWF+WPJHyZLLrlRJ/XWaluSUun2LJaeS
Tmo1QRKSkCIBBgAtqy5Z8xDzAPMs8yjzJLPvZx8AlFyVTK2sWCSBc9lnn32/
7O3tJW3RLvOj9D9fT96lL4tlnl60VZ1d52n+qc3LpqjKJJvN6vyje+ZNtciT
RTUvsxW8uqizq3avyNurvb+tsvXeFTxRwhN7Tw+TZjNbFQ2Ocnm3hmfPzy5f
JvOsza+r+u4obdpFslkv4HNzlH715dODpJo11TLHz0mxro/Stt407dODg68P
nibf53e3Vb2AUco2r8u83TvFqZOmzcrF/2TLqoQZ7vImWRdH6V/aaj5Om6pu
6/yqgb/uVvjHd0mSbdqbqj5K0r0khf+KEuZ+sZ/+vioXt1mZ0Ze8sxd1Vcbf
V/X1Ufoya9pVVizpmxz/Okpn8Oj1f1zJL22erfbn1SpJyqpeZW3xMT+ipxGE
eydv358dpe9fntCO7euLbybvz9/8nn75+svf8i+vz07PJ3uXf353dkE/fPnV
F1/RDx/en+9dnr1+92pyyYN9+VxeOZ+8mez9/sP56dmr8zfy2leHT78MM714
9fbF2Z8uAZB7p/vh4GbLaganHp57fXY5OZ1cTroPrvI2g0PL3JOT81e6pcPw
9R8+vL2c8Aq+fvb0Of1wev77s4vLvZfnZ69O5afnX/DKv7m8fMffHB6Gb/be
TS5PvqHvn//2q69592/OT96e8safH379lf9y7+LylKGN/7VZfZ23R+lN266b
oydPbm9v9zdlMQcE3YfTfPIxrxE9mydLxML2SXiRL8blTZ5+4OfhagCiZfXC
njFUsv/2GEX8WycwOqBhsVnxKid/Onz++eur8zW83Dxp68PnvcWNuitLJ2WZ
f0p/AzPY/G8QBZfFD4CGgM4v4VMz+qd28O3Zi9PJHwn2z74+/CpJivIqRvOT
ySt74rdfH8p370/1yy+/eP7U3YfJq7M3p5P3F108m2dASWBbjb87b07PL8/f
vpm86j0NF7XAPWbL6PnLycmlINqXgFbJ3t5ems2ats7mbZLgPomwzbImT9d1
BXSjWqY78DhRpF387mOxyJu0hUezWbEs2ru0rdLNelllixQAny6q2xI/JFk9
K2Dg+i6dFSX+g9dkPwVoFo3/KoWPsLtlDu+nI7x4ozGNNM/KdJanmyZfAFhT
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
xH4Z6LUk9C7qf1f8L3cS2nGNeQEayRkwSHIBAA==

-->

</rfc>

