···32323333// EmbedExternal_External is a "external" in the app.bsky.embed.external schema.
3434type EmbedExternal_External struct {
3535- // associatedRefs: StrongRefs (uri+cid) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs.
3535+ // associatedRefs: StrongRefs (uri+cid) of the Atmosphere records that backed this view.
3636 AssociatedRefs []*comatproto.RepoStrongRef `json:"associatedRefs,omitempty" cborgen:"associatedRefs,omitempty"`
3737 Description string `json:"description" cborgen:"description"`
3838 Thumb *lexutil.LexBlob `json:"thumb,omitempty" cborgen:"thumb,omitempty"`
···48484949// EmbedExternal_ViewExternal is a "viewExternal" in the app.bsky.embed.external schema.
5050type EmbedExternal_ViewExternal struct {
5151- // associatedRefs: StrongRefs (uri+cid) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs.
5151+ // associatedRefs: StrongRefs (uri+cid) of the Atmosphere records that backed this view.
5252 AssociatedRefs []*comatproto.RepoStrongRef `json:"associatedRefs,omitempty" cborgen:"associatedRefs,omitempty"`
5353 // createdAt: When the external content was created, if available. Example: a publication date, for an article.
5454 CreatedAt *string `json:"createdAt,omitempty" cborgen:"createdAt,omitempty"`
···7171 Description *string `json:"description,omitempty" cborgen:"description,omitempty"`
7272 // icon: Fully-qualified URL where an icon representing the source can be fetched. For example, CDN location provided by the App View.
7373 Icon *string `json:"icon,omitempty" cborgen:"icon,omitempty"`
7474- Name *string `json:"name,omitempty" cborgen:"name,omitempty"`
7574 Theme *EmbedExternal_ViewExternalSourceTheme `json:"theme,omitempty" cborgen:"theme,omitempty"`
7676- Uri *string `json:"uri,omitempty" cborgen:"uri,omitempty"`
7575+ Title *string `json:"title,omitempty" cborgen:"title,omitempty"`
7676+ // uri: URI of the source, if available. Example: the https:// URL of a site.standard.publication record.
7777+ Uri *string `json:"uri,omitempty" cborgen:"uri,omitempty"`
7778}
78797980// EmbedExternal_ViewExternalSourceTheme is a "viewExternalSourceTheme" in the app.bsky.embed.external schema.
···1414// EmbedGetEmbedExternalView_Output is the output of a app.bsky.embed.getEmbedExternalView call.
1515type EmbedGetEmbedExternalView_Output struct {
1616 AssociatedRecords []*lexutil.LexiconTypeDecoder `json:"associatedRecords,omitempty" cborgen:"associatedRecords,omitempty"`
1717- // associatedRefs: StrongRefs (uri+cid) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs.
1717+ // associatedRefs: StrongRefs (URI+CID) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs.
1818 AssociatedRefs []*comatproto.RepoStrongRef `json:"associatedRefs,omitempty" cborgen:"associatedRefs,omitempty"`
1919 View *EmbedExternal_View `json:"view,omitempty" cborgen:"view,omitempty"`
2020}
···2222// EmbedGetEmbedExternalView calls the XRPC method "app.bsky.embed.getEmbedExternalView".
2323//
2424// uris: AT-URIs of any Atmosphere records that can be resolved and used to construct #externalView views. Example: a site.standard.document and optionally its associated site.standard.publication.
2525-// url: The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`.
2525+// url: The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`. May be used for validation in the future.
2626func EmbedGetEmbedExternalView(ctx context.Context, c lexutil.LexClient, uris []string, url string) (*EmbedGetEmbedExternalView_Output, error) {
2727 var out EmbedGetEmbedExternalView_Output
2828
···3131 "type": "ref",
3232 "ref": "com.atproto.repo.strongRef"
3333 },
3434- "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs."
3434+ "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view."
3535 }
3636 }
3737 },
···7878 "type": "ref",
7979 "ref": "com.atproto.repo.strongRef"
8080 },
8181- "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs."
8181+ "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view."
8282 }
8383 }
8484 },
···8686 "type": "object",
8787 "description": "The source of an external embed, such as a standard.site publication.",
8888 "properties": {
8989- "uri": { "type": "string", "format": "uri" },
8989+ "uri": {
9090+ "type": "string",
9191+ "format": "uri",
9292+ "description": "URI of the source, if available. Example: the https:// URL of a site.standard.publication record."
9393+ },
9094 "icon": {
9195 "type": "string",
9296 "format": "uri",
9397 "description": "Fully-qualified URL where an icon representing the source can be fetched. For example, CDN location provided by the App View."
9498 },
9595- "name": { "type": "string" },
9999+ "title": { "type": "string" },
96100 "description": { "type": "string" },
97101 "theme": {
98102 "type": "ref",
···44 "defs": {
55 "main": {
66 "type": "query",
77- "description": "Resolve one or more site.standard.* AT-URIs into the data needed to render an enhanced external embed. Returns `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`; `view` is also included when the resolved records can produce a renderable view, but may be omitted when no records were hydratable.",
77+ "description": "Resolve one or more AT-URIs into the data needed to render an enhanced external embed. Returns `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`; `view` is also included when the resolved records can produce a renderable view, but may be omitted when no records were hydratable.",
88 "parameters": {
99 "type": "params",
1010 "required": ["url", "uris"],
···1212 "url": {
1313 "type": "string",
1414 "format": "uri",
1515- "description": "The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`."
1515+ "description": "The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`. May be used for validation in the future."
1616 },
1717 "uris": {
1818 "type": "array",
···3737 "type": "ref",
3838 "ref": "com.atproto.repo.strongRef"
3939 },
4040- "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs."
4040+ "description": "StrongRefs (URI+CID) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs."
4141 },
4242 "associatedRecords": {
4343 "type": "array",