@commonpub/server 2.45.0 → 2.45.1

package/dist/publicApi/index.d.ts

@@ -8,6 +8,8 @@ export { authenticateApiKey } from './auth.js';
 export type { AuthResult, AuthSuccess, AuthRejected, AuthFailure } from './auth.js';
 export { createApiKey, listApiKeys, revokeApiKey, getApiKeyById, logApiKeyUsage, touchLastUsed, } from './adminOps.js';
 export type { CreateApiKeyResult } from './adminOps.js';
+export { getApiKeyUsageStats } from './usage.js';
+export type { ApiKeyUsageStats } from './usage.js';
 export { toPublicUser, isPublicUser, toPublicContentSummary, toPublicContentDetail, isPublicContent, toPublicHub, isPublicHub, toAdminApiKeyView, toPublicLearningPath, isPublicLearningPath, toPublicEvent, isPublicEvent, toPublicContest, isPublicContest, toPublicVideo, isPublicVideo, toPublicDocSite, isPublicDocSite, toPublicTag, } from './serializers.js';
 export type { PublicUser, PublicUserRow, PublicContentSummary, PublicContentDetail, PublicContentRow, PublicHub, PublicHubRow, PublicInstance, AdminApiKeyView, PublicLearningPath, PublicLearningPathRow, PublicEvent, PublicEventRow, PublicContest, PublicContestRow, PublicVideo, PublicVideoRow, PublicDocSite, PublicDocSiteRow, PublicTag, PublicTagRow, } from './serializers.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publicApi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publicApi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,kBAAkB,CAAC"}

package/dist/publicApi/index.js

@@ -3,5 +3,6 @@ export { generateApiKey, hashApiKey, compareKeyHash, extractPrefix } from './key
 export { apiKeyRateLimit, ApiKeyRateLimit } from './rateLimit.js';
 export { authenticateApiKey } from './auth.js';
 export { createApiKey, listApiKeys, revokeApiKey, getApiKeyById, logApiKeyUsage, touchLastUsed, } from './adminOps.js';
+export { getApiKeyUsageStats } from './usage.js';
 export { toPublicUser, isPublicUser, toPublicContentSummary, toPublicContentDetail, isPublicContent, toPublicHub, isPublicHub, toAdminApiKeyView, toPublicLearningPath, isPublicLearningPath, toPublicEvent, isPublicEvent, toPublicContest, isPublicContest, toPublicVideo, isPublicVideo, toPublicDocSite, isPublicDocSite, toPublicTag, } from './serializers.js';
 //# sourceMappingURL=index.js.map

package/dist/publicApi/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publicApi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publicApi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/publicApi/usage.d.ts

@@ -0,0 +1,26 @@
+import type { DB } from '../types.js';
+export interface ApiKeyUsageStats {
+    windowDays: number;
+    totalRequests: number;
+    errorCount: number;
+    errorRate: number;
+    /** Array of { day: 'YYYY-MM-DD', count: number }, newest first. */
+    requestsByDay: Array<{
+        day: string;
+        count: number;
+    }>;
+    /** Top endpoints by request count within the window. */
+    topEndpoints: Array<{
+        endpoint: string;
+        count: number;
+        p95LatencyMs: number | null;
+    }>;
+}
+/**
+ * Per-key usage analytics for the admin dashboard. Narrow, indexed queries
+ * only — no full-table scans. Uses `count(*) FILTER (WHERE ...)` conditional
+ * aggregation so the totals, error counts, and day buckets come from a
+ * single round-trip where possible.
+ */
+export declare function getApiKeyUsageStats(db: DB, keyId: string, windowDays?: number): Promise<ApiKeyUsageStats>;
+//# sourceMappingURL=usage.d.ts.map

package/dist/publicApi/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/publicApi/usage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,aAAa,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,wDAAwD;IACxD,YAAY,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACvF;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,MAAM,EACb,UAAU,SAAI,GACb,OAAO,CAAC,gBAAgB,CAAC,CAiD3B"}

package/dist/publicApi/usage.js

@@ -0,0 +1,56 @@
+import { apiKeyUsage } from '@commonpub/schema';
+import { and, desc, eq, gte, sql } from 'drizzle-orm';
+/**
+ * Per-key usage analytics for the admin dashboard. Narrow, indexed queries
+ * only — no full-table scans. Uses `count(*) FILTER (WHERE ...)` conditional
+ * aggregation so the totals, error counts, and day buckets come from a
+ * single round-trip where possible.
+ */
+export async function getApiKeyUsageStats(db, keyId, windowDays = 7) {
+    const since = new Date(Date.now() - windowDays * 86400_000);
+    const base = and(eq(apiKeyUsage.keyId, keyId), gte(apiKeyUsage.timestamp, since));
+    const [[totals], byDay, byEndpoint] = await Promise.all([
+        db
+            .select({
+            totalRequests: sql `count(*)::int`,
+            errorCount: sql `count(*) FILTER (WHERE ${apiKeyUsage.statusCode} >= 400)::int`,
+        })
+            .from(apiKeyUsage)
+            .where(base),
+        db
+            .select({
+            day: sql `to_char(date_trunc('day', ${apiKeyUsage.timestamp}), 'YYYY-MM-DD')`,
+            count: sql `count(*)::int`,
+        })
+            .from(apiKeyUsage)
+            .where(base)
+            .groupBy(sql `date_trunc('day', ${apiKeyUsage.timestamp})`)
+            .orderBy(desc(sql `date_trunc('day', ${apiKeyUsage.timestamp})`)),
+        db
+            .select({
+            endpoint: apiKeyUsage.endpoint,
+            count: sql `count(*)::int`,
+            p95LatencyMs: sql `percentile_cont(0.95) within group (order by ${apiKeyUsage.latencyMs})::int`,
+        })
+            .from(apiKeyUsage)
+            .where(base)
+            .groupBy(apiKeyUsage.endpoint)
+            .orderBy(desc(sql `count(*)`))
+            .limit(10),
+    ]);
+    const totalRequests = totals?.totalRequests ?? 0;
+    const errorCount = totals?.errorCount ?? 0;
+    return {
+        windowDays,
+        totalRequests,
+        errorCount,
+        errorRate: totalRequests > 0 ? errorCount / totalRequests : 0,
+        requestsByDay: byDay.map((r) => ({ day: r.day, count: r.count })),
+        topEndpoints: byEndpoint.map((r) => ({
+            endpoint: r.endpoint,
+            count: r.count,
+            p95LatencyMs: r.p95LatencyMs,
+        })),
+    };
+}
+//# sourceMappingURL=usage.js.map

package/dist/publicApi/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/publicApi/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AActD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAM,EACN,KAAa,EACb,UAAU,GAAG,CAAC;IAEd,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAElF,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtD,EAAE;aACC,MAAM,CAAC;YACN,aAAa,EAAE,GAAG,CAAQ,eAAe;YACzC,UAAU,EAAE,GAAG,CAAQ,0BAA0B,WAAW,CAAC,UAAU,eAAe;SACvF,CAAC;aACD,IAAI,CAAC,WAAW,CAAC;aACjB,KAAK,CAAC,IAAI,CAAC;QACd,EAAE;aACC,MAAM,CAAC;YACN,GAAG,EAAE,GAAG,CAAQ,6BAA6B,WAAW,CAAC,SAAS,kBAAkB;YACpF,KAAK,EAAE,GAAG,CAAQ,eAAe;SAClC,CAAC;aACD,IAAI,CAAC,WAAW,CAAC;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,OAAO,CAAC,GAAG,CAAA,qBAAqB,WAAW,CAAC,SAAS,GAAG,CAAC;aACzD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAA,qBAAqB,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;QAClE,EAAE;aACC,MAAM,CAAC;YACN,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,KAAK,EAAE,GAAG,CAAQ,eAAe;YACjC,YAAY,EAAE,GAAG,CAAe,gDAAgD,WAAW,CAAC,SAAS,QAAQ;SAC9G,CAAC;aACD,IAAI,CAAC,WAAW,CAAC;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;aAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAQ,UAAU,CAAC,CAAC;aACpC,KAAK,CAAC,EAAE,CAAC;KACb,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,CAAC,CAAC;IAE3C,OAAO;QACL,UAAU;QACV,aAAa;QACb,UAAU;QACV,SAAS,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC7D,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonpub/server",
-  "version": "2.45.0",
+  "version": "2.45.1",
   "type": "module",
   "description": "Framework-agnostic business logic for CommonPub instances",
   "license": "AGPL-3.0-or-later",
@@ -109,9 +109,9 @@
     "linkedom": "^0.18.12",
     "turndown": "^7.2.4",
     "@commonpub/config": "0.11.0",
+    "@commonpub/docs": "0.6.2",
     "@commonpub/editor": "0.7.9",
     "@commonpub/infra": "0.5.1",
-    "@commonpub/docs": "0.6.2",
     "@commonpub/learning": "0.5.0",
     "@commonpub/protocol": "0.9.9",
     "@commonpub/auth": "0.5.1"