@devdash/bofrid-api-types 0.1.5

package/dist/routes/listing-publications.d.ts

@@ -0,0 +1,636 @@
+/**
+ * Listing publication routes — CRUD for external distribution records + fb-manager sync.
+ *
+ * Publications track where a listing has been shared (Facebook, Blocket, etc.)
+ * and the broadcast status for automated Facebook group posting via fb-manager.
+ *
+ * ## fb-manager Integration Flow
+ *
+ * 1. Admin approves listing → publication row created (broadcastStatus: "pending")
+ *    + POST to fb-manager /api/post-in-matching-fb-groups (triggered in listings.ts review handler)
+ * 2. fb-manager fetches listing data from GET /public/listings/{id}/facebook-data
+ * 3. fb-manager posts to matched Facebook groups
+ * 4. fb-manager calls POST /public/listings/{id}/broadcast-callback with results
+ * 5. sync-broadcast endpoint can poll fb-manager for live status during broadcasting
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { AppBindings } from "../app";
+export declare const listingPublicationsApp: OpenAPIHono<AppBindings, {
+    "/listings/:id/publications": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                status: string;
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                publishedAt: string;
+                listingId: string;
+                channel: string;
+                broadcastStatus: string | null;
+                broadcastMeta: string | number | boolean | any[] | {
+                    [x: string]: any;
+                } | null;
+                externalUrl: string | null;
+                notes: string | null;
+            }[];
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/listings/:id/publications": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    channel: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other";
+                    publishedAt?: string | undefined;
+                    externalUrl?: string | undefined;
+                    notes?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    channel: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other";
+                    publishedAt?: string | undefined;
+                    externalUrl?: string | undefined;
+                    notes?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    channel: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other";
+                    publishedAt?: string | undefined;
+                    externalUrl?: string | undefined;
+                    notes?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    channel: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other";
+                    publishedAt?: string | undefined;
+                    externalUrl?: string | undefined;
+                    notes?: string | undefined;
+                };
+            };
+            output: {
+                status: string;
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                publishedAt: string;
+                listingId: string;
+                channel: string;
+                broadcastStatus: string | null;
+                broadcastMeta: string | number | boolean | any[] | {
+                    [x: string]: any;
+                } | null;
+                externalUrl: string | null;
+                notes: string | null;
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/listings/:id/publications/:publicationId": {
+        $patch: {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            } & {
+                json: {
+                    status?: "active" | "archived" | undefined;
+                    publishedAt?: string | undefined;
+                    channel?: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other" | undefined;
+                    externalUrl?: string | null | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            } & {
+                json: {
+                    status?: "active" | "archived" | undefined;
+                    publishedAt?: string | undefined;
+                    channel?: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other" | undefined;
+                    externalUrl?: string | null | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            } & {
+                json: {
+                    status?: "active" | "archived" | undefined;
+                    publishedAt?: string | undefined;
+                    channel?: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other" | undefined;
+                    externalUrl?: string | null | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            } & {
+                json: {
+                    status?: "active" | "archived" | undefined;
+                    publishedAt?: string | undefined;
+                    channel?: "facebook" | "homii" | "blocket" | "hemnet" | "qasa" | "instagram" | "linkedin" | "website" | "other" | undefined;
+                    externalUrl?: string | null | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                status: string;
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                publishedAt: string;
+                listingId: string;
+                channel: string;
+                broadcastStatus: string | null;
+                broadcastMeta: string | number | boolean | any[] | {
+                    [x: string]: any;
+                } | null;
+                externalUrl: string | null;
+                notes: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/listings/:id/publications/:publicationId": {
+        $delete: {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                success: boolean;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/listings/:id/publications/:publicationId/sync-broadcast": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                status: string;
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                publishedAt: string;
+                listingId: string;
+                channel: string;
+                broadcastStatus: string | null;
+                broadcastMeta: string | number | boolean | any[] | {
+                    [x: string]: any;
+                } | null;
+                externalUrl: string | null;
+                notes: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    publicationId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        };
+    };
+} & {
+    "/listings/:id/trigger-broadcast": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                success: boolean;
+                publicationId: string;
+            };
+            outputFormat: "json";
+            status: 202;
+        };
+    };
+} & {
+    "/listings/:id/fb-status": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/listings/:id/preview-homii": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                address: string;
+                payload: {
+                    [x: string]: import("hono/utils/types").JSONValue;
+                } | null;
+                region: string | null;
+                canPost: boolean;
+                errors: string[];
+                warnings: string[];
+                sourceImageUrl: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/listings/:id/trigger-homii": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string | null;
+                success: boolean;
+                publicationId: string;
+                homiiUrl: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/">;