feat: version 2 beta

2025-04-25 22:39:47 +00:00
commit 1e58359905
75 changed files with 6899 additions and 0 deletions
--- a/adapters/postgres/providers/relations.ts
+++ b/adapters/postgres/providers/relations.ts
@@ -0,0 +1,140 @@
+import type { Helper } from "postgres";
+
+import type { Relation, RelationPayload, RelationsProvider } from "../../../types/adapter.ts";
+import type { PostgresDatabase } from "../database.ts";
+
+export class PostgresRelationsProvider implements RelationsProvider {
+  constructor(
+    readonly db: PostgresDatabase,
+    readonly schema?: string,
+  ) {}
+
+  get table(): Helper<string, []> {
+    if (this.schema !== undefined) {
+      return this.db.sql(`${this.schema}.relations`);
+    }
+    return this.db.sql("public.relations");
+  }
+
+  /**
+   * Handle incoming relation operations.
+   *
+   * @param relations - List of relation operations to execute.
+   */
+  async handle(relations: Relation[]): Promise<void> {
+    await Promise.all([
+      this.insertMany(relations.filter((relation) => relation.op === "insert")),
+      this.removeMany(relations.filter((relation) => relation.op === "remove")),
+    ]);
+  }
+
+  /**
+   * Add stream to the relations table.
+   *
+   * @param key    - Relational key to add stream to.
+   * @param stream - Stream to add to the key.
+   */
+  async insert(key: string, stream: string): Promise<void> {
+    await this.db.sql`INSERT INTO ${this.table} (key, stream) VALUES (${key}, ${stream}) ON CONFLICT DO NOTHING`.catch((error) => {
+      throw new Error(`EventStore > 'relations.insert' failed with postgres error: ${error.message}`);
+    });
+  }
+
+  /**
+   * Add stream to many relational keys onto the relations table.
+   *
+   * @param relations - Relations to insert.
+   * @param batchSize - Batch size for the insert loop.
+   */
+  async insertMany(relations: RelationPayload[], batchSize: number = 1_000): Promise<void> {
+    await this.db.sql
+      .begin(async (sql) => {
+        for (let i = 0; i < relations.length; i += batchSize) {
+          const values = relations.slice(i, i + batchSize).map(({ key, stream }) => [key, stream]);
+          await sql`INSERT INTO ${this.table} (key, stream) VALUES ${sql(values)} ON CONFLICT DO NOTHING`;
+        }
+      })
+      .catch((error) => {
+        throw new Error(`EventStore > 'relations.insertMany' failed with postgres error: ${error.message}`);
+      });
+  }
+
+  /**
+   * Get a list of event streams registered under the given relational key.
+   *
+   * @param key - Relational key to get event streams for.
+   */
+  async getByKey(key: string): Promise<string[]> {
+    return this.db.sql`SELECT stream FROM ${this.table} WHERE key = ${key}`
+      .then((rows) => rows.map(({ stream }) => stream))
+      .catch((error) => {
+        throw new Error(`EventStore > 'relations.getByKey' failed with postgres error: ${error.message}`);
+      });
+  }
+
+  /**
+   * Get a list of event streams registered under the given relational keys.
+   *
+   * @param keys - Relational keys to get event streams for.
+   */
+  async getByKeys(keys: string[]): Promise<string[]> {
+    return this.db.sql`SELECT DISTINCT stream FROM ${this.table} WHERE key IN ${this.db.sql(keys)}`
+      .then((rows) => rows.map(({ stream }) => stream))
+      .catch((error) => {
+        throw new Error(`EventStore > 'relations.getByKeys' failed with postgres error: ${error.message}`);
+      });
+  }
+
+  /**
+   * Removes a stream from the relational table.
+   *
+   * @param key    - Relational key to remove stream from.
+   * @param stream - Stream to remove from relation.
+   */
+  async remove(key: string, stream: string): Promise<void> {
+    await this.db.sql`DELETE FROM ${this.table} WHERE key = ${key} AND stream = ${stream}`.catch((error) => {
+      throw new Error(`EventStore > 'relations.remove' failed with postgres error: ${error.message}`);
+    });
+  }
+
+  /**
+   * Removes multiple relational entries.
+   *
+   * @param relations - Relations to remove stream from.
+   * @param batchSize - Batch size for the insert loop.
+   */
+  async removeMany(relations: RelationPayload[], batchSize: number = 1_000): Promise<void> {
+    await this.db.sql
+      .begin(async (sql) => {
+        for (let i = 0; i < relations.length; i += batchSize) {
+          const conditions = relations.slice(i, i + batchSize).map(({ key, stream }) => `(key = '${key}' AND stream = '${stream}')`);
+          await sql`DELETE FROM ${this.table} WHERE ${this.db.sql.unsafe(conditions.join(" OR "))}`;
+        }
+      })
+      .catch((error) => {
+        throw new Error(`EventStore > 'relations.removeMany' failed with postgres error: ${error.message}`);
+      });
+  }
+
+  /**
+   * Remove all relations bound to the given relational keys.
+   *
+   * @param keys - Relational keys to remove from the relational table.
+   */
+  async removeByKeys(keys: string[]): Promise<void> {
+    await this.db.sql`DELETE FROM ${this.table} WHERE key IN ${this.db.sql(keys)}`.catch((error) => {
+      throw new Error(`EventStore > 'relations.removeByKeys' failed with postgres error: ${error.message}`);
+    });
+  }
+
+  /**
+   * Remove all relations bound to the given streams.
+   *
+   * @param streams - Streams to remove from the relational table.
+   */
+  async removeByStreams(streams: string[]): Promise<void> {
+    await this.db.sql`DELETE FROM ${this.table} WHERE stream IN ${this.db.sql(streams)}`.catch((error) => {
+      throw new Error(`EventStore > 'relations.removeByStreams' failed with postgres error: ${error.message}`);
+    });
+  }
+}