@devdash/bofrid-api-types 0.1.5

package/dist/routes/admin-companies.d.ts

@@ -0,0 +1,381 @@
+/**
+ * Admin company management routes.
+ *
+ * Provides endpoints for listing/searching companies with aggregated stats.
+ * All routes are protected by authMiddleware + adminMiddleware.
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { AppBindings } from "../app";
+export declare const adminCompaniesApp: OpenAPIHono<AppBindings, {
+    "/admin/companies/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                description: string | null;
+                properties: {
+                    status: string;
+                    id: string;
+                    shortId: string | null;
+                    createdAt: string;
+                    street: string;
+                    streetNumber: string | null;
+                    postalCode: string | null;
+                    city: string;
+                    propertyType: string | null;
+                    propertySize: number | null;
+                    totalRooms: number | null;
+                    baseMonthlyRent: number | null;
+                    listing: {
+                        status: string;
+                        id: string;
+                        slug: string | null;
+                        publicUrl: string | null;
+                        viewCount: number;
+                        pendingReview: boolean;
+                        publishedAt: string | null;
+                    } | null;
+                }[];
+                email: string | null;
+                id: string;
+                phoneNumber: string | null;
+                stripeCustomerId: string | null;
+                createdAt: string;
+                updatedAt: string;
+                freeRevealsPerMonth: number | null;
+                ownerId: string;
+                companyName: string;
+                organizationNumber: string | null;
+                isActive: boolean;
+                slug: string;
+                isProfilePublished: boolean;
+                isFastighetsbolag: boolean;
+                logoUrl: string | null;
+                websiteUrl: string | null;
+                addressStreet: string | null;
+                addressCity: string | null;
+                addressPostalCode: string | null;
+                members: {
+                    status: string;
+                    email: string | null;
+                    displayName: string;
+                    phoneNumber: string | null;
+                    profilePictureUrl: string | null;
+                    role: string;
+                    authUserId: string | null;
+                    userId: string;
+                    joinedAt: string | null;
+                    invitedByName: string | null;
+                }[];
+                invitations: {
+                    email: string;
+                    id: string;
+                    role: string;
+                    createdAt: string;
+                    invitedByName: string | null;
+                }[];
+                ownerName: string | null;
+                ownerAuthUserId: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/admin/companies/:id": {
+        $patch: {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    isActive?: boolean | undefined;
+                    isProfilePublished?: boolean | undefined;
+                    isFastighetsbolag?: boolean | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    isActive?: boolean | undefined;
+                    isProfilePublished?: boolean | undefined;
+                    isFastighetsbolag?: boolean | undefined;
+                };
+            };
+            output: {
+                success: boolean;
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    isActive?: boolean | undefined;
+                    isProfilePublished?: boolean | undefined;
+                    isFastighetsbolag?: boolean | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        };
+    };
+} & {
+    "/admin/companies/:id/invite-member": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    email: string;
+                    role?: "member" | "admin" | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    email: string;
+                    role?: "member" | "admin" | undefined;
+                };
+            };
+            output: {
+                message: string;
+                status: "invited" | "pending";
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    email: string;
+                    role?: "member" | "admin" | undefined;
+                };
+            };
+            output: {
+                message: string;
+                status: "invited" | "pending";
+            };
+            outputFormat: "json";
+            status: 201;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    email: string;
+                    role?: "member" | "admin" | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
+        };
+    };
+} & {
+    "/admin/companies": {
+        $get: {
+            input: {
+                query: {
+                    status?: "active" | "all" | "inactive" | undefined;
+                    limit?: number | undefined;
+                    offset?: number | undefined;
+                    sortField?: "createdAt" | "companyName" | "listingCount" | "propertyCount" | "memberCount" | undefined;
+                    sortDir?: "asc" | "desc" | undefined;
+                    q?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                query: {
+                    status?: "active" | "all" | "inactive" | undefined;
+                    limit?: number | undefined;
+                    offset?: number | undefined;
+                    sortField?: "createdAt" | "companyName" | "listingCount" | "propertyCount" | "memberCount" | undefined;
+                    sortDir?: "asc" | "desc" | undefined;
+                    q?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                query: {
+                    status?: "active" | "all" | "inactive" | undefined;
+                    limit?: number | undefined;
+                    offset?: number | undefined;
+                    sortField?: "createdAt" | "companyName" | "listingCount" | "propertyCount" | "memberCount" | undefined;
+                    sortDir?: "asc" | "desc" | undefined;
+                    q?: string | undefined;
+                };
+            };
+            output: {
+                items: {
+                    email: string | null;
+                    id: string;
+                    phoneNumber: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                    ownerId: string;
+                    companyName: string;
+                    organizationNumber: string | null;
+                    isActive: boolean;
+                    slug: string;
+                    isProfilePublished: boolean;
+                    isFastighetsbolag: boolean;
+                    logoUrl: string | null;
+                    addressCity: string | null;
+                    listingCount: number;
+                    propertyCount: number;
+                    ownerName: string | null;
+                    memberCount: number;
+                }[];
+                limit: number;
+                offset: number;
+                total: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/admin/companies/:id/reveal-allowance": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                limit: number | null;
+                globalDefault: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/admin/companies/:id/reveal-allowance": {
+        $put: {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    limit: number | null;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    limit: number | null;
+                };
+            };
+            output: {
+                limit: number | null;
+                globalDefault: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/">;

package/dist/routes/admin-email-jobs.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Admin email job routes — create, monitor, cancel bulk email jobs.
+ *
+ * All routes require auth + admin.
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { AppBindings } from "../app";
+export declare const adminEmailJobsApp: OpenAPIHono<AppBindings, {
+    "/admin/email-jobs": {
+        $get: {
+            input: {
+                query: {
+                    limit?: string | undefined;
+                    referenceId?: string | undefined;
+                };
+            };
+            output: {
+                items: {
+                    type: string;
+                    status: string;
+                    id: string;
+                    createdAt: string;
+                    createdBy: string | null;
+                    referenceId: string | null;
+                    totalItems: number;
+                    sentCount: number;
+                    failedCount: number;
+                    startedAt: string | null;
+                    completedAt: string | null;
+                    cancelledAt: string | null;
+                    pendingCount: number;
+                    referenceLabel: string | null;
+                    cancelledCount: number;
+                }[];
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/admin/email-jobs/active": {
+        $get: {
+            input: {};
+            output: {
+                job: {
+                    type: string;
+                    status: string;
+                    id: string;
+                    createdAt: string;
+                    createdBy: string | null;
+                    referenceId: string | null;
+                    totalItems: number;
+                    sentCount: number;
+                    failedCount: number;
+                    startedAt: string | null;
+                    completedAt: string | null;
+                    cancelledAt: string | null;
+                    pendingCount: number;
+                    referenceLabel: string | null;
+                    cancelledCount: number;
+                } | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/admin/email-jobs/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                type: string;
+                status: string;
+                id: string;
+                createdAt: string;
+                createdBy: string | null;
+                referenceId: string | null;
+                totalItems: number;
+                sentCount: number;
+                failedCount: number;
+                startedAt: string | null;
+                completedAt: string | null;
+                cancelledAt: string | null;
+                pendingCount: number;
+                referenceLabel: string | null;
+                cancelledCount: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/admin/email-jobs/:id/cancel": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                type: string;
+                status: string;
+                id: string;
+                createdAt: string;
+                createdBy: string | null;
+                referenceId: string | null;
+                totalItems: number;
+                sentCount: number;
+                failedCount: number;
+                startedAt: string | null;
+                completedAt: string | null;
+                cancelledAt: string | null;
+                pendingCount: number;
+                referenceLabel: string | null;
+                cancelledCount: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        };
+    };
+} & {
+    "/admin/email-jobs/:id/retry": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                type: string;
+                status: string;
+                id: string;
+                createdAt: string;
+                createdBy: string | null;
+                referenceId: string | null;
+                totalItems: number;
+                sentCount: number;
+                failedCount: number;
+                startedAt: string | null;
+                completedAt: string | null;
+                cancelledAt: string | null;
+                pendingCount: number;
+                referenceLabel: string | null;
+                cancelledCount: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        };
+    };
+} & {
+    "/admin/email-jobs/:id/items": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                query: {
+                    status?: string | undefined;
+                    limit?: string | undefined;
+                    offset?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                query: {
+                    status?: string | undefined;
+                    limit?: string | undefined;
+                    offset?: string | undefined;
+                };
+            };
+            output: {
+                items: {
+                    status: string;
+                    id: string;
+                    recipientEmail: string;
+                    recipientUserId: string | null;
+                    attempts: number;
+                    lastError: string | null;
+                    processedAt: string | null;
+                    recipientName: string | null;
+                }[];
+                total: number;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/">;

package/dist/routes/admin-email-logs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Admin email logs routes — view all transactional email logs.
+ *
+ * All routes require auth + admin.
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { AppBindings } from "../app";
+declare const app: OpenAPIHono<AppBindings, {}, "/">;
+export { app as adminEmailLogsApp };

package/dist/routes/admin-fb-leads.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Admin Facebook leads import routes.
+ *
+ * Imports tenant leads scraped from Bofrid's Facebook groups (stored in the
+ * self-hosted Supabase datalake at supabase.bofrid.dev) into the main Bofrid
+ * system as ghost profiles with city-based bevakningar.
+ *
+ * ## Endpoints
+ *
+ * - `POST /admin/fb-leads/import`  — Import new fb_leads as ghost profiles + bevakningar
+ * - `GET  /admin/fb-leads/stats`   — Overview of imported vs pending fb_leads
+ *
+ * ## How it works
+ *
+ * 1. Fetches tenant fb_leads (with email) from the datalake, joined with
+ *    `fb_groups` to get kommun/län slugs.
+ * 2. For each lead not yet in Bofrid (by email match), creates:
+ *    - A `bofrid_profiles` record with `authProvider = 'facebook_import'` and no `authUserId`.
+ *    - A `bofrid_location_interests` record (bevakning) tied to the lead's city.
+ * 3. The existing bevakning email pipeline picks up these profiles automatically
+ *    when a matching listing is published in their city.
+ * 4. When they register on Bofrid, the Better Auth `afterUserCreated` hook
+ *    auto-links the existing profile by email — bevakning carries over seamlessly.
+ *
+ * ## Idempotency
+ *
+ * Safe to call repeatedly. Leads whose email already exists in `bofrid_profiles`
+ * are skipped. New leads added to the datalake since the last import are picked up.
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { AppBindings } from "../app";
+export declare const adminFbLeadsApp: OpenAPIHono<AppBindings, {}, "/">;