@atproto/ozone 0.1.68 → 0.1.70

package/dist/util.js

@@ -1,6 +1,13 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatLabelerHeader = exports.defaultLabelerHeader = exports.parseLabelerHeader = exports.LABELER_HEADER_NAME = exports.retryHttp = exports.RETRYABLE_HTTP_STATUS_CODES = exports.getSigningKeyId = void 0;
+exports.startInterval = startInterval;
+exports.isCausedBySignal = isCausedBySignal;
+exports.boundAbortController = boundAbortController;
+const node_assert_1 = __importDefault(require("node:assert"));
 const common_1 = require("@atproto/common");
 const xrpc_1 = require("@atproto/xrpc");
 const structured_headers_1 = require("structured-headers");
@@ -71,4 +78,129 @@ const formatLabelerHeader = (parsed) => {
     return parts.join(',');
 };
 exports.formatLabelerHeader = formatLabelerHeader;
+/**
+ * Utility function similar to `setInterval()`. The main difference is that the
+ * execution is controlled through a signal and that the function will wait for
+ * `interval` milliseconds *between* the end of the previous execution and the
+ * start of the next one (instead of starting the execution every `interval`
+ * milliseconds), ensuring that the function is not running concurrently.
+ *
+ * @param fn The function to execute. That function must not throw any error
+ * other than {@link signal}'s {@link AbortSignal.reason} or an {@link Error}
+ * that has the {@link signal}'s {@link AbortSignal.reason} as its
+ * {@link Error.cause}.
+ *
+ * @returns A promise that resolves when the signal is aborted, and the last
+ * execution is done.
+ *
+ * @throws {AbortSignal['reason']} if the {@link signal} is already aborted.
+ * @throws {TypeError} if {@link fn} throws an unexpected error (with the
+ * unexpected error as the {@link Error.cause}).
+ */
+async function startInterval(fn, interval, signal, runImmediately = false) {
+    signal.throwIfAborted();
+    // Renaming for clarity
+    const inputSignal = signal;
+    const intervalController = new AbortController();
+    const intervalSignal = intervalController.signal;
+    return new Promise((resolve, reject) => {
+        let timer;
+        const run = async () => {
+            // Cloning the signal for this particular run to prevent memory leaks
+            const runController = boundAbortController(intervalSignal);
+            const runSignal = runController.signal;
+            try {
+                await fn(runSignal);
+            }
+            catch (err) {
+                if (err != null && isCausedBySignal(err, runSignal)) {
+                    // Silently ignore the error if it is caused by the signal. At this
+                    // point, the interval controller was aborted, which will cause the
+                    // promise to resolve in the "finally" block bellow.
+                }
+                else {
+                    // Invalid behavior: stop the interval and reject the promise.
+                    const error = new TypeError('Unexpected error', { cause: err });
+                    // Rejecting here will make `resolve()` in the "finally" block to be a
+                    // no-op. Rejecting before aborting the controller to ensure the
+                    // promise does not get resolved by the `abort` event listeners.
+                    reject(error);
+                    // Using `error` as abort reason to avoid creating an AbortError.
+                    intervalController.abort(error);
+                }
+            }
+            finally {
+                // Cleanup the listeners added by `boundAbortController`
+                runController.abort();
+                if (intervalSignal.aborted)
+                    resolve();
+                else
+                    schedule();
+            }
+        };
+        const schedule = () => {
+            (0, node_assert_1.default)(timer === undefined, 'unexpected state');
+            timer = setTimeout(() => {
+                timer = undefined; // "running" state
+                void run();
+            }, interval);
+        };
+        inputSignal.addEventListener('abort', 
+        // This function will only be called if the `inputSignal` is aborted
+        // before the interval controller is aborted.
+        () => {
+            // Stop the interval, using the input signal's reason
+            intervalController.abort(inputSignal.reason);
+            if (timer === undefined) {
+                // `fn` is currently running; `run`'s finally block will resolve the
+                // promise.
+            }
+            else {
+                // The execution was scheduled but not started yet. Clear the timer
+                // and resolve the promise.
+                clearTimeout(timer);
+                resolve();
+            }
+        }, 
+        // Remove the listener whenever the interval is aborted.
+        { signal: intervalSignal });
+        if (runImmediately)
+            void run();
+        else
+            schedule();
+    });
+}
+/**
+ * Determines whether the cause of an error is a signal's reason
+ */
+function isCausedBySignal(err, signal) {
+    if (!signal.aborted)
+        return false;
+    if (signal.reason == null)
+        return false; // Ignore nullish reasons
+    return (err === signal.reason ||
+        (err instanceof Error && err.cause === signal.reason));
+}
+/**
+ * Creates an AbortController that will be aborted when any of the given signals
+ * is aborted.
+ *
+ * @note Make sure to call `abortController.abort()` when you are done with
+ * the controller to avoid memory leaks.
+ *
+ * @throws if any of the input signals is already aborted.
+ */
+function boundAbortController(...signals) {
+    for (const signal of signals) {
+        signal?.throwIfAborted();
+    }
+    const abortController = new AbortController();
+    const abort = function (event) {
+        abortController.abort(event.target?.reason);
+    };
+    for (const signal of signals) {
+        signal?.addEventListener('abort', abort, { signal: abortController.signal });
+    }
+    return abortController;
+}
 //# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/ozone",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "license": "MIT",
   "description": "Backend service for moderating the Bluesky network.",
   "keywords": [
@@ -32,7 +32,7 @@
     "typed-emitter": "^2.1.0",
     "uint8arrays": "3.0.0",
     "undici": "^6.14.1",
-    "@atproto/api": "^0.13.27",
+    "@atproto/api": "^0.13.29",
     "@atproto/common": "^0.4.6",
     "@atproto/crypto": "^0.4.3",
     "@atproto/identity": "^0.4.5",
@@ -52,7 +52,7 @@
     "ts-node": "^10.8.2",
     "typescript": "^5.6.3",
     "@atproto/lex-cli": "^0.5.5",
-    "@atproto/pds": "^0.4.85"
+    "@atproto/pds": "^0.4.87"
   },
   "scripts": {
     "codegen": "lex gen-server --yes ./src/lexicon ../../lexicons/com/atproto/*/* ../../lexicons/app/bsky/*/* ../../lexicons/chat/bsky/*/* ../../lexicons/tools/ozone/*/*",

package/src/api/moderation/queryStatuses.ts

@@ -1,75 +1,13 @@
 import { Server } from '../../lexicon'
 import AppContext from '../../context'
-import { getReviewState } from '../util'
 
 export default function (server: Server, ctx: AppContext) {
   server.tools.ozone.moderation.queryStatuses({
     auth: ctx.authVerifier.modOrAdminToken,
     handler: async ({ params }) => {
-      const {
-        includeAllUserRecords,
-        subject,
-        takendown,
-        appealed,
-        reviewState,
-        reviewedAfter,
-        reviewedBefore,
-        reportedAfter,
-        reportedBefore,
-        ignoreSubjects,
-        lastReviewedBy,
-        hostingDeletedBefore,
-        hostingDeletedAfter,
-        hostingUpdatedBefore,
-        hostingUpdatedAfter,
-        hostingStatuses,
-        sortDirection = 'desc',
-        sortField = 'lastReportedAt',
-        includeMuted = false,
-        onlyMuted = false,
-        limit = 50,
-        cursor,
-        tags = [],
-        excludeTags = [],
-        collections = [],
-        subjectType,
-        queueCount,
-        queueIndex,
-        queueSeed,
-      } = params
       const db = ctx.db
       const modService = ctx.modService(db)
-      const results = await modService.getSubjectStatuses({
-        reviewState: getReviewState(reviewState),
-        includeAllUserRecords,
-        subject,
-        takendown,
-        appealed,
-        reviewedAfter,
-        reviewedBefore,
-        reportedAfter,
-        reportedBefore,
-        includeMuted,
-        hostingDeletedBefore,
-        hostingDeletedAfter,
-        hostingUpdatedBefore,
-        hostingUpdatedAfter,
-        hostingStatuses,
-        onlyMuted,
-        ignoreSubjects,
-        sortDirection,
-        lastReviewedBy,
-        sortField,
-        limit,
-        cursor,
-        tags,
-        excludeTags,
-        collections,
-        subjectType,
-        queueCount,
-        queueIndex,
-        queueSeed,
-      })
+      const results = await modService.getSubjectStatuses(params)
       const subjectStatuses = results.statuses.map((status) =>
         modService.views.formatSubjectStatus(status),
       )

package/src/background.ts

@@ -1,35 +1,161 @@
 import PQueue from 'p-queue'
 import { Database } from './db'
 import { dbLogger } from './logger'
+import { boundAbortController, isCausedBySignal, startInterval } from './util'
 
-// A simple queue for in-process, out-of-band/backgrounded work
+type Task = (db: Database, signal: AbortSignal) => Promise<void>
 
+/**
+ * A simple queue for in-process, out-of-band/backgrounded work
+ */
 export class BackgroundQueue {
-  queue = new PQueue({ concurrency: 20 })
-  destroyed = false
-  constructor(public db: Database) {}
+  private abortController = new AbortController()
+  private queue = new PQueue({ concurrency: 20 })
 
-  add(task: Task) {
+  public get signal() {
+    return this.abortController.signal
+  }
+
+  public get destroyed() {
+    return this.signal.aborted
+  }
+
+  constructor(protected db: Database) {}
+
+  getStats() {
+    return {
+      runningCount: this.queue.pending,
+      waitingCount: this.queue.size,
+    }
+  }
+
+  /**
+   * Add a task that will be executed at some point in the future.
+   *
+   * The task will be executed even if the backgroundQueue is destroyed, unless
+   * the provided `signal` is aborted.
+   *
+   * The `signal` provided to the task will be aborted whenever either the
+   * backgroundQueue is destroyed or the provided `signal` is aborted.
+   */
+  async add(task: Task, signal?: AbortSignal): Promise<void> {
     if (this.destroyed) {
       return
     }
-    this.queue
-      .add(() => task(this.db))
-      .catch((err) => {
-        dbLogger.error(err, 'background queue task failed')
-      })
+
+    const abortController = boundAbortController(this.signal, signal)
+
+    return this.queue.add<void>(async () => {
+      try {
+        // Do not run the task if the signal provided to the task has become
+        // aborted. Do not use `abortController.signal` here since we do not
+        // want to abort the task if the backgroundQueue is being destroyed.
+        if (signal?.aborted) return
+
+        // The task will receive a "combined signal" allowing it to abort if
+        // either the backgroundQueue is destroyed or the provided signal is
+        // aborted.
+        await task(this.db, abortController.signal)
+      } catch (err) {
+        if (!isCausedBySignal(err, abortController.signal)) {
+          dbLogger.error(err, 'background queue task failed')
+        }
+      } finally {
+        abortController.abort()
+      }
+    })
   }
 
   async processAll() {
     await this.queue.onIdle()
   }
 
-  // On destroy we stop accepting new tasks, but complete all pending/in-progress tasks.
-  // The application calls this only once http connections have drained (tasks no longer being added).
+  /**
+   * On destroy we stop accepting new tasks, but complete all
+   * pending/in-progress tasks. Tasks can decide to abort their current
+   * operation based on the signal they received. The application calls this
+   * only once http connections have drained (tasks no longer being added).
+   */
   async destroy() {
-    this.destroyed = true
+    this.abortController.abort()
     await this.queue.onIdle()
   }
 }
 
-type Task = (db: Database) => Promise<void>
+/**
+ * A simple periodic background task runner. This class will schedule a task to
+ * run through a provided {@link BackgroundQueue} at a fixed interval. The task
+ * will never run more than once concurrently, and will wait at least `interval`
+ * milliseconds between the end of one run and the start of the next.
+ */
+export class PeriodicBackgroundTask {
+  private abortController: AbortController
+
+  private intervalPromise?: Promise<void>
+  private runningPromise?: Promise<void>
+
+  public get signal() {
+    return this.abortController.signal
+  }
+
+  public get destroyed() {
+    return this.signal.aborted
+  }
+
+  constructor(
+    protected backgroundQueue: BackgroundQueue,
+    protected interval: number,
+    protected task: Task,
+  ) {
+    if (!Number.isFinite(interval) || interval <= 0) {
+      throw new TypeError('interval must be a positive number')
+    }
+
+    // Bind this class's signal to the backgroundQueue's signal (destroying this
+    // instance if the backgroundQueue is destroyed)
+    this.abortController = boundAbortController(backgroundQueue.signal)
+  }
+
+  public run(signal?: AbortSignal): Promise<void> {
+    // `startInterval` already ensures that only one run is in progress at a
+    // time. However, we want to be able to expose a `run()` method that can be
+    // used to force a run, which could cause concurrent executions. We prevent
+    // this using the `runningPromise` property.
+
+    if (this.runningPromise) return this.runningPromise
+
+    // Combine the `this.signal` with the provided `signal`, if any.
+    const abortController = boundAbortController(this.signal, signal)
+
+    const promise = this.backgroundQueue.add(this.task, abortController.signal)
+
+    return (this.runningPromise = promise).finally(() => {
+      if (this.runningPromise === promise) this.runningPromise = undefined
+
+      // Cleanup the listeners added by `boundAbortController`
+      abortController.abort()
+    })
+  }
+
+  public start() {
+    // Noop if already started. Throws if this.signal is aborted (instance is
+    // destroyed).
+    this.intervalPromise ||= startInterval(
+      async (signal) => this.run(signal),
+      this.interval,
+      this.signal,
+    )
+  }
+
+  public async destroy() {
+    // @NOTE This instance does not "own" the backgroundQueue, so we do not
+    // destroy it here.
+
+    this.abortController.abort()
+    console.error('ABOOOORT')
+
+    await this.intervalPromise
+    this.intervalPromise = undefined
+    console.error('DONE -_-')
+  }
+}

package/src/config/config.ts

@@ -24,6 +24,7 @@ export const envToCfg = (env: OzoneEnvironment): OzoneConfig => {
     poolSize: env.dbPoolSize,
     poolMaxUses: env.dbPoolMaxUses,
     poolIdleTimeoutMs: env.dbPoolIdleTimeoutMs,
+    materializedViewRefreshIntervalMs: env.dbMaterializedViewRefreshIntervalMs,
   }
 
   assert(env.appviewUrl, 'appviewUrl is required')
@@ -122,6 +123,7 @@ export type DatabaseConfig = {
   poolSize?: number
   poolMaxUses?: number
   poolIdleTimeoutMs?: number
+  materializedViewRefreshIntervalMs?: number
 }
 
 export type AppviewConfig = {

package/src/config/env.ts

@@ -20,6 +20,9 @@ export const readEnv = (): OzoneEnvironment => {
     dbPoolSize: envInt('OZONE_DB_POOL_SIZE'),
     dbPoolMaxUses: envInt('OZONE_DB_POOL_MAX_USES'),
     dbPoolIdleTimeoutMs: envInt('OZONE_DB_POOL_IDLE_TIMEOUT_MS'),
+    dbMaterializedViewRefreshIntervalMs: envInt(
+      'OZONE_DB_MATERIALIZED_VIEW_REFRESH_INTERVAL_MS',
+    ),
     didPlcUrl: envStr('OZONE_DID_PLC_URL'),
     didCacheStaleTTL: envInt('OZONE_DID_CACHE_STALE_TTL'),
     didCacheMaxTTL: envInt('OZONE_DID_CACHE_MAX_TTL'),
@@ -53,6 +56,7 @@ export type OzoneEnvironment = {
   dbPoolSize?: number
   dbPoolMaxUses?: number
   dbPoolIdleTimeoutMs?: number
+  dbMaterializedViewRefreshIntervalMs?: number
   didPlcUrl?: string
   didCacheStaleTTL?: number
   didCacheMaxTTL?: number

package/src/daemon/context.ts

@@ -6,17 +6,20 @@ import { OzoneConfig, OzoneSecrets } from '../config'
 import { Database } from '../db'
 import { EventPusher } from './event-pusher'
 import { EventReverser } from './event-reverser'
-import { ModerationService, ModerationServiceCreator } from '../mod-service'
+import { ModerationService } from '../mod-service'
 import { BackgroundQueue } from '../background'
 import { getSigningKeyId } from '../util'
+import { MaterializedViewRefresher } from './materialized-view-refresher'
+import { allFulfilled } from '@atproto/common'
 
 export type DaemonContextOptions = {
   db: Database
   cfg: OzoneConfig
-  modService: ModerationServiceCreator
+  backgroundQueue: BackgroundQueue
   signingKey: Keypair
   eventPusher: EventPusher
   eventReverser: EventReverser
+  materializedViewRefresher: MaterializedViewRefresher
 }
 
 export class DaemonContext {
@@ -67,13 +70,19 @@ export class DaemonContext {
 
     const eventReverser = new EventReverser(db, modService)
 
+    const materializedViewRefresher = new MaterializedViewRefresher(
+      backgroundQueue,
+      cfg.db.materializedViewRefreshIntervalMs,
+    )
+
     return new DaemonContext({
       db,
       cfg,
-      modService,
+      backgroundQueue,
       signingKey,
       eventPusher,
       eventReverser,
+      materializedViewRefresher,
       ...(overrides ?? {}),
     })
   }
@@ -86,8 +95,8 @@ export class DaemonContext {
     return this.opts.cfg
   }
 
-  get modService(): ModerationServiceCreator {
-    return this.opts.modService
+  get backgroundQueue(): BackgroundQueue {
+    return this.opts.backgroundQueue
   }
 
   get eventPusher(): EventPusher {
@@ -97,6 +106,35 @@ export class DaemonContext {
   get eventReverser(): EventReverser {
     return this.opts.eventReverser
   }
+
+  get materializedViewRefresher(): MaterializedViewRefresher {
+    return this.opts.materializedViewRefresher
+  }
+
+  async start() {
+    this.eventPusher.start()
+    this.eventReverser.start()
+    this.materializedViewRefresher.start()
+  }
+
+  async processAll() {
+    // Sequential because the materialized view values depend on the events.
+    await this.eventPusher.processAll()
+    await this.materializedViewRefresher.run()
+  }
+
+  async destroy() {
+    try {
+      await allFulfilled([
+        this.eventReverser.destroy(),
+        this.eventPusher.destroy(),
+        this.materializedViewRefresher.destroy(),
+      ])
+    } finally {
+      await this.backgroundQueue.destroy()
+      await this.db.close()
+    }
+  }
 }
 
 export default DaemonContext

package/src/daemon/index.ts

@@ -18,17 +18,14 @@ export class OzoneDaemon {
   }
 
   async start() {
-    this.ctx.eventPusher.start()
-    this.ctx.eventReverser.start()
+    await this.ctx.start()
   }
 
   async processAll() {
-    await this.ctx.eventPusher.processAll()
+    await this.ctx.processAll()
   }
 
   async destroy() {
-    await this.ctx.eventReverser.destroy()
-    await this.ctx.eventPusher.destroy()
-    await this.ctx.db.close()
+    await this.ctx.destroy()
   }
 }

package/src/daemon/materialized-view-refresher.ts

@@ -0,0 +1,27 @@
+import { MINUTE } from '@atproto/common'
+import { sql } from 'kysely'
+import { BackgroundQueue, PeriodicBackgroundTask } from '../background'
+
+export class MaterializedViewRefresher extends PeriodicBackgroundTask {
+  constructor(backgroundQueue: BackgroundQueue, interval = 30 * MINUTE) {
+    super(backgroundQueue, interval, async ({ db }, signal) => {
+      for (const view of [
+        'account_events_stats',
+        'record_events_stats',
+        'account_record_events_stats',
+        'account_record_status_stats',
+      ]) {
+        if (signal.aborted) break
+
+        // Kysely does not provide a way to cancel a running query. Because of
+        // this, killing the process during a refresh will cause the process to
+        // wait for the current refresh to finish before exiting. This is not
+        // ideal, but it is the best we can do until Kysely provides a way to
+        // cancel a query.
+        await sql`REFRESH MATERIALIZED VIEW CONCURRENTLY ${sql.id(view)}`.execute(
+          db,
+        )
+      }
+    })
+  }
+}