track owned inventions

packages/domain/src/index.ts

@@ -7,4 +7,5 @@ export * from './rooms-db'
 export * from './room-instance-db'
 export * from './presence-db'
 export * from './gifts-db'
+export * from './inventory-invention-db'
 export * from './relationships-db'

packages/domain/src/inventory-invention-db.ts

@@ -0,0 +1,74 @@
+/**
+ * Owned inventions on the shared `recflare` D1 database — the inventions a player has
+ * bought. One row per (account, invention), written at purchase time by the `econ`
+ * worker's `GET /api/storefronts/v2/buyInvention`.
+ *
+ * Only the invention id is stored: the invention record itself lives in the `invention`
+ * table, whose schema the `api` worker owns (apps/api/migrations/0002_invention.sql) on
+ * this same database, and copying its DTO here would leave two rows to keep in step. A
+ * creator is not listed here either — they own their invention through its
+ * `CreatorPlayerId`, and the buy path refuses to sell an invention to its own creator.
+ *
+ * The `econ` worker owns the schema/migration (apps/econ/migrations/
+ * 0008_inventory_invention.sql) and is the only writer; `api` only reads, to fold bought
+ * inventions into `GET /api/inventions/v2/mine`. Both import these helpers so the table
+ * name and row shape live in one place — the same split as gifts-db.ts.
+ */
+
+/** Schema DDL (mirror of migrations 0008_inventory_invention.sql) — also builds the table in tests. */
+export const INVENTORY_INVENTION_SCHEMA_DDL: string[] = [
+	`CREATE TABLE IF NOT EXISTS inventory_invention (
+		account_id INTEGER NOT NULL,
+		invention_id INTEGER NOT NULL,
+		acquired_at TEXT NOT NULL,
+		PRIMARY KEY (account_id, invention_id)
+	)`,
+]
+
+/**
+ * Grant an invention to a player. INSERT OR IGNORE on the (account, invention) primary
+ * key: owning an invention is boolean, so a second grant keeps the original
+ * `acquired_at` rather than back-dating the purchase to now.
+ */
+export async function grantInvention(
+	db: D1Database,
+	accountId: number,
+	inventionId: number
+): Promise<void> {
+	await db
+		.prepare(
+			'INSERT OR IGNORE INTO inventory_invention (account_id, invention_id, acquired_at) VALUES (?1, ?2, ?3)'
+		)
+		.bind(accountId, inventionId, new Date().toISOString())
+		.run()
+}
+
+/**
+ * Whether a player has bought an invention. This answers for BOUGHT inventions only —
+ * the creator of an invention owns it without a row here, so callers that mean "may use
+ * this invention" must check `CreatorPlayerId` as well.
+ */
+export async function ownsInvention(
+	db: D1Database,
+	accountId: number,
+	inventionId: number
+): Promise<boolean> {
+	const row = await db
+		.prepare(
+			'SELECT 1 AS owned FROM inventory_invention WHERE account_id = ?1 AND invention_id = ?2'
+		)
+		.bind(accountId, inventionId)
+		.first<{ owned: number }>()
+	return row !== null
+}
+
+/** The ids of every invention a player has bought, oldest purchase first. */
+export async function getOwnedInventionIds(db: D1Database, accountId: number): Promise<number[]> {
+	const { results } = await db
+		.prepare(
+			'SELECT invention_id FROM inventory_invention WHERE account_id = ?1 ORDER BY acquired_at, invention_id'
+		)
+		.bind(accountId)
+		.all<{ invention_id: number }>()
+	return results.map((r) => r.invention_id)
+}