@atmo-dev/kit 0.2.1 → 0.4.0

package/dist/social/profile.js

@@ -0,0 +1,78 @@
+import { tokenize } from '@atcute/bluesky-richtext-parser';
+import { safeWebUrl } from './richtext.js';
+import { socialHashtagUrl, socialProfileUrl } from './urls.js';
+/** Only web URLs; never accept executable schemes or disguised credentials. */
+export function safeProfileUrl(value) {
+    if (!value ||
+        Array.from(value).some((char) => char.charCodeAt(0) <= 0x20 || char.charCodeAt(0) === 0x7f))
+        return undefined;
+    const href = safeWebUrl(value);
+    if (!href)
+        return undefined;
+    const url = new URL(href);
+    return url.username || url.password ? undefined : href;
+}
+export function profileDescriptionSegments(text, options = {}) {
+    return Array.from(tokenize(text), (token) => ({
+        text: token.raw,
+        href: token.type === 'autolink'
+            ? safeProfileUrl(token.url)
+            : token.type === 'mention'
+                ? (options.mentionUrl?.(token.handle) ??
+                    socialProfileUrl(token.handle, options.socialClient))
+                : token.type === 'topic'
+                    ? socialHashtagUrl(token.name, options.socialClient)
+                    : undefined
+    }));
+}
+export function visibleProfileLinks(links = []) {
+    const seen = new Set();
+    const result = [];
+    for (const link of links) {
+        const url = safeProfileUrl(link.url);
+        if (!url || seen.has(url))
+            continue;
+        seen.add(url);
+        result.push({ url, title: link.title?.trim() || undefined, icon: safeProfileUrl(link.icon) });
+        if (result.length === 10)
+            break;
+    }
+    return result;
+}
+/** Validate public AppView data at the boundary, including newer optional fields. */
+export function blueskyProfileToProfileData(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const p = value;
+    if (typeof p.did !== 'string' || !p.did.startsWith('did:'))
+        return undefined;
+    const text = (key) => (typeof p[key] === 'string' ? p[key] : undefined);
+    const count = (key) => typeof p[key] === 'number' && Number.isSafeInteger(p[key]) && p[key] >= 0 ? p[key] : undefined;
+    const links = [];
+    for (const item of Array.isArray(p.links) ? p.links : []) {
+        if (!item || typeof item !== 'object' || typeof item.url !== 'string')
+            continue;
+        // Without viewer-specific moderation preferences, omit labeled links conservatively.
+        if (Array.isArray(item.labels) && item.labels.some((label) => !label?.neg))
+            continue;
+        links.push({
+            url: item.url,
+            title: typeof item.title === 'string' ? item.title : undefined,
+            icon: typeof item.icon === 'string' ? item.icon : undefined
+        });
+    }
+    return {
+        did: p.did,
+        handle: text('handle'),
+        displayName: text('displayName'),
+        avatar: safeProfileUrl(text('avatar')),
+        banner: safeProfileUrl(text('banner')),
+        description: text('description'),
+        pronouns: text('pronouns'),
+        links: visibleProfileLinks(links),
+        followersCount: count('followersCount'),
+        followsCount: count('followsCount'),
+        postsCount: count('postsCount'),
+        createdAt: text('createdAt')
+    };
+}

package/dist/social/urls.d.ts

@@ -1,2 +1,9 @@
+import { type PreferredSocialClient } from './preferred-client.js';
 /** Bluesky expects literal DIDs in its routes, including colons and did:web escapes. */
 export declare function blueskyProfileUrl(identifier: string): string;
+/** Supported clients share Bluesky's /profile/:actor route. */
+export declare function socialProfileUrl(identifier: string, client?: PreferredSocialClient | null): string;
+/** Open a hashtag in the viewer's preferred Bluesky-compatible client. */
+export declare function socialHashtagUrl(tag: string, client?: PreferredSocialClient | null): string;
+/** Open a feed-post AT URI in the viewer's preferred Bluesky-compatible client. */
+export declare function socialPostUrl(uri: string, client?: PreferredSocialClient | null): string | null;

package/dist/social/urls.js

@@ -1,6 +1,22 @@
-import { isDid } from '@atcute/lexicons/syntax';
+import { isActorIdentifier, isDid, isRecordKey } from '@atcute/lexicons/syntax';
+import { socialClientInfo } from './preferred-client.js';
 /** Bluesky expects literal DIDs in its routes, including colons and did:web escapes. */
 export function blueskyProfileUrl(identifier) {
+    return socialProfileUrl(identifier);
+}
+/** Supported clients share Bluesky's /profile/:actor route. */
+export function socialProfileUrl(identifier, client) {
     const actor = isDid(identifier) ? identifier : encodeURIComponent(identifier);
-    return `https://bsky.app/profile/${actor}`;
+    return `${socialClientInfo(client).url}/profile/${actor}`;
+}
+/** Open a hashtag in the viewer's preferred Bluesky-compatible client. */
+export function socialHashtagUrl(tag, client) {
+    return `${socialClientInfo(client).url}/hashtag/${encodeURIComponent(tag)}`;
+}
+/** Open a feed-post AT URI in the viewer's preferred Bluesky-compatible client. */
+export function socialPostUrl(uri, client) {
+    const match = /^at:\/\/([^/]+)\/app\.bsky\.feed\.post\/([^/]+)$/.exec(uri);
+    if (!match || !isActorIdentifier(match[1]) || !isRecordKey(match[2]))
+        return null;
+    return `${socialProfileUrl(match[1], client)}/post/${encodeURIComponent(match[2])}`;
 }

package/dist/social.d.ts

@@ -0,0 +1,5 @@
+export { PREFERRED_CLIENT_COLLECTION, PREFERRED_CLIENT_RKEY, PREFERRED_CLIENT_SCOPE, socialClients, normalizeSocialClientUrl, parsePreferredSocialClient, preferredSocialClientRecord, socialClientInfo } from './social/preferred-client.js';
+export type { SocialClientId, PreferredSocialClient } from './social/preferred-client.js';
+export { defaultExternalEmbedProviders, youtubeEmbedProvider, klipyEmbedProvider, resolveExternalEmbed } from './social/external-embeds.js';
+export type { ExternalPostEmbed, ExternalEmbedProvider, ExternalEmbedPlayer } from './social/external-embeds.js';
+export { blueskyProfileUrl, socialProfileUrl, socialPostUrl, socialHashtagUrl } from './social/urls.js';

package/dist/social.js

@@ -0,0 +1,3 @@
+export { PREFERRED_CLIENT_COLLECTION, PREFERRED_CLIENT_RKEY, PREFERRED_CLIENT_SCOPE, socialClients, normalizeSocialClientUrl, parsePreferredSocialClient, preferredSocialClientRecord, socialClientInfo } from './social/preferred-client.js';
+export { defaultExternalEmbedProviders, youtubeEmbedProvider, klipyEmbedProvider, resolveExternalEmbed } from './social/external-embeds.js';
+export { blueskyProfileUrl, socialProfileUrl, socialPostUrl, socialHashtagUrl } from './social/urls.js';

package/dist/streamplace.d.ts

@@ -0,0 +1,6 @@
+export { parseStreamplaceLink } from './grain/urls.js';
+export type StreamplaceLink = {
+    actor: string;
+    url: string;
+};
+export type StreamplaceSelection = (stream: StreamplaceLink) => void | string | Promise<void | string>;

package/dist/streamplace.js

@@ -0,0 +1 @@
+export { parseStreamplaceLink } from './grain/urls.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atmo-dev/kit",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "The shared UI foundation for Atmo apps.",
   "license": "MIT",
   "repository": {
@@ -27,6 +27,23 @@
       "svelte": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./grain": {
+      "types": "./dist/grain.d.ts",
+      "default": "./dist/grain.js"
+    },
+    "./streamplace": {
+      "types": "./dist/streamplace.d.ts",
+      "default": "./dist/streamplace.js"
+    },
+    "./media": {
+      "types": "./dist/media.d.ts",
+      "default": "./dist/media.js"
+    },
+    "./social": {
+      "types": "./dist/social.d.ts",
+      "default": "./dist/social.js"
+    },
+    "./lexicons/social.atmo.actor.preferredClient.json": "./dist/lexicons/social.atmo.actor.preferredClient.json",
     "./legal": {
       "types": "./dist/legal.d.ts",
       "default": "./dist/legal.js"