@commonpub/server 0.1.0

package/dist/profile/profile.js

@@ -0,0 +1,122 @@
+import { eq, and, sql, isNull } from 'drizzle-orm';
+import { contentItems, users, follows } from '@commonpub/schema';
+import { listContent } from '../content/content.js';
+export async function getUserByUsername(db, username) {
+    const rows = await db
+        .select()
+        .from(users)
+        .where(and(eq(users.username, username), isNull(users.deletedAt)))
+        .limit(1);
+    if (rows.length === 0)
+        return null;
+    const user = rows[0];
+    // Get content counts by type + aggregated view/like counts
+    const [contentCounts, viewLikeResult, followerResult, followingResult] = await Promise.all([
+        db
+            .select({
+            type: contentItems.type,
+            count: sql `count(*)::int`,
+        })
+            .from(contentItems)
+            .where(and(eq(contentItems.authorId, user.id), eq(contentItems.status, 'published')))
+            .groupBy(contentItems.type),
+        db
+            .select({
+            totalViews: sql `coalesce(sum(${contentItems.viewCount}), 0)::int`,
+            totalLikes: sql `coalesce(sum(${contentItems.likeCount}), 0)::int`,
+        })
+            .from(contentItems)
+            .where(and(eq(contentItems.authorId, user.id), eq(contentItems.status, 'published'))),
+        db
+            .select({ count: sql `count(*)::int` })
+            .from(follows)
+            .where(eq(follows.followingId, user.id)),
+        db
+            .select({ count: sql `count(*)::int` })
+            .from(follows)
+            .where(eq(follows.followerId, user.id)),
+    ]);
+    const countMap = {};
+    for (const row of contentCounts) {
+        countMap[row.type] = row.count;
+    }
+    const followerCount = followerResult[0]?.count ?? 0;
+    const followingCount = followingResult[0]?.count ?? 0;
+    const socialLinks = user.socialLinks ?? null;
+    return {
+        id: user.id,
+        username: user.username,
+        displayName: user.displayName,
+        avatarUrl: user.avatarUrl,
+        bio: user.bio ?? null,
+        headline: user.headline ?? null,
+        location: user.location ?? null,
+        website: user.website ?? null,
+        bannerUrl: user.bannerUrl ?? null,
+        socialLinks,
+        skills: user.skills ?? null,
+        pronouns: user.pronouns ?? null,
+        createdAt: user.createdAt,
+        followerCount,
+        followingCount,
+        viewCount: viewLikeResult[0]?.totalViews ?? 0,
+        likeCount: viewLikeResult[0]?.totalLikes ?? 0,
+        stats: {
+            projects: countMap['project'] ?? 0,
+            explainers: countMap['explainer'] ?? 0,
+            articles: countMap['article'] ?? 0,
+            followers: followerCount,
+            following: followingCount,
+        },
+    };
+}
+export async function updateUserProfile(db, userId, input) {
+    const existing = await db
+        .select({ id: users.id })
+        .from(users)
+        .where(eq(users.id, userId))
+        .limit(1);
+    if (existing.length === 0)
+        return null;
+    const updates = { updatedAt: new Date() };
+    if (input.displayName !== undefined)
+        updates.displayName = input.displayName;
+    if (input.bio !== undefined)
+        updates.bio = input.bio;
+    if (input.headline !== undefined)
+        updates.headline = input.headline;
+    if (input.location !== undefined)
+        updates.location = input.location;
+    if (input.website !== undefined)
+        updates.website = input.website;
+    if (input.avatarUrl !== undefined)
+        updates.avatarUrl = input.avatarUrl;
+    if (input.bannerUrl !== undefined)
+        updates.bannerUrl = input.bannerUrl;
+    if (input.socialLinks !== undefined)
+        updates.socialLinks = input.socialLinks;
+    if (input.skills !== undefined)
+        updates.skills = input.skills;
+    if (input.pronouns !== undefined)
+        updates.pronouns = input.pronouns;
+    if (input.timezone !== undefined)
+        updates.timezone = input.timezone;
+    if (input.emailNotifications !== undefined)
+        updates.emailNotifications = input.emailNotifications;
+    await db.update(users).set(updates).where(eq(users.id, userId));
+    const user = await db
+        .select({ username: users.username })
+        .from(users)
+        .where(eq(users.id, userId))
+        .limit(1);
+    return getUserByUsername(db, user[0].username);
+}
+export async function getUserContent(db, userId, type) {
+    return listContent(db, {
+        authorId: userId,
+        status: 'published',
+        type,
+        limit: 20,
+    });
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile/profile.js.map

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

package/dist/query.d.ts

@@ -0,0 +1,331 @@
+/**
+ * Generic query helpers to eliminate duplication across domain modules.
+ *
+ * - ensureUniqueSlugFor: replaces 5 copy-pasted slug uniqueness functions
+ * - USER_REF_SELECT: replaces 20+ inline user select shapes
+ * - normalizePagination / countRows: replaces identical pagination boilerplate in 15+ list functions
+ * - buildPartialUpdates: replaces identical update-builder blocks in 12+ update functions
+ */
+import type { PgTable, PgColumn } from 'drizzle-orm/pg-core';
+import type { SQL } from 'drizzle-orm';
+import type { DB } from './types.js';
+/** Standard user reference select shape. Use in Drizzle .select() calls. */
+export declare const USER_REF_SELECT: {
+    readonly id: PgColumn<{
+        name: "id";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgUUID";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    readonly username: PgColumn<{
+        name: "username";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 64;
+    }>;
+    readonly displayName: PgColumn<{
+        name: "display_name";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 128;
+    }>;
+    readonly avatarUrl: PgColumn<{
+        name: "avatar_url";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+};
+/** Extended user ref with bio (for content detail author, follow lists) */
+export declare const USER_REF_WITH_BIO_SELECT: {
+    readonly bio: PgColumn<{
+        name: "bio";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    readonly id: PgColumn<{
+        name: "id";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgUUID";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    readonly username: PgColumn<{
+        name: "username";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 64;
+    }>;
+    readonly displayName: PgColumn<{
+        name: "display_name";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 128;
+    }>;
+    readonly avatarUrl: PgColumn<{
+        name: "avatar_url";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+};
+/** Extended user ref with headline (for content detail) */
+export declare const USER_REF_WITH_HEADLINE_SELECT: {
+    readonly bio: PgColumn<{
+        name: "bio";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    readonly headline: PgColumn<{
+        name: "headline";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 255;
+    }>;
+    readonly id: PgColumn<{
+        name: "id";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgUUID";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    readonly username: PgColumn<{
+        name: "username";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 64;
+    }>;
+    readonly displayName: PgColumn<{
+        name: "display_name";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgVarchar";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: 128;
+    }>;
+    readonly avatarUrl: PgColumn<{
+        name: "avatar_url";
+        tableName: "users";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+};
+/**
+ * Ensure a slug is unique for a given table. Appends a timestamp suffix if a collision is found.
+ *
+ * Replaces 5 identical copy-pasted functions (ensureUniqueSlug, ensureUniqueHubSlug,
+ * ensureUniqueProductSlug, ensureUniqueDocsSiteSlug, ensureUniquePathSlug).
+ *
+ * @param db - Drizzle database instance
+ * @param table - The Drizzle table to check against
+ * @param slugCol - The slug column reference (e.g. contentItems.slug)
+ * @param idCol - The id column reference (e.g. contentItems.id)
+ * @param slug - The desired slug
+ * @param fallbackPrefix - Prefix for auto-generated slugs when input is empty (e.g. 'untitled', 'hub', 'product')
+ * @param excludeId - Optional ID to exclude from the uniqueness check (for updates)
+ */
+export declare function ensureUniqueSlugFor(db: DB, table: PgTable, slugCol: PgColumn, idCol: PgColumn, slug: string, fallbackPrefix: string, excludeId?: string): Promise<string>;
+/** Pagination filter shape (matches the common pattern across all list functions) */
+export interface PaginationOpts {
+    limit?: number;
+    offset?: number;
+}
+/** Normalize pagination options to safe values */
+export declare function normalizePagination(opts: PaginationOpts): {
+    limit: number;
+    offset: number;
+};
+/**
+ * Execute a count query. Returns 0 if no results.
+ * Replaces the identical `db.select({ count: sql\`count(*)::int\` }).from(table).where(where)` pattern.
+ */
+export declare function countRows(db: DB, table: PgTable, where?: SQL): Promise<number>;
+/** Escape LIKE/ILIKE wildcard characters in a search term */
+export declare function escapeLike(term: string): string;
+/**
+ * Build a partial update object from input, filtering out undefined values.
+ * Always includes `updatedAt: new Date()`.
+ *
+ * @param input - The input object (from validated request body)
+ * @param fieldMap - Optional mapping from input keys to DB column names
+ *                   e.g. { durationMinutes: 'duration' }
+ */
+export declare function buildPartialUpdates<TInput extends Record<string, unknown>>(input: TInput, fieldMap?: Partial<Record<keyof TInput & string, string>>): Record<string, unknown>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAIrC,4EAA4E;AAC5E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAG3B,CAAC;AAEX,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIhC,CAAC;AAIX;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAID,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAK3F;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,MAAM,CAAC,CAMjB;AAID,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,GACxD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/query.js

@@ -0,0 +1,103 @@
+/**
+ * Generic query helpers to eliminate duplication across domain modules.
+ *
+ * - ensureUniqueSlugFor: replaces 5 copy-pasted slug uniqueness functions
+ * - USER_REF_SELECT: replaces 20+ inline user select shapes
+ * - normalizePagination / countRows: replaces identical pagination boilerplate in 15+ list functions
+ * - buildPartialUpdates: replaces identical update-builder blocks in 12+ update functions
+ */
+import { eq, and, ne, sql } from 'drizzle-orm';
+import { users } from '@commonpub/schema';
+// ---- USER_REF_SELECT ----
+/** Standard user reference select shape. Use in Drizzle .select() calls. */
+export const USER_REF_SELECT = {
+    id: users.id,
+    username: users.username,
+    displayName: users.displayName,
+    avatarUrl: users.avatarUrl,
+};
+/** Extended user ref with bio (for content detail author, follow lists) */
+export const USER_REF_WITH_BIO_SELECT = {
+    ...USER_REF_SELECT,
+    bio: users.bio,
+};
+/** Extended user ref with headline (for content detail) */
+export const USER_REF_WITH_HEADLINE_SELECT = {
+    ...USER_REF_SELECT,
+    bio: users.bio,
+    headline: users.headline,
+};
+// ---- ensureUniqueSlugFor ----
+/**
+ * Ensure a slug is unique for a given table. Appends a timestamp suffix if a collision is found.
+ *
+ * Replaces 5 identical copy-pasted functions (ensureUniqueSlug, ensureUniqueHubSlug,
+ * ensureUniqueProductSlug, ensureUniqueDocsSiteSlug, ensureUniquePathSlug).
+ *
+ * @param db - Drizzle database instance
+ * @param table - The Drizzle table to check against
+ * @param slugCol - The slug column reference (e.g. contentItems.slug)
+ * @param idCol - The id column reference (e.g. contentItems.id)
+ * @param slug - The desired slug
+ * @param fallbackPrefix - Prefix for auto-generated slugs when input is empty (e.g. 'untitled', 'hub', 'product')
+ * @param excludeId - Optional ID to exclude from the uniqueness check (for updates)
+ */
+export async function ensureUniqueSlugFor(db, table, slugCol, idCol, slug, fallbackPrefix, excludeId) {
+    if (!slug)
+        slug = `${fallbackPrefix}-${Date.now()}`;
+    const conditions = [eq(slugCol, slug)];
+    if (excludeId) {
+        conditions.push(ne(idCol, excludeId));
+    }
+    const existing = await db
+        .select({ id: idCol })
+        .from(table)
+        .where(and(...conditions))
+        .limit(1);
+    if (existing.length === 0)
+        return slug;
+    return `${slug}-${Date.now()}`;
+}
+/** Normalize pagination options to safe values */
+export function normalizePagination(opts) {
+    return {
+        limit: Math.min(opts.limit ?? 20, 100),
+        offset: opts.offset ?? 0,
+    };
+}
+/**
+ * Execute a count query. Returns 0 if no results.
+ * Replaces the identical `db.select({ count: sql\`count(*)::int\` }).from(table).where(where)` pattern.
+ */
+export async function countRows(db, table, where) {
+    const result = await db
+        .select({ count: sql `count(*)::int` })
+        .from(table)
+        .where(where);
+    return result[0]?.count ?? 0;
+}
+// ---- LIKE Escape ----
+/** Escape LIKE/ILIKE wildcard characters in a search term */
+export function escapeLike(term) {
+    return term.replace(/[%_\\]/g, '\\$&');
+}
+// ---- Partial Update Builder ----
+/**
+ * Build a partial update object from input, filtering out undefined values.
+ * Always includes `updatedAt: new Date()`.
+ *
+ * @param input - The input object (from validated request body)
+ * @param fieldMap - Optional mapping from input keys to DB column names
+ *                   e.g. { durationMinutes: 'duration' }
+ */
+export function buildPartialUpdates(input, fieldMap) {
+    const updates = { updatedAt: new Date() };
+    for (const [key, value] of Object.entries(input)) {
+        if (value !== undefined) {
+            const dbField = fieldMap?.[key] ?? key;
+            updates[dbField] = value;
+        }
+    }
+    return updates;
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/dist/security.d.ts

@@ -0,0 +1,3 @@
+export { buildCspDirectives, buildCspHeader, getSecurityHeaders, getStaticCacheHeaders, generateNonce, RateLimitStore, DEFAULT_TIERS, getTierForPath, shouldSkipRateLimit, checkRateLimit, } from '@commonpub/infra/security';
+export type { RateLimitTier, RateLimitResult } from '@commonpub/infra/security';
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/security.js

@@ -0,0 +1,3 @@
+// Re-export from @commonpub/infra for backward compatibility
+export { buildCspDirectives, buildCspHeader, getSecurityHeaders, getStaticCacheHeaders, generateNonce, RateLimitStore, DEFAULT_TIERS, getTierForPath, shouldSkipRateLimit, checkRateLimit, } from '@commonpub/infra/security';
+//# sourceMappingURL=security.js.map

package/dist/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,2BAA2B,CAAC"}

package/dist/social/index.d.ts

@@ -0,0 +1,3 @@
+export { toggleLike, isLiked, listComments, createComment, deleteComment, toggleBookmark, onContentLiked, followUser, unfollowUser, isFollowing, listFollowers, listFollowing, createReport, listUserBookmarks, } from './social.js';
+export type { FollowUserItem, BookmarkItem } from './social.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/social/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/social/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/social/index.js

@@ -0,0 +1,2 @@
+export { toggleLike, isLiked, listComments, createComment, deleteComment, toggleBookmark, onContentLiked, followUser, unfollowUser, isFollowing, listFollowers, listFollowing, createReport, listUserBookmarks, } from './social.js';
+//# sourceMappingURL=index.js.map

package/dist/social/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/social/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC"}