@tscircuit/fake-snippets 0.0.83 → 0.0.85

package/dist/schema.d.ts

@@ -489,6 +489,93 @@ declare const orderQuoteSchema: z.ZodObject<{
     total_cost_without_shipping?: number | undefined;
 }>;
 type OrderQuote = z.infer<typeof orderQuoteSchema>;
+declare const aiReviewSchema: z.ZodObject<{
+    ai_review_id: z.ZodString;
+    ai_review_text: z.ZodNullable<z.ZodString>;
+    start_processing_at: z.ZodNullable<z.ZodString>;
+    finished_processing_at: z.ZodNullable<z.ZodString>;
+    processing_error: z.ZodNullable<z.ZodAny>;
+    created_at: z.ZodString;
+    display_status: z.ZodEnum<["pending", "completed", "failed"]>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    ai_review_id: string;
+    ai_review_text: string | null;
+    start_processing_at: string | null;
+    finished_processing_at: string | null;
+    display_status: "pending" | "completed" | "failed";
+    processing_error?: any;
+}, {
+    created_at: string;
+    ai_review_id: string;
+    ai_review_text: string | null;
+    start_processing_at: string | null;
+    finished_processing_at: string | null;
+    display_status: "pending" | "completed" | "failed";
+    processing_error?: any;
+}>;
+type AiReview = z.infer<typeof aiReviewSchema>;
+declare const datasheetPinInformationSchema: z.ZodObject<{
+    pin_number: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    pin_number: string;
+    capabilities: string[];
+}, {
+    name: string;
+    description: string;
+    pin_number: string;
+    capabilities: string[];
+}>;
+declare const datasheetSchema: z.ZodObject<{
+    datasheet_id: z.ZodString;
+    chip_name: z.ZodString;
+    created_at: z.ZodString;
+    pin_information: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        pin_number: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        capabilities: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        pin_number: string;
+        capabilities: string[];
+    }, {
+        name: string;
+        description: string;
+        pin_number: string;
+        capabilities: string[];
+    }>, "many">>;
+    datasheet_pdf_urls: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    datasheet_id: string;
+    chip_name: string;
+    pin_information: {
+        name: string;
+        description: string;
+        pin_number: string;
+        capabilities: string[];
+    }[] | null;
+    datasheet_pdf_urls: string[] | null;
+}, {
+    created_at: string;
+    datasheet_id: string;
+    chip_name: string;
+    pin_information: {
+        name: string;
+        description: string;
+        pin_number: string;
+        capabilities: string[];
+    }[] | null;
+    datasheet_pdf_urls: string[] | null;
+}>;
+type Datasheet = z.infer<typeof datasheetSchema>;
 declare const accountSnippetSchema: z.ZodObject<{
     account_id: z.ZodString;
     snippet_id: z.ZodString;
@@ -570,11 +657,11 @@ declare const packageReleaseSchema: z.ZodObject<{
     package_release_id: string;
     created_at: string;
     version: string | null;
+    display_status: "error" | "pending" | "building" | "complete";
     package_id: string;
     is_locked: boolean;
     is_latest: boolean;
     has_transpiled: boolean;
-    display_status: "error" | "pending" | "building" | "complete";
     transpilation_display_status: "error" | "pending" | "building" | "complete";
     transpilation_in_progress: boolean;
     transpilation_logs: any[];
@@ -584,6 +671,7 @@ declare const packageReleaseSchema: z.ZodObject<{
     circuit_json_build_logs: any[];
     circuit_json_build_is_stale: boolean;
     ai_review_requested: boolean;
+    ai_review_text?: string | null | undefined;
     commit_sha?: string | null | undefined;
     license?: string | null | undefined;
     circuit_json_build_error?: string | null | undefined;
@@ -595,7 +683,6 @@ declare const packageReleaseSchema: z.ZodObject<{
     transpilation_completed_at?: string | null | undefined;
     circuit_json_build_started_at?: string | null | undefined;
     circuit_json_build_completed_at?: string | null | undefined;
-    ai_review_text?: string | null | undefined;
     ai_review_started_at?: string | null | undefined;
     ai_review_completed_at?: string | null | undefined;
     ai_review_error?: any;
@@ -607,6 +694,8 @@ declare const packageReleaseSchema: z.ZodObject<{
     package_id: string;
     is_locked: boolean;
     is_latest: boolean;
+    ai_review_text?: string | null | undefined;
+    display_status?: "error" | "pending" | "building" | "complete" | undefined;
     commit_sha?: string | null | undefined;
     license?: string | null | undefined;
     circuit_json_build_error?: string | null | undefined;
@@ -614,7 +703,6 @@ declare const packageReleaseSchema: z.ZodObject<{
     has_transpiled?: boolean | undefined;
     transpilation_error?: string | null | undefined;
     fs_sha?: string | null | undefined;
-    display_status?: "error" | "pending" | "building" | "complete" | undefined;
     total_build_duration_ms?: number | null | undefined;
     transpilation_display_status?: "error" | "pending" | "building" | "complete" | undefined;
     transpilation_in_progress?: boolean | undefined;
@@ -628,7 +716,6 @@ declare const packageReleaseSchema: z.ZodObject<{
     circuit_json_build_completed_at?: string | null | undefined;
     circuit_json_build_logs?: any[] | undefined;
     circuit_json_build_is_stale?: boolean | undefined;
-    ai_review_text?: string | null | undefined;
     ai_review_started_at?: string | null | undefined;
     ai_review_completed_at?: string | null | undefined;
     ai_review_error?: any;
@@ -967,11 +1054,11 @@ declare const databaseSchema: z.ZodObject<{
         package_release_id: string;
         created_at: string;
         version: string | null;
+        display_status: "error" | "pending" | "building" | "complete";
         package_id: string;
         is_locked: boolean;
         is_latest: boolean;
         has_transpiled: boolean;
-        display_status: "error" | "pending" | "building" | "complete";
         transpilation_display_status: "error" | "pending" | "building" | "complete";
         transpilation_in_progress: boolean;
         transpilation_logs: any[];
@@ -981,6 +1068,7 @@ declare const databaseSchema: z.ZodObject<{
         circuit_json_build_logs: any[];
         circuit_json_build_is_stale: boolean;
         ai_review_requested: boolean;
+        ai_review_text?: string | null | undefined;
         commit_sha?: string | null | undefined;
         license?: string | null | undefined;
         circuit_json_build_error?: string | null | undefined;
@@ -992,7 +1080,6 @@ declare const databaseSchema: z.ZodObject<{
         transpilation_completed_at?: string | null | undefined;
         circuit_json_build_started_at?: string | null | undefined;
         circuit_json_build_completed_at?: string | null | undefined;
-        ai_review_text?: string | null | undefined;
         ai_review_started_at?: string | null | undefined;
         ai_review_completed_at?: string | null | undefined;
         ai_review_error?: any;
@@ -1004,6 +1091,8 @@ declare const databaseSchema: z.ZodObject<{
         package_id: string;
         is_locked: boolean;
         is_latest: boolean;
+        ai_review_text?: string | null | undefined;
+        display_status?: "error" | "pending" | "building" | "complete" | undefined;
         commit_sha?: string | null | undefined;
         license?: string | null | undefined;
         circuit_json_build_error?: string | null | undefined;
@@ -1011,7 +1100,6 @@ declare const databaseSchema: z.ZodObject<{
         has_transpiled?: boolean | undefined;
         transpilation_error?: string | null | undefined;
         fs_sha?: string | null | undefined;
-        display_status?: "error" | "pending" | "building" | "complete" | undefined;
         total_build_duration_ms?: number | null | undefined;
         transpilation_display_status?: "error" | "pending" | "building" | "complete" | undefined;
         transpilation_in_progress?: boolean | undefined;
@@ -1025,7 +1113,6 @@ declare const databaseSchema: z.ZodObject<{
         circuit_json_build_completed_at?: string | null | undefined;
         circuit_json_build_logs?: any[] | undefined;
         circuit_json_build_is_stale?: boolean | undefined;
-        ai_review_text?: string | null | undefined;
         ai_review_started_at?: string | null | undefined;
         ai_review_completed_at?: string | null | undefined;
         ai_review_error?: any;
@@ -1595,6 +1682,75 @@ declare const databaseSchema: z.ZodObject<{
         bare_pcb_cost?: number | undefined;
         total_cost_without_shipping?: number | undefined;
     }>, "many">>;
+    aiReviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        ai_review_id: z.ZodString;
+        ai_review_text: z.ZodNullable<z.ZodString>;
+        start_processing_at: z.ZodNullable<z.ZodString>;
+        finished_processing_at: z.ZodNullable<z.ZodString>;
+        processing_error: z.ZodNullable<z.ZodAny>;
+        created_at: z.ZodString;
+        display_status: z.ZodEnum<["pending", "completed", "failed"]>;
+    }, "strip", z.ZodTypeAny, {
+        created_at: string;
+        ai_review_id: string;
+        ai_review_text: string | null;
+        start_processing_at: string | null;
+        finished_processing_at: string | null;
+        display_status: "pending" | "completed" | "failed";
+        processing_error?: any;
+    }, {
+        created_at: string;
+        ai_review_id: string;
+        ai_review_text: string | null;
+        start_processing_at: string | null;
+        finished_processing_at: string | null;
+        display_status: "pending" | "completed" | "failed";
+        processing_error?: any;
+    }>, "many">>;
+    datasheets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        datasheet_id: z.ZodString;
+        chip_name: z.ZodString;
+        created_at: z.ZodString;
+        pin_information: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            pin_number: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodString;
+            capabilities: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            pin_number: string;
+            capabilities: string[];
+        }, {
+            name: string;
+            description: string;
+            pin_number: string;
+            capabilities: string[];
+        }>, "many">>;
+        datasheet_pdf_urls: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        created_at: string;
+        datasheet_id: string;
+        chip_name: string;
+        pin_information: {
+            name: string;
+            description: string;
+            pin_number: string;
+            capabilities: string[];
+        }[] | null;
+        datasheet_pdf_urls: string[] | null;
+    }, {
+        created_at: string;
+        datasheet_id: string;
+        chip_name: string;
+        pin_information: {
+            name: string;
+            description: string;
+            pin_number: string;
+            capabilities: string[];
+        }[] | null;
+        datasheet_pdf_urls: string[] | null;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     idCounter: number;
     snippets: {
@@ -1625,11 +1781,11 @@ declare const databaseSchema: z.ZodObject<{
         package_release_id: string;
         created_at: string;
         version: string | null;
+        display_status: "error" | "pending" | "building" | "complete";
         package_id: string;
         is_locked: boolean;
         is_latest: boolean;
         has_transpiled: boolean;
-        display_status: "error" | "pending" | "building" | "complete";
         transpilation_display_status: "error" | "pending" | "building" | "complete";
         transpilation_in_progress: boolean;
         transpilation_logs: any[];
@@ -1639,6 +1795,7 @@ declare const databaseSchema: z.ZodObject<{
         circuit_json_build_logs: any[];
         circuit_json_build_is_stale: boolean;
         ai_review_requested: boolean;
+        ai_review_text?: string | null | undefined;
         commit_sha?: string | null | undefined;
         license?: string | null | undefined;
         circuit_json_build_error?: string | null | undefined;
@@ -1650,7 +1807,6 @@ declare const databaseSchema: z.ZodObject<{
         transpilation_completed_at?: string | null | undefined;
         circuit_json_build_started_at?: string | null | undefined;
         circuit_json_build_completed_at?: string | null | undefined;
-        ai_review_text?: string | null | undefined;
         ai_review_started_at?: string | null | undefined;
         ai_review_completed_at?: string | null | undefined;
         ai_review_error?: any;
@@ -1833,6 +1989,27 @@ declare const databaseSchema: z.ZodObject<{
         }[];
         total_cost_without_shipping: number;
     }[];
+    aiReviews: {
+        created_at: string;
+        ai_review_id: string;
+        ai_review_text: string | null;
+        start_processing_at: string | null;
+        finished_processing_at: string | null;
+        display_status: "pending" | "completed" | "failed";
+        processing_error?: any;
+    }[];
+    datasheets: {
+        created_at: string;
+        datasheet_id: string;
+        chip_name: string;
+        pin_information: {
+            name: string;
+            description: string;
+            pin_number: string;
+            capabilities: string[];
+        }[] | null;
+        datasheet_pdf_urls: string[] | null;
+    }[];
 }, {
     idCounter?: number | undefined;
     snippets?: {
@@ -1866,6 +2043,8 @@ declare const databaseSchema: z.ZodObject<{
         package_id: string;
         is_locked: boolean;
         is_latest: boolean;
+        ai_review_text?: string | null | undefined;
+        display_status?: "error" | "pending" | "building" | "complete" | undefined;
         commit_sha?: string | null | undefined;
         license?: string | null | undefined;
         circuit_json_build_error?: string | null | undefined;
@@ -1873,7 +2052,6 @@ declare const databaseSchema: z.ZodObject<{
         has_transpiled?: boolean | undefined;
         transpilation_error?: string | null | undefined;
         fs_sha?: string | null | undefined;
-        display_status?: "error" | "pending" | "building" | "complete" | undefined;
         total_build_duration_ms?: number | null | undefined;
         transpilation_display_status?: "error" | "pending" | "building" | "complete" | undefined;
         transpilation_in_progress?: boolean | undefined;
@@ -1887,7 +2065,6 @@ declare const databaseSchema: z.ZodObject<{
         circuit_json_build_completed_at?: string | null | undefined;
         circuit_json_build_logs?: any[] | undefined;
         circuit_json_build_is_stale?: boolean | undefined;
-        ai_review_text?: string | null | undefined;
         ai_review_started_at?: string | null | undefined;
         ai_review_completed_at?: string | null | undefined;
         ai_review_error?: any;
@@ -2071,7 +2248,28 @@ declare const databaseSchema: z.ZodObject<{
         bare_pcb_cost?: number | undefined;
         total_cost_without_shipping?: number | undefined;
     }[] | undefined;
+    aiReviews?: {
+        created_at: string;
+        ai_review_id: string;
+        ai_review_text: string | null;
+        start_processing_at: string | null;
+        finished_processing_at: string | null;
+        display_status: "pending" | "completed" | "failed";
+        processing_error?: any;
+    }[] | undefined;
+    datasheets?: {
+        created_at: string;
+        datasheet_id: string;
+        chip_name: string;
+        pin_information: {
+            name: string;
+            description: string;
+            pin_number: string;
+            capabilities: string[];
+        }[] | null;
+        datasheet_pdf_urls: string[] | null;
+    }[] | undefined;
 }>;
 type DatabaseSchema = z.infer<typeof databaseSchema>;
 
-export { type Account, type AccountPackage, type AccountSnippet, type DatabaseSchema, type JlcpcbOrderState, type JlcpcbOrderStepRun, type LoginPage, type Order, type OrderFile, type OrderQuote, type Package, type PackageFile, type PackageRelease, type QuotedComponent, type Session, type ShippingOption, type Snippet, accountPackageSchema, accountSchema, accountSnippetSchema, databaseSchema, errorResponseSchema, errorSchema, jlcpcbOrderStateSchema, jlcpcbOrderStepRunSchema, loginPageSchema, orderFileSchema, orderQuoteSchema, orderSchema, packageFileSchema, packageReleaseSchema, packageSchema, quotedComponentSchema, sessionSchema, shippingInfoSchema, snippetSchema };
+export { type Account, type AccountPackage, type AccountSnippet, type AiReview, type DatabaseSchema, type Datasheet, type JlcpcbOrderState, type JlcpcbOrderStepRun, type LoginPage, type Order, type OrderFile, type OrderQuote, type Package, type PackageFile, type PackageRelease, type QuotedComponent, type Session, type ShippingOption, type Snippet, accountPackageSchema, accountSchema, accountSnippetSchema, aiReviewSchema, databaseSchema, datasheetPinInformationSchema, datasheetSchema, errorResponseSchema, errorSchema, jlcpcbOrderStateSchema, jlcpcbOrderStepRunSchema, loginPageSchema, orderFileSchema, orderQuoteSchema, orderSchema, packageFileSchema, packageReleaseSchema, packageSchema, quotedComponentSchema, sessionSchema, shippingInfoSchema, snippetSchema };

package/dist/schema.js

@@ -115,6 +115,28 @@ var orderQuoteSchema = z.object({
   shipping_options: z.array(shippingOptionSchema),
   total_cost_without_shipping: z.number().default(0)
 });
+var aiReviewSchema = z.object({
+  ai_review_id: z.string().uuid(),
+  ai_review_text: z.string().nullable(),
+  start_processing_at: z.string().datetime().nullable(),
+  finished_processing_at: z.string().datetime().nullable(),
+  processing_error: z.any().nullable(),
+  created_at: z.string().datetime(),
+  display_status: z.enum(["pending", "completed", "failed"])
+});
+var datasheetPinInformationSchema = z.object({
+  pin_number: z.string(),
+  name: z.string(),
+  description: z.string(),
+  capabilities: z.array(z.string())
+});
+var datasheetSchema = z.object({
+  datasheet_id: z.string(),
+  chip_name: z.string(),
+  created_at: z.string(),
+  pin_information: datasheetPinInformationSchema.array().nullable(),
+  datasheet_pdf_urls: z.array(z.string()).nullable()
+});
 var accountSnippetSchema = z.object({
   account_id: z.string(),
   snippet_id: z.string(),
@@ -259,13 +281,18 @@ var databaseSchema = z.object({
   accountPackages: z.array(accountPackageSchema).default([]),
   jlcpcbOrderState: z.array(jlcpcbOrderStateSchema).default([]),
   jlcpcbOrderStepRuns: z.array(jlcpcbOrderStepRunSchema).default([]),
-  orderQuotes: z.array(orderQuoteSchema).default([])
+  orderQuotes: z.array(orderQuoteSchema).default([]),
+  aiReviews: z.array(aiReviewSchema).default([]),
+  datasheets: z.array(datasheetSchema).default([])
 });
 export {
   accountPackageSchema,
   accountSchema,
   accountSnippetSchema,
+  aiReviewSchema,
   databaseSchema,
+  datasheetPinInformationSchema,
+  datasheetSchema,
   errorResponseSchema,
   errorSchema,
   jlcpcbOrderStateSchema,

package/fake-snippets-api/lib/db/db-client.ts

@@ -16,6 +16,10 @@ import {
   type PackageFile,
   type PackageRelease,
   packageReleaseSchema,
+  type AiReview,
+  aiReviewSchema,
+  type Datasheet,
+  datasheetSchema,
   type Session,
   type Snippet,
   databaseSchema,
@@ -1338,4 +1342,76 @@ const initializer = combine(databaseSchema.parse({}), (set, get) => ({
       ),
     }))
   },
+
+  addAiReview: (review: Omit<AiReview, "ai_review_id">): AiReview => {
+    const base = aiReviewSchema.omit({ ai_review_id: true }).parse(review)
+    const newReview = {
+      ai_review_id: crypto.randomUUID(),
+      ...base,
+    }
+    set((state) => ({
+      aiReviews: [...state.aiReviews, newReview],
+      idCounter: state.idCounter + 1,
+    }))
+    return newReview
+  },
+  updateAiReview: (
+    aiReviewId: string,
+    updates: Partial<AiReview>,
+  ): AiReview | undefined => {
+    let updated: AiReview | undefined
+    set((state) => {
+      const index = state.aiReviews.findIndex(
+        (ar) => ar.ai_review_id === aiReviewId,
+      )
+      if (index === -1) return state
+      const aiReviews = [...state.aiReviews]
+      aiReviews[index] = { ...aiReviews[index], ...updates }
+      updated = aiReviews[index]
+      return { ...state, aiReviews }
+    })
+    return updated
+  },
+  getAiReviewById: (aiReviewId: string): AiReview | undefined => {
+    const state = get()
+    return state.aiReviews.find((ar) => ar.ai_review_id === aiReviewId)
+  },
+  listAiReviews: (): AiReview[] => {
+    const state = get()
+    return state.aiReviews
+  },
+  addDatasheet: ({ chip_name }: { chip_name: string }): Datasheet => {
+    const newDatasheet = datasheetSchema.parse({
+      datasheet_id: `datasheet_${Date.now()}`,
+      chip_name,
+      created_at: new Date().toISOString(),
+      pin_information: null,
+      datasheet_pdf_urls: null,
+    })
+    set((state) => ({
+      datasheets: [...state.datasheets, newDatasheet],
+    }))
+    return newDatasheet
+  },
+  getDatasheetById: (datasheetId: string): Datasheet | undefined => {
+    const state = get()
+    return state.datasheets.find((d) => d.datasheet_id === datasheetId)
+  },
+  updateDatasheet: (
+    datasheetId: string,
+    updates: Partial<Datasheet>,
+  ): Datasheet | undefined => {
+    let updated: Datasheet | undefined
+    set((state) => {
+      const index = state.datasheets.findIndex(
+        (d) => d.datasheet_id === datasheetId,
+      )
+      if (index === -1) return state
+      const datasheets = [...state.datasheets]
+      datasheets[index] = { ...datasheets[index], ...updates }
+      updated = datasheets[index]
+      return { ...state, datasheets }
+    })
+    return updated
+  },
 }))

package/fake-snippets-api/lib/db/schema.ts

@@ -138,6 +138,33 @@ export const orderQuoteSchema = z.object({
 })
 export type OrderQuote = z.infer<typeof orderQuoteSchema>
 
+export const aiReviewSchema = z.object({
+  ai_review_id: z.string().uuid(),
+  ai_review_text: z.string().nullable(),
+  start_processing_at: z.string().datetime().nullable(),
+  finished_processing_at: z.string().datetime().nullable(),
+  processing_error: z.any().nullable(),
+  created_at: z.string().datetime(),
+  display_status: z.enum(["pending", "completed", "failed"]),
+})
+export type AiReview = z.infer<typeof aiReviewSchema>
+
+export const datasheetPinInformationSchema = z.object({
+  pin_number: z.string(),
+  name: z.string(),
+  description: z.string(),
+  capabilities: z.array(z.string()),
+})
+
+export const datasheetSchema = z.object({
+  datasheet_id: z.string(),
+  chip_name: z.string(),
+  created_at: z.string(),
+  pin_information: datasheetPinInformationSchema.array().nullable(),
+  datasheet_pdf_urls: z.array(z.string()).nullable(),
+})
+export type Datasheet = z.infer<typeof datasheetSchema>
+
 // TODO: Remove this schema after migration to accountPackages is complete
 export const accountSnippetSchema = z.object({
   account_id: z.string(),
@@ -314,5 +341,7 @@ export const databaseSchema = z.object({
   jlcpcbOrderState: z.array(jlcpcbOrderStateSchema).default([]),
   jlcpcbOrderStepRuns: z.array(jlcpcbOrderStepRunSchema).default([]),
   orderQuotes: z.array(orderQuoteSchema).default([]),
+  aiReviews: z.array(aiReviewSchema).default([]),
+  datasheets: z.array(datasheetSchema).default([]),
 })
 export type DatabaseSchema = z.infer<typeof databaseSchema>

package/fake-snippets-api/routes/api/_fake/ai_reviews/process_review.ts

@@ -0,0 +1,31 @@
+import { withRouteSpec } from "fake-snippets-api/lib/middleware/with-winter-spec"
+import { z } from "zod"
+import { aiReviewSchema } from "fake-snippets-api/lib/db/schema"
+
+export default withRouteSpec({
+  methods: ["POST"],
+  auth: "session",
+  jsonBody: z.object({
+    ai_review_id: z.string(),
+  }),
+  jsonResponse: z.object({
+    ai_review: aiReviewSchema,
+  }),
+})(async (req, ctx) => {
+  const { ai_review_id } = req.jsonBody
+  const existing = ctx.db.getAiReviewById(ai_review_id)
+  if (!existing) {
+    return ctx.error(404, {
+      error_code: "ai_review_not_found",
+      message: "AI review not found",
+    })
+  }
+  const now = new Date().toISOString()
+  const updated = ctx.db.updateAiReview(ai_review_id, {
+    ai_review_text: "Placeholder AI Review",
+    start_processing_at: existing.start_processing_at ?? now,
+    finished_processing_at: now,
+    display_status: "completed",
+  })!
+  return ctx.json({ ai_review: updated })
+})

package/fake-snippets-api/routes/api/_fake/datasheets/process_all_datasheets.ts

@@ -0,0 +1,37 @@
+import { datasheetSchema } from "fake-snippets-api/lib/db/schema"
+import { withRouteSpec } from "fake-snippets-api/lib/middleware/with-winter-spec"
+import { z } from "zod"
+
+export const processAllDatasheets = (ctx: any) => {
+  const processed = [] as z.infer<typeof datasheetSchema>[]
+  ctx.db.datasheets.forEach((ds: any) => {
+    if (!ds.pin_information || !ds.datasheet_pdf_urls) {
+      const updated = ctx.db.updateDatasheet(ds.datasheet_id, {
+        pin_information: [
+          {
+            pin_number: "1",
+            name: "PIN1",
+            description: "Placeholder pin",
+            capabilities: ["digital"],
+          },
+        ],
+        datasheet_pdf_urls: ["https://example.com/datasheet.pdf"],
+      })
+      processed.push(updated!)
+    } else {
+      processed.push(ds)
+    }
+  })
+  return processed
+}
+
+export default withRouteSpec({
+  methods: ["POST"],
+  auth: "none",
+  jsonResponse: z.object({
+    datasheets: datasheetSchema.array(),
+  }),
+})(async (req, ctx) => {
+  const datasheets = processAllDatasheets(ctx)
+  return ctx.json({ datasheets })
+})

package/fake-snippets-api/routes/api/_fake/run_async_tasks.ts

@@ -0,0 +1,12 @@
+import { withRouteSpec } from "fake-snippets-api/lib/middleware/with-winter-spec"
+import { z } from "zod"
+import { processAllDatasheets } from "./datasheets/process_all_datasheets"
+
+export default withRouteSpec({
+  methods: ["GET"],
+  auth: "none",
+  jsonResponse: z.object({ ok: z.boolean() }),
+})(async (req, ctx) => {
+  processAllDatasheets(ctx)
+  return ctx.json({ ok: true })
+})

package/fake-snippets-api/routes/api/ai_reviews/create.ts

@@ -0,0 +1,22 @@
+import { withRouteSpec } from "fake-snippets-api/lib/middleware/with-winter-spec"
+import { z } from "zod"
+import { aiReviewSchema } from "fake-snippets-api/lib/db/schema"
+
+export default withRouteSpec({
+  methods: ["POST"],
+  auth: "session",
+  jsonResponse: z.object({
+    ai_review: aiReviewSchema,
+  }),
+})(async (req, ctx) => {
+  const ai_review = ctx.db.addAiReview({
+    ai_review_text: null,
+    start_processing_at: null,
+    finished_processing_at: null,
+    processing_error: null,
+    created_at: new Date().toISOString(),
+    display_status: "pending",
+  })
+
+  return ctx.json({ ai_review })
+})