at.inlay.component

inlay.at

Documentation

Component record. The rkey is the type NSID this component implements.

main record

Component record. The rkey is the type NSID this component implements.

Record Key nsid

Properties

body union Optional

How this component is rendered. Omit for primitives rendered by the host.

Known types:
createdAt string datetime Optional

An RFC 3339 formatted timestamp.

description string Optional

No description available.

maxLength: 10000 bytesmaxGraphemes: 1000 graphemes
imports array of string did Optional

Ordered list of DIDs (import stack). For each NSID, the first DID that has a component with that rkey wins.

updatedAt string datetime Optional

Last update timestamp. Set by the publish flow to bust cached responses.

view ref #view Optional

What data this component views and which prop receives it

View raw schema 
{
  "key": "nsid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [],
    "properties": {
      "via": {
        "refs": [
          "at.inlay.defs#viaValtown"
        ],
        "type": "union",
        "description": "Platform-managed deployment metadata"
      },
      "body": {
        "refs": [
          "#bodyExternal",
          "#bodyTemplate"
        ],
        "type": "union",
        "description": "How this component is rendered. Omit for primitives rendered by the host."
      },
      "view": {
        "ref": "#view",
        "type": "ref",
        "description": "What data this component views and which prop receives it"
      },
      "imports": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "did"
        },
        "description": "Ordered list of DIDs (import stack). For each NSID, the first DID that has a component with that rkey wins."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "updatedAt": {
        "type": "string",
        "format": "datetime",
        "description": "Last update timestamp. Set by the publish flow to bust cached responses."
      },
      "description": {
        "type": "string",
        "maxLength": 10000,
        "maxGraphemes": 1000
      }
    }
  },
  "description": "Component record. The rkey is the type NSID this component implements."
}
bodyExternal object

Component rendered by calling a remote XRPC endpoint

Properties

did string did Required

DID of the service hosting this component

personalized boolean Optional

When true, host sends a signed JWT identifying the viewer with each call.

View raw schema 
{
  "type": "object",
  "required": [
    "did"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "DID of the service hosting this component"
    },
    "personalized": {
      "type": "boolean",
      "description": "When true, host sends a signed JWT identifying the viewer with each call."
    }
  },
  "description": "Component rendered by calling a remote XRPC endpoint"
}
bodyTemplate object

Component rendered by the host from a serialized element tree

Properties

node unknown Required

Serialized element tree with bindings

View raw schema 
{
  "type": "object",
  "required": [
    "node"
  ],
  "properties": {
    "node": {
      "type": "unknown",
      "description": "Serialized element tree with bindings"
    }
  },
  "description": "Component rendered by the host from a serialized element tree"
}
view object

Declares what data this component views and which prop receives it.

Properties

prop string Required

Which component prop receives the view data.

maxLength: 256 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "prop",
    "accepts"
  ],
  "properties": {
    "prop": {
      "type": "string",
      "maxLength": 256,
      "description": "Which component prop receives the view data."
    },
    "accepts": {
      "type": "array",
      "items": {
        "refs": [
          "#viewRecord",
          "#viewPrimitive"
        ],
        "type": "union"
      },
      "minLength": 1,
      "description": "Data types this view accepts."
    }
  },
  "description": "Declares what data this component views and which prop receives it."
}
viewPrimitive object

View accepts a primitive value type.

Properties

format string Optional

String format constraint. Only applies when type is 'string'.

maxLength: 64 bytes
Known values: at-uri, did, datetime, uri, handle, at-identifier, nsid, cid, language, record-key, tid
type string Required

Lexicon primitive type.

maxLength: 128 bytes
Known values: string, integer, boolean, blob, cid-link, bytes
View raw schema 
{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "maxLength": 128,
      "description": "Lexicon primitive type.",
      "knownValues": [
        "string",
        "integer",
        "boolean",
        "blob",
        "cid-link",
        "bytes"
      ]
    },
    "format": {
      "type": "string",
      "maxLength": 64,
      "description": "String format constraint. Only applies when type is 'string'.",
      "knownValues": [
        "at-uri",
        "did",
        "datetime",
        "uri",
        "handle",
        "at-identifier",
        "nsid",
        "cid",
        "language",
        "record-key",
        "tid"
      ]
    }
  },
  "description": "View accepts a primitive value type."
}
viewRecord object

View accepts individual records of a collection. Omit collection for a generic record view. When rkey is present, the component accepts bare DIDs (expanded to full AT URIs) and appears on identity pages.

Properties

collection string nsid Optional

The collection this component views. Omit for any-collection.

rkey string Optional

The record key, baked from the collection's lexicon at authoring time. Presence enables DID expansion and identity page routing.

maxLength: 512 bytes
View raw schema 
{
  "type": "object",
  "properties": {
    "rkey": {
      "type": "string",
      "maxLength": 512,
      "description": "The record key, baked from the collection's lexicon at authoring time. Presence enables DID expansion and identity page routing."
    },
    "collection": {
      "type": "string",
      "format": "nsid",
      "description": "The collection this component views. Omit for any-collection."
    }
  },
  "description": "View accepts individual records of a collection. Omit collection for a generic record view. When rkey is present, the component accepts bare DIDs (expanded to full AT URIs) and appears on identity pages."
}

Lexicon Garden

@