@tscircuit/fake-snippets 0.0.83 → 0.0.84

package/dist/index.d.ts

@@ -384,6 +384,32 @@ 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 accountPackageSchema: z.ZodObject<{
     account_package_id: z.ZodString;
     account_id: z.ZodString;
@@ -445,11 +471,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[];
@@ -459,6 +485,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;
@@ -470,7 +497,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;
@@ -482,6 +508,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;
@@ -489,7 +517,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;
@@ -503,7 +530,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;
@@ -765,11 +791,11 @@ declare const createDatabase: ({ seed }?: {
         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[];
@@ -779,6 +805,7 @@ declare const createDatabase: ({ seed }?: {
         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;
@@ -790,7 +817,6 @@ declare const createDatabase: ({ seed }?: {
         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;
@@ -973,7 +999,16 @@ declare const createDatabase: ({ seed }?: {
         }[];
         total_cost_without_shipping: number;
     }[];
-}, "addOrder" | "getOrderById" | "getOrderFilesByOrderId" | "addOrderQuote" | "getOrderQuoteById" | "getJlcpcbOrderStatesByOrderId" | "getJlcpcbOrderStepRunsByJlcpcbOrderStateId" | "updateOrder" | "addJlcpcbOrderState" | "updateJlcpcbOrderState" | "addOrderFile" | "getOrderFileById" | "addAccount" | "addAccountPackage" | "getAccountPackageById" | "updateAccountPackage" | "deleteAccountPackage" | "addSnippet" | "getLatestSnippets" | "getTrendingSnippets" | "getPackagesByAuthor" | "getSnippetByAuthorAndName" | "updateSnippet" | "getSnippetById" | "searchSnippets" | "searchPackages" | "deleteSnippet" | "addSession" | "getSessions" | "createLoginPage" | "getLoginPage" | "updateLoginPage" | "getAccount" | "updateAccount" | "createSession" | "addStar" | "removeStar" | "hasStarred" | "addPackage" | "updatePackage" | "getPackageById" | "getPackageReleaseById" | "addPackageRelease" | "updatePackageRelease" | "deletePackageFile" | "addPackageFile" | "updatePackageFile" | "getStarCount" | "getPackageFilesByReleaseId" | "updatePackageReleaseFsSha"> & {
+    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;
+    }[];
+}, "addOrder" | "getOrderById" | "getOrderFilesByOrderId" | "addOrderQuote" | "getOrderQuoteById" | "getJlcpcbOrderStatesByOrderId" | "getJlcpcbOrderStepRunsByJlcpcbOrderStateId" | "updateOrder" | "addJlcpcbOrderState" | "updateJlcpcbOrderState" | "addOrderFile" | "getOrderFileById" | "addAccount" | "addAccountPackage" | "getAccountPackageById" | "updateAccountPackage" | "deleteAccountPackage" | "addSnippet" | "getLatestSnippets" | "getTrendingSnippets" | "getPackagesByAuthor" | "getSnippetByAuthorAndName" | "updateSnippet" | "getSnippetById" | "searchSnippets" | "searchPackages" | "deleteSnippet" | "addSession" | "getSessions" | "createLoginPage" | "getLoginPage" | "updateLoginPage" | "getAccount" | "updateAccount" | "createSession" | "addStar" | "removeStar" | "hasStarred" | "addPackage" | "updatePackage" | "getPackageById" | "getPackageReleaseById" | "addPackageRelease" | "updatePackageRelease" | "deletePackageFile" | "addPackageFile" | "updatePackageFile" | "getStarCount" | "getPackageFilesByReleaseId" | "updatePackageReleaseFsSha" | "addAiReview" | "updateAiReview" | "getAiReviewById" | "listAiReviews"> & {
     addOrder: (order: Omit<Order, "order_id">) => Order;
     getOrderById: (orderId: string) => Order | undefined;
     getOrderFilesByOrderId: (orderId: string) => OrderFile[];
@@ -1051,6 +1086,10 @@ declare const createDatabase: ({ seed }?: {
      * Update fs_sha for a package release based on its files
      */
     updatePackageReleaseFsSha: (packageReleaseId: string) => void;
+    addAiReview: (review: Omit<AiReview, "ai_review_id">) => AiReview;
+    updateAiReview: (aiReviewId: string, updates: Partial<AiReview>) => AiReview | undefined;
+    getAiReviewById: (aiReviewId: string) => AiReview | undefined;
+    listAiReviews: () => AiReview[];
 }> & Omit<{
     idCounter: number;
     snippets: {
@@ -1081,11 +1120,11 @@ declare const createDatabase: ({ seed }?: {
         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[];
@@ -1095,6 +1134,7 @@ declare const createDatabase: ({ seed }?: {
         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;
@@ -1106,7 +1146,6 @@ declare const createDatabase: ({ seed }?: {
         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;
@@ -1289,7 +1328,16 @@ declare const createDatabase: ({ seed }?: {
         }[];
         total_cost_without_shipping: number;
     }[];
-}, "addOrder" | "getOrderById" | "getOrderFilesByOrderId" | "addOrderQuote" | "getOrderQuoteById" | "getJlcpcbOrderStatesByOrderId" | "getJlcpcbOrderStepRunsByJlcpcbOrderStateId" | "updateOrder" | "addJlcpcbOrderState" | "updateJlcpcbOrderState" | "addOrderFile" | "getOrderFileById" | "addAccount" | "addAccountPackage" | "getAccountPackageById" | "updateAccountPackage" | "deleteAccountPackage" | "addSnippet" | "getLatestSnippets" | "getTrendingSnippets" | "getPackagesByAuthor" | "getSnippetByAuthorAndName" | "updateSnippet" | "getSnippetById" | "searchSnippets" | "searchPackages" | "deleteSnippet" | "addSession" | "getSessions" | "createLoginPage" | "getLoginPage" | "updateLoginPage" | "getAccount" | "updateAccount" | "createSession" | "addStar" | "removeStar" | "hasStarred" | "addPackage" | "updatePackage" | "getPackageById" | "getPackageReleaseById" | "addPackageRelease" | "updatePackageRelease" | "deletePackageFile" | "addPackageFile" | "updatePackageFile" | "getStarCount" | "getPackageFilesByReleaseId" | "updatePackageReleaseFsSha"> & {
+    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;
+    }[];
+}, "addOrder" | "getOrderById" | "getOrderFilesByOrderId" | "addOrderQuote" | "getOrderQuoteById" | "getJlcpcbOrderStatesByOrderId" | "getJlcpcbOrderStepRunsByJlcpcbOrderStateId" | "updateOrder" | "addJlcpcbOrderState" | "updateJlcpcbOrderState" | "addOrderFile" | "getOrderFileById" | "addAccount" | "addAccountPackage" | "getAccountPackageById" | "updateAccountPackage" | "deleteAccountPackage" | "addSnippet" | "getLatestSnippets" | "getTrendingSnippets" | "getPackagesByAuthor" | "getSnippetByAuthorAndName" | "updateSnippet" | "getSnippetById" | "searchSnippets" | "searchPackages" | "deleteSnippet" | "addSession" | "getSessions" | "createLoginPage" | "getLoginPage" | "updateLoginPage" | "getAccount" | "updateAccount" | "createSession" | "addStar" | "removeStar" | "hasStarred" | "addPackage" | "updatePackage" | "getPackageById" | "getPackageReleaseById" | "addPackageRelease" | "updatePackageRelease" | "deletePackageFile" | "addPackageFile" | "updatePackageFile" | "getStarCount" | "getPackageFilesByReleaseId" | "updatePackageReleaseFsSha" | "addAiReview" | "updateAiReview" | "getAiReviewById" | "listAiReviews"> & {
     addOrder: (order: Omit<Order, "order_id">) => Order;
     getOrderById: (orderId: string) => Order | undefined;
     getOrderFilesByOrderId: (orderId: string) => OrderFile[];
@@ -1367,6 +1415,10 @@ declare const createDatabase: ({ seed }?: {
      * Update fs_sha for a package release based on its files
      */
     updatePackageReleaseFsSha: (packageReleaseId: string) => void;
+    addAiReview: (review: Omit<AiReview, "ai_review_id">) => AiReview;
+    updateAiReview: (aiReviewId: string, updates: Partial<AiReview>) => AiReview | undefined;
+    getAiReviewById: (aiReviewId: string) => AiReview | undefined;
+    listAiReviews: () => AiReview[];
 };
 type DbClient = ReturnType<typeof createDatabase>;
 

package/dist/index.js

@@ -120,6 +120,15 @@ 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 accountSnippetSchema = z.object({
   account_id: z.string(),
   snippet_id: z.string(),
@@ -264,7 +273,8 @@ 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([])
 });
 
 // fake-snippets-api/lib/db/autoload-dev-packages.ts
@@ -3049,6 +3059,40 @@ var initializer = combine(databaseSchema.parse({}), (set, get) => ({
         (pkg) => pkg.latest_package_release_id === packageReleaseId ? { ...pkg, latest_package_release_fs_sha: fsSha } : pkg
       )
     }));
+  },
+  addAiReview: (review) => {
+    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, updates) => {
+    let updated;
+    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) => {
+    const state = get();
+    return state.aiReviews.find((ar) => ar.ai_review_id === aiReviewId);
+  },
+  listAiReviews: () => {
+    const state = get();
+    return state.aiReviews;
   }
 }));
 

package/dist/schema.d.ts

@@ -489,6 +489,32 @@ 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 accountSnippetSchema: z.ZodObject<{
     account_id: z.ZodString;
     snippet_id: z.ZodString;
@@ -570,11 +596,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 +610,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 +622,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 +633,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 +642,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 +655,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 +993,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 +1007,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 +1019,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 +1030,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 +1039,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 +1052,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 +1621,31 @@ 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">>;
 }, "strip", z.ZodTypeAny, {
     idCounter: number;
     snippets: {
@@ -1625,11 +1676,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 +1690,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 +1702,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 +1884,15 @@ 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;
+    }[];
 }, {
     idCounter?: number | undefined;
     snippets?: {
@@ -1866,6 +1926,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 +1935,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 +1948,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 +2131,16 @@ 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;
 }>;
 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 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, errorResponseSchema, errorSchema, jlcpcbOrderStateSchema, jlcpcbOrderStepRunSchema, loginPageSchema, orderFileSchema, orderQuoteSchema, orderSchema, packageFileSchema, packageReleaseSchema, packageSchema, quotedComponentSchema, sessionSchema, shippingInfoSchema, snippetSchema };

package/dist/schema.js

@@ -115,6 +115,15 @@ 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 accountSnippetSchema = z.object({
   account_id: z.string(),
   snippet_id: z.string(),
@@ -259,12 +268,14 @@ 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([])
 });
 export {
   accountPackageSchema,
   accountSchema,
   accountSnippetSchema,
+  aiReviewSchema,
   databaseSchema,
   errorResponseSchema,
   errorSchema,

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

@@ -16,6 +16,8 @@ import {
   type PackageFile,
   type PackageRelease,
   packageReleaseSchema,
+  type AiReview,
+  aiReviewSchema,
   type Session,
   type Snippet,
   databaseSchema,
@@ -1338,4 +1340,42 @@ 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
+  },
 }))

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

@@ -138,6 +138,17 @@ 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>
+
 // TODO: Remove this schema after migration to accountPackages is complete
 export const accountSnippetSchema = z.object({
   account_id: z.string(),
@@ -314,5 +325,6 @@ 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([]),
 })
 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 })
+})