feat(onboarding): add mini app household join flow

packages/db/drizzle/0006_marvelous_nehzno.sql

@@ -0,0 +1,26 @@
+CREATE TABLE "household_join_tokens" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"household_id" uuid NOT NULL,
+	"token" text NOT NULL,
+	"created_by_telegram_user_id" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "household_pending_members" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"household_id" uuid NOT NULL,
+	"telegram_user_id" text NOT NULL,
+	"display_name" text NOT NULL,
+	"username" text,
+	"language_code" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "household_join_tokens" ADD CONSTRAINT "household_join_tokens_household_id_households_id_fk" FOREIGN KEY ("household_id") REFERENCES "public"."households"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "household_pending_members" ADD CONSTRAINT "household_pending_members_household_id_households_id_fk" FOREIGN KEY ("household_id") REFERENCES "public"."households"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+CREATE UNIQUE INDEX "household_join_tokens_household_unique" ON "household_join_tokens" USING btree ("household_id");--> statement-breakpoint
+CREATE UNIQUE INDEX "household_join_tokens_token_unique" ON "household_join_tokens" USING btree ("token");--> statement-breakpoint
+CREATE UNIQUE INDEX "household_pending_members_household_user_unique" ON "household_pending_members" USING btree ("household_id","telegram_user_id");--> statement-breakpoint
+CREATE INDEX "household_pending_members_telegram_user_idx" ON "household_pending_members" USING btree ("telegram_user_id");

packages/db/drizzle/meta/_journal.json

@@ -43,6 +43,13 @@
       "when": 1773012360748,
       "tag": "0005_free_kang",
       "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "7",
+      "when": 1773015092441,
+      "tag": "0006_marvelous_nehzno",
+      "breakpoints": true
     }
   ]
 }

packages/db/src/schema.ts

@@ -66,6 +66,47 @@ export const householdTopicBindings = pgTable(
   })
 )
 
+export const householdJoinTokens = pgTable(
+  'household_join_tokens',
+  {
+    id: uuid('id').defaultRandom().primaryKey(),
+    householdId: uuid('household_id')
+      .notNull()
+      .references(() => households.id, { onDelete: 'cascade' }),
+    token: text('token').notNull(),
+    createdByTelegramUserId: text('created_by_telegram_user_id'),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
+  },
+  (table) => ({
+    householdUnique: uniqueIndex('household_join_tokens_household_unique').on(table.householdId),
+    tokenUnique: uniqueIndex('household_join_tokens_token_unique').on(table.token)
+  })
+)
+
+export const householdPendingMembers = pgTable(
+  'household_pending_members',
+  {
+    id: uuid('id').defaultRandom().primaryKey(),
+    householdId: uuid('household_id')
+      .notNull()
+      .references(() => households.id, { onDelete: 'cascade' }),
+    telegramUserId: text('telegram_user_id').notNull(),
+    displayName: text('display_name').notNull(),
+    username: text('username'),
+    languageCode: text('language_code'),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
+  },
+  (table) => ({
+    householdUserUnique: uniqueIndex('household_pending_members_household_user_unique').on(
+      table.householdId,
+      table.telegramUserId
+    ),
+    telegramUserIdx: index('household_pending_members_telegram_user_idx').on(table.telegramUserId)
+  })
+)
+
 export const members = pgTable(
   'members',
   {