@zlooks.cn/blog-server 1.0.0

package/dist/persistence/post-engagement-store.js

@@ -0,0 +1,85 @@
+import { In } from 'typeorm';
+import { BlogConflictError, BlogNotFoundError } from '../blog/errors.js';
+import { BlogPostEntity, BlogPostLikeEntity, BlogPostViewMarkEntity, } from './entities.js';
+export class PostEngagementStore {
+    dataSource;
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+    }
+    recordView(postId, subjectHashes, now, windowMs, signal) {
+        signal?.throwIfAborted();
+        const subjects = [...new Set(subjectHashes)];
+        if (subjects.length === 0)
+            throw new TypeError('A post view requires at least one subject');
+        return this.dataSource.transaction(async (manager) => {
+            const posts = manager.getRepository(BlogPostEntity);
+            const post = await posts.findOne({ where: { id: postId }, lock: { mode: 'pessimistic_write' } });
+            signal?.throwIfAborted();
+            if (!post)
+                throw new BlogNotFoundError('Post not found');
+            if (post.status !== 'published')
+                throw new BlogConflictError('Only published posts accept views');
+            const marks = manager.getRepository(BlogPostViewMarkEntity);
+            const current = await marks.find({ where: { postId, subjectHash: In(subjects) } });
+            signal?.throwIfAborted();
+            const cutoff = now.getTime() - windowMs;
+            const recent = current
+                .filter(({ countedAt }) => countedAt.getTime() >= cutoff)
+                .sort((left, right) => right.countedAt.getTime() - left.countedAt.getTime())[0];
+            if (recent) {
+                await this.saveMarks(marks, postId, subjects, current, recent.countedAt);
+                signal?.throwIfAborted();
+                return { counted: false, countedAt: recent.countedAt, viewCount: post.viewCount };
+            }
+            await this.saveMarks(marks, postId, subjects, current, now);
+            signal?.throwIfAborted();
+            await posts.increment({ id: postId }, 'viewCount', 1);
+            signal?.throwIfAborted();
+            return { counted: true, countedAt: now, viewCount: post.viewCount + 1 };
+        });
+    }
+    async read(postId, userId, signal) {
+        signal?.throwIfAborted();
+        const posts = this.dataSource.getRepository(BlogPostEntity);
+        const likes = this.dataSource.getRepository(BlogPostLikeEntity);
+        const [post, likeCount, liked] = await Promise.all([
+            posts.findOneBy({ id: postId }),
+            likes.countBy({ postId }),
+            userId ? likes.existsBy({ postId, userId }) : false,
+        ]);
+        signal?.throwIfAborted();
+        if (!post)
+            throw new BlogNotFoundError('Post not found');
+        return { viewCount: post.viewCount, likeCount, liked };
+    }
+    setLiked(postId, userId, liked, signal) {
+        signal?.throwIfAborted();
+        return this.dataSource.transaction(async (manager) => {
+            const posts = manager.getRepository(BlogPostEntity);
+            const post = await posts.findOne({ where: { id: postId }, lock: { mode: 'pessimistic_write' } });
+            signal?.throwIfAborted();
+            if (!post)
+                throw new BlogNotFoundError('Post not found');
+            if (post.status !== 'published')
+                throw new BlogConflictError('Only published posts accept likes');
+            const likes = manager.getRepository(BlogPostLikeEntity);
+            const current = await likes.findOneBy({ postId, userId });
+            signal?.throwIfAborted();
+            if (liked && !current)
+                await likes.insert({ postId, userId });
+            if (!liked && current)
+                await likes.delete({ postId, userId });
+            signal?.throwIfAborted();
+            const likeCount = await likes.countBy({ postId });
+            signal?.throwIfAborted();
+            return { liked, likeCount };
+        });
+    }
+    saveMarks(repository, postId, subjects, current, countedAt) {
+        const bySubject = new Map(current.map((mark) => [mark.subjectHash, mark]));
+        return repository.save(subjects.map((subjectHash) => repository.create({
+            ...(bySubject.get(subjectHash) ?? {}), postId, subjectHash, countedAt,
+        })));
+    }
+}
+//# sourceMappingURL=post-engagement-store.js.map

package/dist/persistence/post-engagement-store.js.map

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

package/dist/persistence/post-store.d.ts

@@ -0,0 +1,87 @@
+import { type DataSource } from 'typeorm';
+import { type BlogPostRow, type BlogTagRow } from './entities.js';
+export interface PostInput {
+    readonly categoryId: string;
+    readonly title: string;
+    readonly slug: string;
+    readonly summary: string | null;
+    readonly coverUrl: string | null;
+    readonly content: string;
+    readonly tagIds: readonly string[];
+}
+export interface PostView extends BlogPostRow {
+    readonly tags: readonly BlogTagRow[];
+}
+export interface PostConnections {
+    readonly previousPost: PostView | null;
+    readonly nextPost: PostView | null;
+    readonly relatedPosts: readonly PostView[];
+}
+export interface PostArchiveMonth {
+    readonly year: number;
+    readonly month: number;
+    readonly count: number;
+}
+export interface PostArchivePage {
+    readonly items: readonly PostView[];
+    readonly months: readonly PostArchiveMonth[];
+    readonly nextCursor: string | null;
+    readonly total: number;
+}
+export declare class PostStore {
+    private readonly dataSource;
+    private readonly clock;
+    constructor(dataSource: DataSource, clock?: () => Date);
+    countPublishedByCategory(signal?: AbortSignal): Promise<ReadonlyMap<string, number>>;
+    list(input: {
+        limit: number;
+        cursor?: string | undefined;
+        status?: BlogPostRow['status'] | undefined;
+        categoryId?: string | undefined;
+    }, signal?: AbortSignal): Promise<{
+        items: PostView[];
+        nextCursor: string | null;
+    }>;
+    listPublished(options: {
+        limit: number;
+        cursor?: string;
+        page?: number;
+        categorySlug?: string;
+        tagSlug?: string;
+    }, signal?: AbortSignal): Promise<{
+        items: PostView[];
+        nextCursor: string | null;
+        total: number;
+    }>;
+    listPublishedArchive(options: {
+        limit: number;
+        monthLimit: number;
+        cursor?: string;
+        page?: number;
+        year?: number;
+        month?: number;
+        startYear?: number;
+        startMonth?: number;
+        endYear?: number;
+        endMonth?: number;
+    }, signal?: AbortSignal): Promise<PostArchivePage>;
+    search(input: {
+        query: string;
+        limit: number;
+        status?: BlogPostRow['status'];
+    }, signal?: AbortSignal): Promise<readonly PostView[]>;
+    read(id: string, signal?: AbortSignal): Promise<PostView>;
+    readPublishedBySlug(slug: string, signal?: AbortSignal): Promise<PostView | undefined>;
+    readPublishedByIds(ids: readonly string[], signal?: AbortSignal): Promise<PostView[]>;
+    readPublishedConnections(slug: string, relatedLimit: number, signal?: AbortSignal): Promise<PostConnections | undefined>;
+    create(input: PostInput, signal?: AbortSignal): Promise<PostView>;
+    update(id: string, input: PostInput, signal?: AbortSignal): Promise<PostView>;
+    publish(id: string, signal?: AbortSignal): Promise<PostView>;
+    archive(id: string, signal?: AbortSignal): Promise<PostView>;
+    delete(id: string, signal?: AbortSignal): Promise<void>;
+    private assertReferences;
+    private replaceTags;
+    private withTags;
+    private listRelated;
+}
+//# sourceMappingURL=post-store.d.ts.map

package/dist/persistence/post-store.d.ts.map

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

package/dist/persistence/post-store.js

@@ -0,0 +1,465 @@
+import { And, Equal, ILike, In, LessThan, MoreThan, MoreThanOrEqual } from 'typeorm';
+import { BlogConflictError, BlogCursorError, BlogNotFoundError, PostContentBlockedError } from '../blog/errors.js';
+import { auditPostContent } from '../blog/post-content-audit.js';
+import { BlogCategoryEntity, BlogPostEntity, BlogPostTagEntity, BlogTagEntity, } from './entities.js';
+const ARCHIVE_INDEX_POST_LIMIT = 10_000;
+export class PostStore {
+    dataSource;
+    clock;
+    constructor(dataSource, clock = () => new Date()) {
+        this.dataSource = dataSource;
+        this.clock = clock;
+    }
+    async countPublishedByCategory(signal) {
+        signal?.throwIfAborted();
+        const rows = await this.dataSource.getRepository(BlogPostEntity)
+            .createQueryBuilder('post')
+            .select('post.categoryId', 'categoryId')
+            .addSelect('COUNT(post.id)', 'postCount')
+            .where('post.status = :status', { status: 'published' })
+            .groupBy('post.categoryId')
+            .getRawMany();
+        signal?.throwIfAborted();
+        return new Map(rows.map(({ categoryId, postCount }) => [categoryId, parsePostCount(postCount)]));
+    }
+    async list(input, signal) {
+        signal?.throwIfAborted();
+        const base = { ...(input.status ? { status: input.status } : {}), ...(input.categoryId ? { categoryId: input.categoryId } : {}) };
+        const cursor = input.cursor ? await this.dataSource.getRepository(BlogPostEntity).findOne({ where: { id: input.cursor, ...base } }) : undefined;
+        signal?.throwIfAborted();
+        if (input.cursor && !cursor)
+            throw new BlogCursorError('Post cursor not found in current filter');
+        const where = cursor
+            ? [{ ...base, createdAt: LessThan(cursor.createdAt) }, { ...base, createdAt: Equal(cursor.createdAt), id: LessThan(cursor.id) }]
+            : base;
+        const posts = await this.dataSource.getRepository(BlogPostEntity).find({ where, order: { createdAt: 'DESC', id: 'DESC' }, take: input.limit + 1 });
+        signal?.throwIfAborted();
+        const hasMore = posts.length > input.limit;
+        const bounded = hasMore ? posts.slice(0, input.limit) : posts;
+        return { items: await this.withTags(bounded, this.dataSource.manager, signal), nextCursor: hasMore ? bounded.at(-1)?.id ?? null : null };
+    }
+    async listPublished(options, signal) {
+        signal?.throwIfAborted();
+        let categoryId;
+        let tagId;
+        if (options.categorySlug) {
+            const category = await this.dataSource.getRepository(BlogCategoryEntity).findOneBy({ slug: options.categorySlug });
+            signal?.throwIfAborted();
+            if (!category)
+                return { items: [], nextCursor: null, total: 0 };
+            categoryId = category.id;
+        }
+        if (options.tagSlug) {
+            const tag = await this.dataSource.getRepository(BlogTagEntity).findOneBy({ slug: options.tagSlug });
+            signal?.throwIfAborted();
+            if (!tag)
+                return { items: [], nextCursor: null, total: 0 };
+            tagId = tag.id;
+        }
+        const base = {
+            status: 'published', ...(categoryId ? { categoryId } : {}),
+            ...(tagId ? { postTags: { tagId } } : {}),
+        };
+        const repository = this.dataSource.getRepository(BlogPostEntity);
+        const total = await repository.count({ where: base });
+        signal?.throwIfAborted();
+        if (options.page) {
+            const posts = await repository.find({
+                where: base,
+                order: { publishedAt: 'DESC', id: 'DESC' },
+                skip: (options.page - 1) * options.limit,
+                take: options.limit,
+            });
+            signal?.throwIfAborted();
+            return {
+                items: await this.withTags(posts, this.dataSource.manager, signal),
+                nextCursor: options.page * options.limit < total ? posts.at(-1)?.id ?? null : null,
+                total,
+            };
+        }
+        const cursor = options.cursor
+            ? await repository.findOne({ where: { id: options.cursor, ...base } })
+            : undefined;
+        signal?.throwIfAborted();
+        if (options.cursor && !cursor)
+            throw new BlogCursorError('Post cursor not found in current filter');
+        if (cursor && !cursor.publishedAt)
+            throw new BlogCursorError('Published post cursor is incomplete');
+        const where = cursor?.publishedAt
+            ? [
+                { ...base, publishedAt: LessThan(cursor.publishedAt) },
+                { ...base, publishedAt: Equal(cursor.publishedAt), id: LessThan(cursor.id) },
+            ]
+            : base;
+        const posts = await repository.find({
+            where, order: { publishedAt: 'DESC', id: 'DESC' }, take: options.limit + 1,
+        });
+        signal?.throwIfAborted();
+        const hasMore = posts.length > options.limit;
+        const bounded = hasMore ? posts.slice(0, options.limit) : posts;
+        return { items: await this.withTags(bounded, this.dataSource.manager, signal), nextCursor: hasMore ? bounded.at(-1)?.id ?? null : null, total };
+    }
+    async listPublishedArchive(options, signal) {
+        signal?.throwIfAborted();
+        const repository = this.dataSource.getRepository(BlogPostEntity);
+        const publishedAt = archivePublishedAtRange(options);
+        const base = {
+            status: 'published',
+            ...(publishedAt ? { publishedAt } : {}),
+        };
+        const total = await repository.count({ where: base });
+        signal?.throwIfAborted();
+        const archiveIndex = await repository.find({
+            select: { id: true, publishedAt: true },
+            where: { status: 'published' },
+            order: { publishedAt: 'DESC', id: 'DESC' },
+            take: ARCHIVE_INDEX_POST_LIMIT + 1,
+        });
+        signal?.throwIfAborted();
+        if (archiveIndex.length > ARCHIVE_INDEX_POST_LIMIT) {
+            throw new BlogConflictError('Published archive exceeds the supported index size');
+        }
+        const months = aggregateArchiveMonths(archiveIndex, options.monthLimit);
+        if (options.limit === 0)
+            return { items: [], months, nextCursor: null, total };
+        if (options.page) {
+            const posts = await repository.find({
+                where: base,
+                order: { publishedAt: 'DESC', id: 'DESC' },
+                skip: (options.page - 1) * options.limit,
+                take: options.limit,
+            });
+            signal?.throwIfAborted();
+            return {
+                items: await this.withTags(posts, this.dataSource.manager, signal),
+                months,
+                nextCursor: options.page * options.limit < total ? posts.at(-1)?.id ?? null : null,
+                total,
+            };
+        }
+        const cursor = options.cursor
+            ? await repository.findOne({ where: { id: options.cursor, ...base } })
+            : undefined;
+        signal?.throwIfAborted();
+        if (options.cursor && !cursor)
+            throw new BlogCursorError('Post archive cursor not found in current filter');
+        if (cursor && !cursor.publishedAt)
+            throw new BlogCursorError('Published post archive cursor is incomplete');
+        const where = cursor?.publishedAt
+            ? [
+                {
+                    ...base,
+                    publishedAt: publishedAt
+                        ? And(publishedAt, LessThan(cursor.publishedAt))
+                        : LessThan(cursor.publishedAt),
+                },
+                { ...base, publishedAt: Equal(cursor.publishedAt), id: LessThan(cursor.id) },
+            ]
+            : base;
+        const posts = await repository.find({
+            where, order: { publishedAt: 'DESC', id: 'DESC' }, take: options.limit + 1,
+        });
+        signal?.throwIfAborted();
+        const hasMore = posts.length > options.limit;
+        const bounded = hasMore ? posts.slice(0, options.limit) : posts;
+        return {
+            items: await this.withTags(bounded, this.dataSource.manager, signal),
+            months,
+            nextCursor: hasMore ? bounded.at(-1)?.id ?? null : null,
+            total,
+        };
+    }
+    async search(input, signal) {
+        signal?.throwIfAborted();
+        const match = ILike(`%${escapeLikePattern(input.query.trim())}%`);
+        const base = input.status ? { status: input.status } : {};
+        const posts = await this.dataSource.getRepository(BlogPostEntity).find({
+            where: [
+                { ...base, title: match },
+                { ...base, summary: match },
+                { ...base, content: match },
+            ],
+            order: { updatedAt: 'DESC', id: 'DESC' },
+            take: input.limit,
+        });
+        signal?.throwIfAborted();
+        return this.withTags(posts, this.dataSource.manager, signal);
+    }
+    async read(id, signal) {
+        signal?.throwIfAborted();
+        const post = await this.dataSource.getRepository(BlogPostEntity).findOneBy({ id });
+        signal?.throwIfAborted();
+        if (!post)
+            throw new BlogNotFoundError('Post not found');
+        return (await this.withTags([post], this.dataSource.manager, signal))[0];
+    }
+    async readPublishedBySlug(slug, signal) {
+        signal?.throwIfAborted();
+        const post = await this.dataSource.getRepository(BlogPostEntity).findOneBy({ slug, status: 'published' });
+        signal?.throwIfAborted();
+        return post ? (await this.withTags([post], this.dataSource.manager, signal))[0] : undefined;
+    }
+    async readPublishedByIds(ids, signal) {
+        signal?.throwIfAborted();
+        if (ids.length === 0)
+            return [];
+        const posts = await this.dataSource.getRepository(BlogPostEntity).find({
+            where: { id: In([...new Set(ids)]), status: 'published' },
+        });
+        signal?.throwIfAborted();
+        return this.withTags(posts, this.dataSource.manager, signal);
+    }
+    async readPublishedConnections(slug, relatedLimit, signal) {
+        signal?.throwIfAborted();
+        const repository = this.dataSource.getRepository(BlogPostEntity);
+        const current = await repository.findOneBy({ slug, status: 'published' });
+        signal?.throwIfAborted();
+        if (!current?.publishedAt)
+            return undefined;
+        const previous = await repository.find({
+            where: [
+                { status: 'published', publishedAt: LessThan(current.publishedAt) },
+                { status: 'published', publishedAt: Equal(current.publishedAt), id: LessThan(current.id) },
+            ],
+            order: { publishedAt: 'DESC', id: 'DESC' },
+            take: 1,
+        });
+        signal?.throwIfAborted();
+        const next = await repository.find({
+            where: [
+                { status: 'published', publishedAt: MoreThan(current.publishedAt) },
+                { status: 'published', publishedAt: Equal(current.publishedAt), id: MoreThan(current.id) },
+            ],
+            order: { publishedAt: 'ASC', id: 'ASC' },
+            take: 1,
+        });
+        signal?.throwIfAborted();
+        const related = current.id
+            ? await this.listRelated(current.id, relatedLimit, signal)
+            : [];
+        signal?.throwIfAborted();
+        const adjacentPosts = await this.withTags([
+            ...(previous[0] ? [previous[0]] : []),
+            ...(next[0] ? [next[0]] : []),
+        ], this.dataSource.manager, signal);
+        const adjacentById = new Map(adjacentPosts.map((post) => [post.id, post]));
+        return {
+            previousPost: previous[0] ? adjacentById.get(previous[0].id) ?? null : null,
+            nextPost: next[0] ? adjacentById.get(next[0].id) ?? null : null,
+            relatedPosts: related,
+        };
+    }
+    create(input, signal) {
+        signal?.throwIfAborted();
+        return this.dataSource.transaction(async (manager) => {
+            await this.assertReferences(manager, input, signal);
+            signal?.throwIfAborted();
+            const repository = manager.getRepository(BlogPostEntity);
+            const post = await repository.save(repository.create({
+                ...withoutTagIds(input), status: 'draft', publishedAt: null, viewCount: 0,
+            }));
+            signal?.throwIfAborted();
+            await this.replaceTags(manager, post.id, input.tagIds, signal);
+            signal?.throwIfAborted();
+            return (await this.withTags([post], manager, signal))[0];
+        });
+    }
+    update(id, input, signal) {
+        signal?.throwIfAborted();
+        return this.dataSource.transaction(async (manager) => {
+            const current = await manager.getRepository(BlogPostEntity).findOne({
+                where: { id }, lock: { mode: 'pessimistic_write' },
+            });
+            signal?.throwIfAborted();
+            if (!current)
+                throw new BlogNotFoundError('Post not found');
+            if (current.status === 'published')
+                assertPublishableContent(input);
+            await this.assertReferences(manager, input, signal);
+            signal?.throwIfAborted();
+            await manager.getRepository(BlogPostEntity).update({ id }, withoutTagIds(input));
+            signal?.throwIfAborted();
+            await this.replaceTags(manager, id, input.tagIds, signal);
+            signal?.throwIfAborted();
+            const post = await manager.getRepository(BlogPostEntity).findOneByOrFail({ id });
+            signal?.throwIfAborted();
+            return (await this.withTags([post], manager, signal))[0];
+        });
+    }
+    publish(id, signal) {
+        signal?.throwIfAborted();
+        return this.dataSource.transaction(async (manager) => {
+            const repository = manager.getRepository(BlogPostEntity);
+            const post = await repository.findOne({ where: { id }, lock: { mode: 'pessimistic_write' } });
+            signal?.throwIfAborted();
+            if (!post)
+                throw new BlogNotFoundError('Post not found');
+            assertPublishableContent(post);
+            if (post.status !== 'published') {
+                await repository.update({ id }, { status: 'published', publishedAt: this.clock() });
+                signal?.throwIfAborted();
+            }
+            const updated = await repository.findOneByOrFail({ id });
+            signal?.throwIfAborted();
+            return (await this.withTags([updated], manager, signal))[0];
+        });
+    }
+    archive(id, signal) {
+        signal?.throwIfAborted();
+        return this.dataSource.transaction(async (manager) => {
+            const repository = manager.getRepository(BlogPostEntity);
+            const post = await repository.findOne({ where: { id }, lock: { mode: 'pessimistic_write' } });
+            signal?.throwIfAborted();
+            if (!post)
+                throw new BlogNotFoundError('Post not found');
+            if (post.status !== 'archived') {
+                await repository.update({ id }, { status: 'archived' });
+                signal?.throwIfAborted();
+            }
+            const updated = await repository.findOneByOrFail({ id });
+            signal?.throwIfAborted();
+            return (await this.withTags([updated], manager, signal))[0];
+        });
+    }
+    delete(id, signal) {
+        signal?.throwIfAborted();
+        return this.dataSource.transaction(async (manager) => {
+            const repository = manager.getRepository(BlogPostEntity);
+            const post = await repository.findOne({ where: { id }, lock: { mode: 'pessimistic_write' } });
+            signal?.throwIfAborted();
+            if (!post)
+                throw new BlogNotFoundError('Post not found');
+            if (post.status === 'published')
+                throw new BlogConflictError('Published post must be archived before deletion');
+            await repository.delete({ id });
+            signal?.throwIfAborted();
+        });
+    }
+    async assertReferences(manager, input, signal) {
+        signal?.throwIfAborted();
+        const category = await manager.getRepository(BlogCategoryEntity).findOneBy({ id: input.categoryId });
+        signal?.throwIfAborted();
+        if (!category)
+            throw new BlogNotFoundError('Category not found');
+        if (new Set(input.tagIds).size !== input.tagIds.length)
+            throw new BlogConflictError('Post tags must be unique');
+        if (input.tagIds.length > 20)
+            throw new BlogConflictError('Post cannot contain more than 20 tags');
+        if (!input.tagIds.length)
+            return;
+        const tags = await manager.getRepository(BlogTagEntity).countBy({ id: In([...input.tagIds]) });
+        signal?.throwIfAborted();
+        if (tags !== input.tagIds.length)
+            throw new BlogNotFoundError('Tag not found');
+    }
+    async replaceTags(manager, postId, tagIds, signal) {
+        signal?.throwIfAborted();
+        await manager.getRepository(BlogPostTagEntity).delete({ postId });
+        signal?.throwIfAborted();
+        if (tagIds.length) {
+            await manager.getRepository(BlogPostTagEntity).insert(tagIds.map((tagId) => ({ postId, tagId })));
+            signal?.throwIfAborted();
+        }
+    }
+    async withTags(posts, manager = this.dataSource.manager, signal) {
+        signal?.throwIfAborted();
+        if (!posts.length)
+            return [];
+        const postIds = posts.map(({ id }) => id);
+        const links = await manager.getRepository(BlogPostTagEntity).findBy({ postId: In(postIds) });
+        signal?.throwIfAborted();
+        const tagIds = [...new Set(links.map(({ tagId }) => tagId))];
+        const tags = tagIds.length ? await manager.getRepository(BlogTagEntity).findBy({ id: In(tagIds) }) : [];
+        signal?.throwIfAborted();
+        const tagById = new Map(tags.map((tag) => [tag.id, tag]));
+        const tagsByPost = new Map();
+        for (const link of links) {
+            const tag = tagById.get(link.tagId);
+            if (!tag)
+                continue;
+            const current = tagsByPost.get(link.postId) ?? [];
+            current.push(tag);
+            tagsByPost.set(link.postId, current);
+        }
+        return posts.map((post) => ({ ...post, tags: tagsByPost.get(post.id) ?? [] }));
+    }
+    async listRelated(postId, limit, signal) {
+        const currentLinks = await this.dataSource.getRepository(BlogPostTagEntity).findBy({ postId });
+        signal?.throwIfAborted();
+        if (!currentLinks.length)
+            return [];
+        const tagIds = currentLinks.map(({ tagId }) => tagId);
+        const ranked = await this.dataSource.getRepository(BlogPostTagEntity)
+            .createQueryBuilder('postTag')
+            .select('postTag.postId', 'postId')
+            .addSelect('COUNT(postTag.tagId)', 'sharedTagCount')
+            .innerJoin('postTag.post', 'post')
+            .where('post.status = :status', { status: 'published' })
+            .andWhere('post.id != :postId', { postId })
+            .andWhere('postTag.tagId IN (:...tagIds)', { tagIds })
+            .groupBy('postTag.postId')
+            .addGroupBy('post.publishedAt')
+            .addGroupBy('post.id')
+            .orderBy('sharedTagCount', 'DESC')
+            .addOrderBy('post.publishedAt', 'DESC')
+            .addOrderBy('post.id', 'DESC')
+            .limit(limit)
+            .getRawMany();
+        signal?.throwIfAborted();
+        const ids = ranked.map(({ postId: id }) => id);
+        if (!ids.length)
+            return [];
+        const posts = await this.dataSource.getRepository(BlogPostEntity).findBy({ id: In(ids) });
+        signal?.throwIfAborted();
+        const byId = new Map(posts.map((post) => [post.id, post]));
+        return this.withTags(ids.flatMap((id) => byId.get(id) ? [byId.get(id)] : []), this.dataSource.manager, signal);
+    }
+}
+function parsePostCount(value) {
+    const count = Number(value);
+    if (!Number.isSafeInteger(count) || count < 0)
+        throw new Error('Published post count is invalid');
+    return count;
+}
+function assertPublishableContent(input) {
+    const report = auditPostContent(input);
+    if (report.publishable)
+        return;
+    throw new PostContentBlockedError(report);
+}
+function escapeLikePattern(value) {
+    return value.replace(/[\\%_]/g, (character) => `\\${character}`);
+}
+function archivePublishedAtRange(options) {
+    const isRange = options.startYear !== undefined && options.startMonth !== undefined
+        && options.endYear !== undefined && options.endMonth !== undefined;
+    if (!isRange && options.year === undefined)
+        return undefined;
+    const startYear = isRange ? options.startYear : options.year;
+    const startMonth = isRange ? options.startMonth - 1 : options.month === undefined ? 0 : options.month - 1;
+    const selectedEndYear = isRange ? options.endYear : options.year;
+    const selectedEndMonth = isRange ? options.endMonth : options.month;
+    const endYear = selectedEndMonth === undefined || selectedEndMonth === 12
+        ? selectedEndYear + 1
+        : selectedEndYear;
+    const endMonth = selectedEndMonth === undefined || selectedEndMonth === 12 ? 0 : selectedEndMonth;
+    return And(MoreThanOrEqual(new Date(Date.UTC(startYear, startMonth, 1))), LessThan(new Date(Date.UTC(endYear, endMonth, 1))));
+}
+function aggregateArchiveMonths(posts, limit) {
+    const counts = new Map();
+    for (const post of posts) {
+        if (!post.publishedAt)
+            throw new BlogConflictError('Published post archive timestamp is incomplete');
+        const year = post.publishedAt.getUTCFullYear();
+        const month = post.publishedAt.getUTCMonth() + 1;
+        const key = `${year}-${month}`;
+        const current = counts.get(key);
+        counts.set(key, { year, month, count: (current?.count ?? 0) + 1 });
+    }
+    return [...counts.values()].slice(0, limit);
+}
+function withoutTagIds(input) {
+    const { tagIds: _tagIds, ...post } = input;
+    return post;
+}
+//# sourceMappingURL=post-store.js.map