@atproto/api 0.11.2 → 0.12.1

package/dist/rich-text/detection.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFacets = void 0;
+const tlds_1 = __importDefault(require("tlds"));
+const util_1 = require("./util");
+function detectFacets(text) {
+    let match;
+    const facets = [];
+    {
+        // mentions
+        const re = util_1.MENTION_REGEX;
+        while ((match = re.exec(text.utf16))) {
+            if (!isValidDomain(match[3]) && !match[3].endsWith('.test')) {
+                continue; // probably not a handle
+            }
+            const start = text.utf16.indexOf(match[3], match.index) - 1;
+            facets.push({
+                $type: 'app.bsky.richtext.facet',
+                index: {
+                    byteStart: text.utf16IndexToUtf8Index(start),
+                    byteEnd: text.utf16IndexToUtf8Index(start + match[3].length + 1),
+                },
+                features: [
+                    {
+                        $type: 'app.bsky.richtext.facet#mention',
+                        did: match[3], // must be resolved afterwards
+                    },
+                ],
+            });
+        }
+    }
+    {
+        // links
+        const re = util_1.URL_REGEX;
+        while ((match = re.exec(text.utf16))) {
+            let uri = match[2];
+            if (!uri.startsWith('http')) {
+                const domain = match.groups?.domain;
+                if (!domain || !isValidDomain(domain)) {
+                    continue;
+                }
+                uri = `https://${uri}`;
+            }
+            const start = text.utf16.indexOf(match[2], match.index);
+            const index = { start, end: start + match[2].length };
+            // strip ending puncuation
+            if (/[.,;:!?]$/.test(uri)) {
+                uri = uri.slice(0, -1);
+                index.end--;
+            }
+            if (/[)]$/.test(uri) && !uri.includes('(')) {
+                uri = uri.slice(0, -1);
+                index.end--;
+            }
+            facets.push({
+                index: {
+                    byteStart: text.utf16IndexToUtf8Index(index.start),
+                    byteEnd: text.utf16IndexToUtf8Index(index.end),
+                },
+                features: [
+                    {
+                        $type: 'app.bsky.richtext.facet#link',
+                        uri,
+                    },
+                ],
+            });
+        }
+    }
+    {
+        const re = util_1.TAG_REGEX;
+        while ((match = re.exec(text.utf16))) {
+            let [, leading, tag] = match;
+            if (!tag)
+                continue;
+            // strip ending punctuation and any spaces
+            tag = tag.trim().replace(util_1.TRAILING_PUNCTUATION_REGEX, '');
+            if (tag.length === 0 || tag.length > 64)
+                continue;
+            const index = match.index + leading.length;
+            facets.push({
+                index: {
+                    byteStart: text.utf16IndexToUtf8Index(index),
+                    byteEnd: text.utf16IndexToUtf8Index(index + 1 + tag.length),
+                },
+                features: [
+                    {
+                        $type: 'app.bsky.richtext.facet#tag',
+                        tag: tag,
+                    },
+                ],
+            });
+        }
+    }
+    return facets.length > 0 ? facets : undefined;
+}
+exports.detectFacets = detectFacets;
+function isValidDomain(str) {
+    return !!tlds_1.default.find((tld) => {
+        const i = str.lastIndexOf(tld);
+        if (i === -1) {
+            return false;
+        }
+        return str.charAt(i - 1) === '.' && i === str.length - tld.length;
+    });
+}
+//# sourceMappingURL=detection.js.map

package/dist/rich-text/detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/rich-text/detection.ts"],"names":[],"mappings":"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"}

package/dist/rich-text/rich-text.d.ts

@@ -9,6 +9,9 @@ export type Entity = AppBskyFeedPost.Entity;
 export interface RichTextProps {
     text: string;
     facets?: Facet[];
+    /**
+     * @deprecated Use facets instead
+     */
     entities?: Entity[];
 }
 export interface RichTextOpts {
@@ -37,6 +40,16 @@ export declare class RichText {
     segments(): Generator<RichTextSegment, void, void>;
     insert(insertIndex: number, insertText: string): this;
     delete(removeStartIndex: number, removeEndIndex: number): this;
+    /**
+     * Detects facets such as links and mentions
+     * Note: Overwrites the existing facets with auto-detected facets
+     */
     detectFacets(agent: AtpAgent): Promise<void>;
+    /**
+     * Detects facets such as links and mentions but does not resolve them
+     * Will produce invalid facets! For instance, mentions will not have their DIDs set.
+     * Note: Overwrites the existing facets with auto-detected facets
+     */
     detectFacetsWithoutResolution(): void;
 }
+//# sourceMappingURL=rich-text.d.ts.map

package/dist/rich-text/rich-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.d.ts","sourceRoot":"","sources":["../../src/rich-text/rich-text.ts"],"names":[],"mappings":"AA6FA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAIzC,MAAM,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAA;AAC7C,MAAM,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAA;AACjD,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAA;AACvD,MAAM,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAA;AAC/C,MAAM,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,qBAAa,eAAe;IACP,IAAI,EAAE,MAAM;IAAS,KAAK,CAAC;gBAA3B,IAAI,EAAE,MAAM,EAAS,KAAK,CAAC,uCAAO;IAErD,IAAI,IAAI,IAAI,SAAS,GAAG,SAAS,CAMhC;IAED,MAAM;IAIN,IAAI,OAAO,IAAI,YAAY,GAAG,SAAS,CAMtC;IAED,SAAS;IAIT,IAAI,GAAG,IAAI,QAAQ,GAAG,SAAS,CAM9B;IAED,KAAK;CAGN;AAED,qBAAa,QAAQ;IACnB,WAAW,EAAE,aAAa,CAAA;IAC1B,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;gBAEJ,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,YAAY;IAcrD,IAAI,IAAI,WAEP;IAED,IAAI,MAAM,WAET;IAED,IAAI,cAAc,WAEjB;IAED,KAAK;IAOL,QAAQ,CAAC,MAAM,EAAE,QAAQ;IAKxB,QAAQ,IAAI,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC;IAyCnD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAkC9C,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAoEvD;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE,QAAQ;IAkBlC;;;;OAIG;IACH,6BAA6B;CAM9B"}

package/dist/rich-text/rich-text.js

@@ -0,0 +1,374 @@
+"use strict";
+/*
+= Rich Text Manipulation
+
+When we sanitize rich text, we have to update the entity indices as the
+text is modified. This can be modeled as inserts() and deletes() of the
+rich text string. The possible scenarios are outlined below, along with
+their expected behaviors.
+
+NOTE: Slices are start inclusive, end exclusive
+
+== richTextInsert()
+
+Target string:
+
+   0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l l o   w o r l d   // string value
+       ^-------^           // target slice {start: 2, end: 7}
+
+Scenarios:
+
+A: ^                       // insert "test" at 0
+B:        ^                // insert "test" at 4
+C:                 ^       // insert "test" at 8
+
+A = before           -> move both by num added
+B = inner            -> move end by num added
+C = after            -> noop
+
+Results:
+
+A: 0 1 2 3 4 5 6 7 8 910   // string indices
+   t e s t h e l l o   w   // string value
+               ^-------^   // target slice {start: 6, end: 11}
+
+B: 0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l l t e s t o   w   // string value
+       ^---------------^   // target slice {start: 2, end: 11}
+
+C: 0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l l o   w o t e s   // string value
+       ^-------^           // target slice {start: 2, end: 7}
+
+== richTextDelete()
+
+Target string:
+
+   0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l l o   w o r l d   // string value
+       ^-------^           // target slice {start: 2, end: 7}
+
+Scenarios:
+
+A: ^---------------^       // remove slice {start: 0, end: 9}
+B:               ^-----^   // remove slice {start: 7, end: 11}
+C:         ^-----------^   // remove slice {start: 4, end: 11}
+D:       ^-^               // remove slice {start: 3, end: 5}
+E:   ^-----^               // remove slice {start: 1, end: 5}
+F: ^-^                     // remove slice {start: 0, end: 2}
+
+A = entirely outer   -> delete slice
+B = entirely after   -> noop
+C = partially after  -> move end to remove-start
+D = entirely inner   -> move end by num removed
+E = partially before -> move start to remove-start index, move end by num removed
+F = entirely before  -> move both by num removed
+
+Results:
+
+A: 0 1 2 3 4 5 6 7 8 910   // string indices
+   l d                     // string value
+                           // target slice (deleted)
+
+B: 0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l l o   w           // string value
+       ^-------^           // target slice {start: 2, end: 7}
+
+C: 0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l l                 // string value
+       ^-^                 // target slice {start: 2, end: 4}
+
+D: 0 1 2 3 4 5 6 7 8 910   // string indices
+   h e l   w o r l d       // string value
+       ^---^               // target slice {start: 2, end: 5}
+
+E: 0 1 2 3 4 5 6 7 8 910   // string indices
+   h   w o r l d           // string value
+     ^-^                   // target slice {start: 1, end: 3}
+
+F: 0 1 2 3 4 5 6 7 8 910   // string indices
+   l l o   w o r l d       // string value
+   ^-------^               // target slice {start: 0, end: 5}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RichText = exports.RichTextSegment = void 0;
+const client_1 = require("../client");
+const unicode_1 = require("./unicode");
+const sanitization_1 = require("./sanitization");
+const detection_1 = require("./detection");
+class RichTextSegment {
+    constructor(text, facet) {
+        Object.defineProperty(this, "text", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: text
+        });
+        Object.defineProperty(this, "facet", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: facet
+        });
+    }
+    get link() {
+        const link = this.facet?.features.find(client_1.AppBskyRichtextFacet.isLink);
+        if (client_1.AppBskyRichtextFacet.isLink(link)) {
+            return link;
+        }
+        return undefined;
+    }
+    isLink() {
+        return !!this.link;
+    }
+    get mention() {
+        const mention = this.facet?.features.find(client_1.AppBskyRichtextFacet.isMention);
+        if (client_1.AppBskyRichtextFacet.isMention(mention)) {
+            return mention;
+        }
+        return undefined;
+    }
+    isMention() {
+        return !!this.mention;
+    }
+    get tag() {
+        const tag = this.facet?.features.find(client_1.AppBskyRichtextFacet.isTag);
+        if (client_1.AppBskyRichtextFacet.isTag(tag)) {
+            return tag;
+        }
+        return undefined;
+    }
+    isTag() {
+        return !!this.tag;
+    }
+}
+exports.RichTextSegment = RichTextSegment;
+class RichText {
+    constructor(props, opts) {
+        Object.defineProperty(this, "unicodeText", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "facets", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.unicodeText = new unicode_1.UnicodeString(props.text);
+        this.facets = props.facets;
+        if (!this.facets?.length && props.entities?.length) {
+            this.facets = entitiesToFacets(this.unicodeText, props.entities);
+        }
+        if (this.facets) {
+            this.facets.sort(facetSort);
+        }
+        if (opts?.cleanNewlines) {
+            (0, sanitization_1.sanitizeRichText)(this, { cleanNewlines: true }).copyInto(this);
+        }
+    }
+    get text() {
+        return this.unicodeText.toString();
+    }
+    get length() {
+        return this.unicodeText.length;
+    }
+    get graphemeLength() {
+        return this.unicodeText.graphemeLength;
+    }
+    clone() {
+        return new RichText({
+            text: this.unicodeText.utf16,
+            facets: cloneDeep(this.facets),
+        });
+    }
+    copyInto(target) {
+        target.unicodeText = this.unicodeText;
+        target.facets = cloneDeep(this.facets);
+    }
+    *segments() {
+        const facets = this.facets || [];
+        if (!facets.length) {
+            yield new RichTextSegment(this.unicodeText.utf16);
+            return;
+        }
+        let textCursor = 0;
+        let facetCursor = 0;
+        do {
+            const currFacet = facets[facetCursor];
+            if (textCursor < currFacet.index.byteStart) {
+                yield new RichTextSegment(this.unicodeText.slice(textCursor, currFacet.index.byteStart));
+            }
+            else if (textCursor > currFacet.index.byteStart) {
+                facetCursor++;
+                continue;
+            }
+            if (currFacet.index.byteStart < currFacet.index.byteEnd) {
+                const subtext = this.unicodeText.slice(currFacet.index.byteStart, currFacet.index.byteEnd);
+                if (!subtext.trim()) {
+                    // dont empty string entities
+                    yield new RichTextSegment(subtext);
+                }
+                else {
+                    yield new RichTextSegment(subtext, currFacet);
+                }
+            }
+            textCursor = currFacet.index.byteEnd;
+            facetCursor++;
+        } while (facetCursor < facets.length);
+        if (textCursor < this.unicodeText.length) {
+            yield new RichTextSegment(this.unicodeText.slice(textCursor, this.unicodeText.length));
+        }
+    }
+    insert(insertIndex, insertText) {
+        this.unicodeText = new unicode_1.UnicodeString(this.unicodeText.slice(0, insertIndex) +
+            insertText +
+            this.unicodeText.slice(insertIndex));
+        if (!this.facets?.length) {
+            return this;
+        }
+        const numCharsAdded = insertText.length;
+        for (const ent of this.facets) {
+            // see comment at top of file for labels of each scenario
+            // scenario A (before)
+            if (insertIndex <= ent.index.byteStart) {
+                // move both by num added
+                ent.index.byteStart += numCharsAdded;
+                ent.index.byteEnd += numCharsAdded;
+            }
+            // scenario B (inner)
+            else if (insertIndex >= ent.index.byteStart &&
+                insertIndex < ent.index.byteEnd) {
+                // move end by num added
+                ent.index.byteEnd += numCharsAdded;
+            }
+            // scenario C (after)
+            // noop
+        }
+        return this;
+    }
+    delete(removeStartIndex, removeEndIndex) {
+        this.unicodeText = new unicode_1.UnicodeString(this.unicodeText.slice(0, removeStartIndex) +
+            this.unicodeText.slice(removeEndIndex));
+        if (!this.facets?.length) {
+            return this;
+        }
+        const numCharsRemoved = removeEndIndex - removeStartIndex;
+        for (const ent of this.facets) {
+            // see comment at top of file for labels of each scenario
+            // scenario A (entirely outer)
+            if (removeStartIndex <= ent.index.byteStart &&
+                removeEndIndex >= ent.index.byteEnd) {
+                // delete slice (will get removed in final pass)
+                ent.index.byteStart = 0;
+                ent.index.byteEnd = 0;
+            }
+            // scenario B (entirely after)
+            else if (removeStartIndex > ent.index.byteEnd) {
+                // noop
+            }
+            // scenario C (partially after)
+            else if (removeStartIndex > ent.index.byteStart &&
+                removeStartIndex <= ent.index.byteEnd &&
+                removeEndIndex > ent.index.byteEnd) {
+                // move end to remove start
+                ent.index.byteEnd = removeStartIndex;
+            }
+            // scenario D (entirely inner)
+            else if (removeStartIndex >= ent.index.byteStart &&
+                removeEndIndex <= ent.index.byteEnd) {
+                // move end by num removed
+                ent.index.byteEnd -= numCharsRemoved;
+            }
+            // scenario E (partially before)
+            else if (removeStartIndex < ent.index.byteStart &&
+                removeEndIndex >= ent.index.byteStart &&
+                removeEndIndex <= ent.index.byteEnd) {
+                // move start to remove-start index, move end by num removed
+                ent.index.byteStart = removeStartIndex;
+                ent.index.byteEnd -= numCharsRemoved;
+            }
+            // scenario F (entirely before)
+            else if (removeEndIndex < ent.index.byteStart) {
+                // move both by num removed
+                ent.index.byteStart -= numCharsRemoved;
+                ent.index.byteEnd -= numCharsRemoved;
+            }
+        }
+        // filter out any facets that were made irrelevant
+        this.facets = this.facets.filter((ent) => ent.index.byteStart < ent.index.byteEnd);
+        return this;
+    }
+    /**
+     * Detects facets such as links and mentions
+     * Note: Overwrites the existing facets with auto-detected facets
+     */
+    async detectFacets(agent) {
+        this.facets = (0, detection_1.detectFacets)(this.unicodeText);
+        if (this.facets) {
+            for (const facet of this.facets) {
+                for (const feature of facet.features) {
+                    if (client_1.AppBskyRichtextFacet.isMention(feature)) {
+                        const did = await agent
+                            .resolveHandle({ handle: feature.did })
+                            .catch((_) => undefined)
+                            .then((res) => res?.data.did);
+                        feature.did = did || '';
+                    }
+                }
+            }
+            this.facets.sort(facetSort);
+        }
+    }
+    /**
+     * Detects facets such as links and mentions but does not resolve them
+     * Will produce invalid facets! For instance, mentions will not have their DIDs set.
+     * Note: Overwrites the existing facets with auto-detected facets
+     */
+    detectFacetsWithoutResolution() {
+        this.facets = (0, detection_1.detectFacets)(this.unicodeText);
+        if (this.facets) {
+            this.facets.sort(facetSort);
+        }
+    }
+}
+exports.RichText = RichText;
+const facetSort = (a, b) => a.index.byteStart - b.index.byteStart;
+function entitiesToFacets(text, entities) {
+    const facets = [];
+    for (const ent of entities) {
+        if (ent.type === 'link') {
+            facets.push({
+                $type: 'app.bsky.richtext.facet',
+                index: {
+                    byteStart: text.utf16IndexToUtf8Index(ent.index.start),
+                    byteEnd: text.utf16IndexToUtf8Index(ent.index.end),
+                },
+                features: [{ $type: 'app.bsky.richtext.facet#link', uri: ent.value }],
+            });
+        }
+        else if (ent.type === 'mention') {
+            facets.push({
+                $type: 'app.bsky.richtext.facet',
+                index: {
+                    byteStart: text.utf16IndexToUtf8Index(ent.index.start),
+                    byteEnd: text.utf16IndexToUtf8Index(ent.index.end),
+                },
+                features: [
+                    { $type: 'app.bsky.richtext.facet#mention', did: ent.value },
+                ],
+            });
+        }
+    }
+    return facets;
+}
+function cloneDeep(v) {
+    if (typeof v === 'undefined') {
+        return v;
+    }
+    return JSON.parse(JSON.stringify(v));
+}
+//# sourceMappingURL=rich-text.js.map

package/dist/rich-text/rich-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.js","sourceRoot":"","sources":["../../src/rich-text/rich-text.ts"],"names":[],"mappings":"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"}

package/dist/rich-text/sanitization.d.ts

@@ -2,3 +2,4 @@ import { RichText } from './rich-text';
 export declare function sanitizeRichText(richText: RichText, opts: {
     cleanNewlines?: boolean;
 }): RichText;
+//# sourceMappingURL=sanitization.d.ts.map

package/dist/rich-text/sanitization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitization.d.ts","sourceRoot":"","sources":["../../src/rich-text/sanitization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAQtC,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,YAMlC"}

package/dist/rich-text/sanitization.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeRichText = void 0;
+const unicode_1 = require("./unicode");
+// this regex is intentionally matching on the zero-with-separator codepoint
+// eslint-disable-next-line no-misleading-character-class
+const EXCESS_SPACE_RE = /[\r\n]([\u00AD\u2060\u200D\u200C\u200B\s]*[\r\n]){2,}/;
+const REPLACEMENT_STR = '\n\n';
+function sanitizeRichText(richText, opts) {
+    if (opts.cleanNewlines) {
+        richText = clean(richText, EXCESS_SPACE_RE, REPLACEMENT_STR);
+    }
+    return richText;
+}
+exports.sanitizeRichText = sanitizeRichText;
+function clean(richText, targetRegexp, replacementString) {
+    richText = richText.clone();
+    let match = richText.unicodeText.utf16.match(targetRegexp);
+    while (match && typeof match.index !== 'undefined') {
+        const oldText = richText.unicodeText;
+        const removeStartIndex = richText.unicodeText.utf16IndexToUtf8Index(match.index);
+        const removeEndIndex = removeStartIndex + new unicode_1.UnicodeString(match[0]).length;
+        richText.delete(removeStartIndex, removeEndIndex);
+        if (richText.unicodeText.utf16 === oldText.utf16) {
+            break; // sanity check
+        }
+        richText.insert(removeStartIndex, replacementString);
+        match = richText.unicodeText.utf16.match(targetRegexp);
+    }
+    return richText;
+}
+//# sourceMappingURL=sanitization.js.map

package/dist/rich-text/sanitization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitization.js","sourceRoot":"","sources":["../../src/rich-text/sanitization.ts"],"names":[],"mappings":";;;AACA,uCAAyC;AAEzC,4EAA4E;AAC5E,yDAAyD;AACzD,MAAM,eAAe,GAAG,uDAAuD,CAAA;AAC/E,MAAM,eAAe,GAAG,MAAM,CAAA;AAE9B,SAAgB,gBAAgB,CAC9B,QAAkB,EAClB,IAAiC;IAEjC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AARD,4CAQC;AAED,SAAS,KAAK,CACZ,QAAkB,EAClB,YAAoB,EACpB,iBAAyB;IAEzB,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAA;IAE3B,IAAI,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAC1D,OAAO,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAA;QACpC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,CAAC,qBAAqB,CACjE,KAAK,CAAC,KAAK,CACZ,CAAA;QACD,MAAM,cAAc,GAAG,gBAAgB,GAAG,IAAI,uBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAC5E,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAA;QACjD,IAAI,QAAQ,CAAC,WAAW,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;YACjD,MAAK,CAAC,eAAe;QACvB,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;QACpD,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACxD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/rich-text/unicode.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Javascript uses utf16-encoded strings while most environments and specs
+ * have standardized around utf8 (including JSON).
+ *
+ * After some lengthy debated we decided that richtext facets need to use
+ * utf8 indices. This means we need tools to convert indices between utf8
+ * and utf16, and that's precisely what this library handles.
+ */
 export declare class UnicodeString {
     utf16: string;
     utf8: Uint8Array;
@@ -9,3 +17,4 @@ export declare class UnicodeString {
     utf16IndexToUtf8Index(i: number): number;
     toString(): string;
 }
+//# sourceMappingURL=unicode.d.ts.map

package/dist/rich-text/unicode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode.d.ts","sourceRoot":"","sources":["../../src/rich-text/unicode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,qBAAa,aAAa;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,CAAC,YAAY,CAAC,CAAoB;gBAE7B,KAAK,EAAE,MAAM;IAKzB,IAAI,MAAM,WAET;IAED,IAAI,cAAc,WAKjB;IAED,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAI3C,qBAAqB,CAAC,CAAC,EAAE,MAAM;IAI/B,QAAQ;CAGT"}

package/dist/rich-text/unicode.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Javascript uses utf16-encoded strings while most environments and specs
+ * have standardized around utf8 (including JSON).
+ *
+ * After some lengthy debated we decided that richtext facets need to use
+ * utf8 indices. This means we need tools to convert indices between utf8
+ * and utf16, and that's precisely what this library handles.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnicodeString = void 0;
+const common_web_1 = require("@atproto/common-web");
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+class UnicodeString {
+    constructor(utf16) {
+        Object.defineProperty(this, "utf16", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "utf8", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_graphemeLen", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.utf16 = utf16;
+        this.utf8 = encoder.encode(utf16);
+    }
+    get length() {
+        return this.utf8.byteLength;
+    }
+    get graphemeLength() {
+        if (!this._graphemeLen) {
+            this._graphemeLen = (0, common_web_1.graphemeLen)(this.utf16);
+        }
+        return this._graphemeLen;
+    }
+    slice(start, end) {
+        return decoder.decode(this.utf8.slice(start, end));
+    }
+    utf16IndexToUtf8Index(i) {
+        return encoder.encode(this.utf16.slice(0, i)).byteLength;
+    }
+    toString() {
+        return this.utf16;
+    }
+}
+exports.UnicodeString = UnicodeString;
+//# sourceMappingURL=unicode.js.map

package/dist/rich-text/unicode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode.js","sourceRoot":"","sources":["../../src/rich-text/unicode.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,oDAAiD;AAEjD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;AACjC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;AAEjC,MAAa,aAAa;IAKxB,YAAY,KAAa;QAJzB;;;;;WAAa;QACb;;;;;WAAgB;QACR;;;;;WAAiC;QAGvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAA;IAC7B,CAAC;IAED,IAAI,cAAc;QAChB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAA,wBAAW,EAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,KAAc,EAAE,GAAY;QAChC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,qBAAqB,CAAC,CAAS;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;IAC1D,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;CACF;AAhCD,sCAgCC"}