@bubblelab/bubble-core 0.1.30 → 0.1.31

package/dist/bubbles/workflow-bubble/pdf-form-operations.workflow.d.ts

@@ -80,8 +80,8 @@ declare const PDFFormOperationsParamsSchema: z.ZodDiscriminatedUnion<"operation"
     pages: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
     credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    format: "png" | "jpeg";
     operation: "convert-to-images";
+    format: "png" | "jpeg";
     quality: number;
     pdfData: string;
     dpi: number;
@@ -137,8 +137,8 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         potential_labels: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
         type: string;
-        id: number;
         name: string;
+        id: number;
         width: number;
         height: number;
         label: string;
@@ -153,8 +153,8 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         potential_labels: string[];
     }, {
         type: string;
-        id: number;
         name: string;
+        id: number;
         width: number;
         height: number;
         label: string;
@@ -172,10 +172,11 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
     success: z.ZodBoolean;
     error: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    operation: "discover";
     fields: {
         type: string;
-        id: number;
         name: string;
+        id: number;
         width: number;
         height: number;
         label: string;
@@ -189,15 +190,15 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         field_flags: number;
         potential_labels: string[];
     }[];
-    operation: "discover";
     success: boolean;
     error: string;
     totalFields: number;
 }, {
+    operation: "discover";
     fields: {
         type: string;
-        id: number;
         name: string;
+        id: number;
         width: number;
         height: number;
         label: string;
@@ -211,7 +212,6 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         field_flags: number;
         potential_labels: string[];
     }[];
-    operation: "discover";
     success: boolean;
     error: string;
     totalFields: number;
@@ -320,24 +320,24 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
     success: z.ZodBoolean;
     error: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    operation: "validate";
     fields: Record<string, {
         value: string;
         type: string;
         page: number;
     }>;
-    operation: "validate";
     success: boolean;
     error: string;
     totalFields: number;
     filledFields: number;
     emptyFields: number;
 }, {
+    operation: "validate";
     fields: Record<string, {
         value: string;
         type: string;
         page: number;
     }>;
-    operation: "validate";
     success: boolean;
     error: string;
     totalFields: number;
@@ -410,15 +410,15 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         }, "strip", z.ZodTypeAny, {
             value: string;
             type: string;
-            id: number;
             name: string;
+            id: number;
             x: number;
             y: number;
         }, {
             value: string;
             type: string;
-            id: number;
             name: string;
+            id: number;
             x: number;
             y: number;
         }>, "many">>;
@@ -428,8 +428,8 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         formFields?: {
             value: string;
             type: string;
-            id: number;
             name: string;
+            id: number;
             x: number;
             y: number;
         }[] | undefined;
@@ -439,8 +439,8 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         formFields?: {
             value: string;
             type: string;
-            id: number;
             name: string;
+            id: number;
             x: number;
             y: number;
         }[] | undefined;
@@ -459,8 +459,8 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         formFields?: {
             value: string;
             type: string;
-            id: number;
             name: string;
+            id: number;
             x: number;
             y: number;
         }[] | undefined;
@@ -478,8 +478,8 @@ declare const PDFFormOperationsResultSchema: z.ZodDiscriminatedUnion<"operation"
         formFields?: {
             value: string;
             type: string;
-            id: number;
             name: string;
+            id: number;
             x: number;
             y: number;
         }[] | undefined;
@@ -562,8 +562,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
         pages: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
         credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        format: "png" | "jpeg";
         operation: "convert-to-images";
+        format: "png" | "jpeg";
         quality: number;
         pdfData: string;
         dpi: number;
@@ -616,8 +616,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             potential_labels: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
             type: string;
-            id: number;
             name: string;
+            id: number;
             width: number;
             height: number;
             label: string;
@@ -632,8 +632,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             potential_labels: string[];
         }, {
             type: string;
-            id: number;
             name: string;
+            id: number;
             width: number;
             height: number;
             label: string;
@@ -651,10 +651,11 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
         success: z.ZodBoolean;
         error: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        operation: "discover";
         fields: {
             type: string;
-            id: number;
             name: string;
+            id: number;
             width: number;
             height: number;
             label: string;
@@ -668,15 +669,15 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             field_flags: number;
             potential_labels: string[];
         }[];
-        operation: "discover";
         success: boolean;
         error: string;
         totalFields: number;
     }, {
+        operation: "discover";
         fields: {
             type: string;
-            id: number;
             name: string;
+            id: number;
             width: number;
             height: number;
             label: string;
@@ -690,7 +691,6 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             field_flags: number;
             potential_labels: string[];
         }[];
-        operation: "discover";
         success: boolean;
         error: string;
         totalFields: number;
@@ -799,24 +799,24 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
         success: z.ZodBoolean;
         error: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        operation: "validate";
         fields: Record<string, {
             value: string;
             type: string;
             page: number;
         }>;
-        operation: "validate";
         success: boolean;
         error: string;
         totalFields: number;
         filledFields: number;
         emptyFields: number;
     }, {
+        operation: "validate";
         fields: Record<string, {
             value: string;
             type: string;
             page: number;
         }>;
-        operation: "validate";
         success: boolean;
         error: string;
         totalFields: number;
@@ -889,15 +889,15 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             }, "strip", z.ZodTypeAny, {
                 value: string;
                 type: string;
-                id: number;
                 name: string;
+                id: number;
                 x: number;
                 y: number;
             }, {
                 value: string;
                 type: string;
-                id: number;
                 name: string;
+                id: number;
                 x: number;
                 y: number;
             }>, "many">>;
@@ -907,8 +907,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             formFields?: {
                 value: string;
                 type: string;
-                id: number;
                 name: string;
+                id: number;
                 x: number;
                 y: number;
             }[] | undefined;
@@ -918,8 +918,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             formFields?: {
                 value: string;
                 type: string;
-                id: number;
                 name: string;
+                id: number;
                 x: number;
                 y: number;
             }[] | undefined;
@@ -938,8 +938,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             formFields?: {
                 value: string;
                 type: string;
-                id: number;
                 name: string;
+                id: number;
                 x: number;
                 y: number;
             }[] | undefined;
@@ -957,8 +957,8 @@ export declare class PDFFormOperationsWorkflow<T extends PDFFormOperationsParams
             formFields?: {
                 value: string;
                 type: string;
-                id: number;
                 name: string;
+                id: number;
                 x: number;
                 y: number;
             }[] | undefined;

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-01-22T22:25:52.225Z",
+  "generatedAt": "2026-01-22T22:33:26.097Z",
   "totalCount": 54,
   "bubbles": [
     {
@@ -53543,7 +53543,8 @@
                                     "nullable": true
                                   },
                                   "body": {
-                                    "description": "Comment body (ADF format or plain text)"
+                                    "type": "string",
+                                    "description": "Comment body as plain text"
                                   },
                                   "renderedBody": {
                                     "type": "string",
@@ -53953,7 +53954,8 @@
                                   "nullable": true
                                 },
                                 "body": {
-                                  "description": "Comment body (ADF format or plain text)"
+                                  "type": "string",
+                                  "description": "Comment body as plain text"
                                 },
                                 "renderedBody": {
                                   "type": "string",
@@ -54428,7 +54430,8 @@
                     "nullable": true
                   },
                   "body": {
-                    "description": "Comment body (ADF format or plain text)"
+                    "type": "string",
+                    "description": "Comment body as plain text"
                   },
                   "renderedBody": {
                     "type": "string",
@@ -54511,7 +54514,8 @@
                       "nullable": true
                     },
                     "body": {
-                      "description": "Comment body (ADF format or plain text)"
+                      "type": "string",
+                      "description": "Comment body as plain text"
                     },
                     "renderedBody": {
                       "type": "string",
@@ -54552,7 +54556,7 @@
           }
         ]
       },
-      "usageExample": "// Search example\nconst jira_search = new JiraBubble({\n  operation: \"search\", // Search for issues using JQL query\n  jql: \"example string\", // JQL query string. Examples: \"project = PROJ\", \"assignee = currentUser()\", \"status = Open AND created >= -7d\"\n  limit: 50 // default, // Maximum number of issues to return (1-100)\n  offset: 0 // default, // Starting index for pagination\n  fields: [\"example string\"], // Specific fields to return (e.g., [\"summary\", \"status\", \"assignee\"]). Default: all standard fields\n});\n\nconst result = await jira_search.action();\n// outputSchema for result.data when operation === 'search':\n// {\n//   operation: \"search\",\n//   success: boolean // Whether the operation was successful,\n//   issues: { id: string // Issue ID, key: string // Issue key (e.g., \"PROJ-123\"), self: string | undefined // Issue API URL, fields: { summary: string | undefined // Issue title/summary, description: unknown | undefined // Issue description (ADF format), status: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Current status, priority: { id: string // Priority ID, name: string // Priority name } | null | undefined // Issue priority (null if not assigned), assignee: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Assigned user, reporter: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Reporter user (null if deleted or anonymized), issuetype: { id: string // Issue type ID, name: string // Issue type name (e.g., \"Task\", \"Bug\", \"Story\"), description: string | undefined // Issue type description, subtask: boolean | undefined // Whether this is a subtask type } | undefined // Issue type, project: { id: string // Project ID, key: string // Project key (e.g., \"PROJ\"), name: string // Project name } | undefined // Project, labels: string[] | undefined // Issue labels, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp, duedate: string | null | undefined // Due date (YYYY-MM-DD), parent: { id: string, key: string } | undefined // Parent issue (for subtasks), comment: { comments: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: unknown | undefined // Comment body (ADF format or plain text), renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp }[] | undefined, total: number | undefined } | undefined // Issue comments } // Issue fields, transitions: { id: string // Transition ID, name: string // Transition name (e.g., \"Start Progress\", \"Done\"), to: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Target status }[] | undefined // Available transitions, changelog: unknown | undefined // Issue changelog }[] | undefined // Found issues,\n//   total: number | undefined // Total matching issues,\n//   offset: number | undefined // Current offset,\n//   limit: number | undefined // Requested limit,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get example\nconst jira_get = new JiraBubble({\n  operation: \"get\", // Get details for a specific issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\") or issue ID\n  fields: [\"example string\"], // Specific fields to return. Default: all fields\n  expand: [\"changelog\" // options: \"changelog\", \"comments\", \"transitions\"], // Additional data to include\n});\n\nconst result = await jira_get.action();\n// outputSchema for result.data when operation === 'get':\n// {\n//   operation: \"get\",\n//   success: boolean // Whether the operation was successful,\n//   issue: { id: string // Issue ID, key: string // Issue key (e.g., \"PROJ-123\"), self: string | undefined // Issue API URL, fields: { summary: string | undefined // Issue title/summary, description: unknown | undefined // Issue description (ADF format), status: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Current status, priority: { id: string // Priority ID, name: string // Priority name } | null | undefined // Issue priority (null if not assigned), assignee: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Assigned user, reporter: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Reporter user (null if deleted or anonymized), issuetype: { id: string // Issue type ID, name: string // Issue type name (e.g., \"Task\", \"Bug\", \"Story\"), description: string | undefined // Issue type description, subtask: boolean | undefined // Whether this is a subtask type } | undefined // Issue type, project: { id: string // Project ID, key: string // Project key (e.g., \"PROJ\"), name: string // Project name } | undefined // Project, labels: string[] | undefined // Issue labels, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp, duedate: string | null | undefined // Due date (YYYY-MM-DD), parent: { id: string, key: string } | undefined // Parent issue (for subtasks), comment: { comments: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: unknown | undefined // Comment body (ADF format or plain text), renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp }[] | undefined, total: number | undefined } | undefined // Issue comments } // Issue fields, transitions: { id: string // Transition ID, name: string // Transition name (e.g., \"Start Progress\", \"Done\"), to: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Target status }[] | undefined // Available transitions, changelog: unknown | undefined // Issue changelog } | undefined // Issue details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create example\nconst jira_create = new JiraBubble({\n  operation: \"create\", // Create a new issue in Jira\n  project: \"example string\", // Project key (e.g., \"PROJ\")\n  summary: \"example string\", // Issue title/summary (max 255 chars)\n  type: \"Task\" // default, // Issue type: \"Task\", \"Bug\", \"Story\", \"Epic\", etc. Default: \"Task\"\n  description: \"example string\", // Issue description (plain text - auto-converted to ADF)\n  assignee: \"example string\", // Assignee account ID or email. Leave empty for unassigned\n  priority: \"Highest\" // options: \"Highest\", \"High\", \"Medium\", \"Low\", \"Lowest\", // Issue priority. Default: uses project default\n  labels: [\"example string\"], // Labels to apply (e.g., [\"bug\", \"urgent\"])\n  parent: \"example string\", // Parent issue key for subtasks (e.g., \"PROJ-100\")\n  due_date: \"example string\", // Due date in YYYY-MM-DD format\n});\n\nconst result = await jira_create.action();\n// outputSchema for result.data when operation === 'create':\n// {\n//   operation: \"create\",\n//   success: boolean // Whether the operation was successful,\n//   issue: { id: string // Created issue ID, key: string // Created issue key, self: string | undefined // Issue API URL } | undefined // Created issue info,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update example\nconst jira_update = new JiraBubble({\n  operation: \"update\", // Update an existing issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\") or issue ID\n  summary: \"example string\", // New issue title\n  description: \"example string\", // New description (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n  assignee: \"example string\", // New assignee (account ID/email) or null to unassign\n  priority: \"Highest\" // options: \"Highest\", \"High\", \"Medium\", \"Low\", \"Lowest\", // New priority\n  labels: { add: [\"example string\"] // Labels to add to the issue, remove: [\"example string\"] // Labels to remove from the issue, set: [\"example string\"] // Replace all labels with these (overrides add/remove) }, // Label modifications\n  due_date: \"example string\", // New due date (YYYY-MM-DD) or null to clear\n  comment: \"example string\", // Add a comment with this update (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n});\n\nconst result = await jira_update.action();\n// outputSchema for result.data when operation === 'update':\n// {\n//   operation: \"update\",\n//   success: boolean // Whether the operation was successful,\n//   key: string | undefined // Updated issue key,\n//   error: string // Error message if operation failed\n// }\n\n\n// Transition example\nconst jira_transition = new JiraBubble({\n  operation: \"transition\", // Transition issue to a new status\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n  status: \"example string\", // Target status NAME (e.g., \"In Progress\", \"Done\"). Finds matching transition automatically\n  transition_id: \"example string\", // Specific transition ID (from list_transitions). Use when status name is ambiguous\n  comment: \"example string\", // Comment to add with the transition (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n  resolution: \"example string\", // Resolution when closing (e.g., \"Fixed\", \"Won't Fix\", \"Duplicate\")\n});\n\nconst result = await jira_transition.action();\n// outputSchema for result.data when operation === 'transition':\n// {\n//   operation: \"transition\",\n//   success: boolean // Whether the operation was successful,\n//   key: string | undefined // Transitioned issue key,\n//   new_status: string | undefined // New status name,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Transitions example\nconst jira_list_transitions = new JiraBubble({\n  operation: \"list_transitions\", // Get available transitions for an issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n});\n\nconst result = await jira_list_transitions.action();\n// outputSchema for result.data when operation === 'list_transitions':\n// {\n//   operation: \"list_transitions\",\n//   success: boolean // Whether the operation was successful,\n//   transitions: { id: string // Transition ID, name: string // Transition name (e.g., \"Start Progress\", \"Done\"), to: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Target status }[] | undefined // Available transitions,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Projects example\nconst jira_list_projects = new JiraBubble({\n  operation: \"list_projects\", // List available Jira projects\n  limit: 50 // default, // Maximum number of projects to return\n  offset: 0 // default, // Starting index for pagination\n});\n\nconst result = await jira_list_projects.action();\n// outputSchema for result.data when operation === 'list_projects':\n// {\n//   operation: \"list_projects\",\n//   success: boolean // Whether the operation was successful,\n//   projects: { id: string // Project ID, key: string // Project key (e.g., \"PROJ\"), name: string // Project name }[] | undefined // Available projects,\n//   total: number | undefined // Total projects,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Issue Types example\nconst jira_list_issue_types = new JiraBubble({\n  operation: \"list_issue_types\", // List issue types for a project\n  project: \"example string\", // Project key (e.g., \"PROJ\")\n});\n\nconst result = await jira_list_issue_types.action();\n// outputSchema for result.data when operation === 'list_issue_types':\n// {\n//   operation: \"list_issue_types\",\n//   success: boolean // Whether the operation was successful,\n//   issue_types: { id: string // Issue type ID, name: string // Issue type name (e.g., \"Task\", \"Bug\", \"Story\"), description: string | undefined // Issue type description, subtask: boolean | undefined // Whether this is a subtask type }[] | undefined // Available issue types,\n//   error: string // Error message if operation failed\n// }\n\n\n// Add Comment example\nconst jira_add_comment = new JiraBubble({\n  operation: \"add_comment\", // Add a comment to an issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n  body: \"example string\", // Comment text (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n});\n\nconst result = await jira_add_comment.action();\n// outputSchema for result.data when operation === 'add_comment':\n// {\n//   operation: \"add_comment\",\n//   success: boolean // Whether the operation was successful,\n//   comment: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: unknown | undefined // Comment body (ADF format or plain text), renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp } | undefined // Created comment,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Comments example\nconst jira_get_comments = new JiraBubble({\n  operation: \"get_comments\", // Get comments for an issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n  limit: 50 // default, // Maximum number of comments to return\n  offset: 0 // default, // Starting index for pagination\n});\n\nconst result = await jira_get_comments.action();\n// outputSchema for result.data when operation === 'get_comments':\n// {\n//   operation: \"get_comments\",\n//   success: boolean // Whether the operation was successful,\n//   comments: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: unknown | undefined // Comment body (ADF format or plain text), renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp }[] | undefined // Issue comments,\n//   total: number | undefined // Total comments,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`jira failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// Search example\nconst jira_search = new JiraBubble({\n  operation: \"search\", // Search for issues using JQL query\n  jql: \"example string\", // JQL query string. Examples: \"project = PROJ\", \"assignee = currentUser()\", \"status = Open AND created >= -7d\"\n  limit: 50 // default, // Maximum number of issues to return (1-100)\n  offset: 0 // default, // Starting index for pagination\n  fields: [\"example string\"], // Specific fields to return (e.g., [\"summary\", \"status\", \"assignee\"]). Default: all standard fields\n});\n\nconst result = await jira_search.action();\n// outputSchema for result.data when operation === 'search':\n// {\n//   operation: \"search\",\n//   success: boolean // Whether the operation was successful,\n//   issues: { id: string // Issue ID, key: string // Issue key (e.g., \"PROJ-123\"), self: string | undefined // Issue API URL, fields: { summary: string | undefined // Issue title/summary, description: unknown | undefined // Issue description (ADF format), status: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Current status, priority: { id: string // Priority ID, name: string // Priority name } | null | undefined // Issue priority (null if not assigned), assignee: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Assigned user, reporter: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Reporter user (null if deleted or anonymized), issuetype: { id: string // Issue type ID, name: string // Issue type name (e.g., \"Task\", \"Bug\", \"Story\"), description: string | undefined // Issue type description, subtask: boolean | undefined // Whether this is a subtask type } | undefined // Issue type, project: { id: string // Project ID, key: string // Project key (e.g., \"PROJ\"), name: string // Project name } | undefined // Project, labels: string[] | undefined // Issue labels, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp, duedate: string | null | undefined // Due date (YYYY-MM-DD), parent: { id: string, key: string } | undefined // Parent issue (for subtasks), comment: { comments: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: string | undefined // Comment body as plain text, renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp }[] | undefined, total: number | undefined } | undefined // Issue comments } // Issue fields, transitions: { id: string // Transition ID, name: string // Transition name (e.g., \"Start Progress\", \"Done\"), to: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Target status }[] | undefined // Available transitions, changelog: unknown | undefined // Issue changelog }[] | undefined // Found issues,\n//   total: number | undefined // Total matching issues,\n//   offset: number | undefined // Current offset,\n//   limit: number | undefined // Requested limit,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get example\nconst jira_get = new JiraBubble({\n  operation: \"get\", // Get details for a specific issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\") or issue ID\n  fields: [\"example string\"], // Specific fields to return. Default: all fields\n  expand: [\"changelog\" // options: \"changelog\", \"comments\", \"transitions\"], // Additional data to include\n});\n\nconst result = await jira_get.action();\n// outputSchema for result.data when operation === 'get':\n// {\n//   operation: \"get\",\n//   success: boolean // Whether the operation was successful,\n//   issue: { id: string // Issue ID, key: string // Issue key (e.g., \"PROJ-123\"), self: string | undefined // Issue API URL, fields: { summary: string | undefined // Issue title/summary, description: unknown | undefined // Issue description (ADF format), status: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Current status, priority: { id: string // Priority ID, name: string // Priority name } | null | undefined // Issue priority (null if not assigned), assignee: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Assigned user, reporter: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Reporter user (null if deleted or anonymized), issuetype: { id: string // Issue type ID, name: string // Issue type name (e.g., \"Task\", \"Bug\", \"Story\"), description: string | undefined // Issue type description, subtask: boolean | undefined // Whether this is a subtask type } | undefined // Issue type, project: { id: string // Project ID, key: string // Project key (e.g., \"PROJ\"), name: string // Project name } | undefined // Project, labels: string[] | undefined // Issue labels, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp, duedate: string | null | undefined // Due date (YYYY-MM-DD), parent: { id: string, key: string } | undefined // Parent issue (for subtasks), comment: { comments: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: string | undefined // Comment body as plain text, renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp }[] | undefined, total: number | undefined } | undefined // Issue comments } // Issue fields, transitions: { id: string // Transition ID, name: string // Transition name (e.g., \"Start Progress\", \"Done\"), to: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Target status }[] | undefined // Available transitions, changelog: unknown | undefined // Issue changelog } | undefined // Issue details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create example\nconst jira_create = new JiraBubble({\n  operation: \"create\", // Create a new issue in Jira\n  project: \"example string\", // Project key (e.g., \"PROJ\")\n  summary: \"example string\", // Issue title/summary (max 255 chars)\n  type: \"Task\" // default, // Issue type: \"Task\", \"Bug\", \"Story\", \"Epic\", etc. Default: \"Task\"\n  description: \"example string\", // Issue description (plain text - auto-converted to ADF)\n  assignee: \"example string\", // Assignee account ID or email. Leave empty for unassigned\n  priority: \"Highest\" // options: \"Highest\", \"High\", \"Medium\", \"Low\", \"Lowest\", // Issue priority. Default: uses project default\n  labels: [\"example string\"], // Labels to apply (e.g., [\"bug\", \"urgent\"])\n  parent: \"example string\", // Parent issue key for subtasks (e.g., \"PROJ-100\")\n  due_date: \"example string\", // Due date in YYYY-MM-DD format\n});\n\nconst result = await jira_create.action();\n// outputSchema for result.data when operation === 'create':\n// {\n//   operation: \"create\",\n//   success: boolean // Whether the operation was successful,\n//   issue: { id: string // Created issue ID, key: string // Created issue key, self: string | undefined // Issue API URL } | undefined // Created issue info,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update example\nconst jira_update = new JiraBubble({\n  operation: \"update\", // Update an existing issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\") or issue ID\n  summary: \"example string\", // New issue title\n  description: \"example string\", // New description (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n  assignee: \"example string\", // New assignee (account ID/email) or null to unassign\n  priority: \"Highest\" // options: \"Highest\", \"High\", \"Medium\", \"Low\", \"Lowest\", // New priority\n  labels: { add: [\"example string\"] // Labels to add to the issue, remove: [\"example string\"] // Labels to remove from the issue, set: [\"example string\"] // Replace all labels with these (overrides add/remove) }, // Label modifications\n  due_date: \"example string\", // New due date (YYYY-MM-DD) or null to clear\n  comment: \"example string\", // Add a comment with this update (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n});\n\nconst result = await jira_update.action();\n// outputSchema for result.data when operation === 'update':\n// {\n//   operation: \"update\",\n//   success: boolean // Whether the operation was successful,\n//   key: string | undefined // Updated issue key,\n//   error: string // Error message if operation failed\n// }\n\n\n// Transition example\nconst jira_transition = new JiraBubble({\n  operation: \"transition\", // Transition issue to a new status\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n  status: \"example string\", // Target status NAME (e.g., \"In Progress\", \"Done\"). Finds matching transition automatically\n  transition_id: \"example string\", // Specific transition ID (from list_transitions). Use when status name is ambiguous\n  comment: \"example string\", // Comment to add with the transition (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n  resolution: \"example string\", // Resolution when closing (e.g., \"Fixed\", \"Won't Fix\", \"Duplicate\")\n});\n\nconst result = await jira_transition.action();\n// outputSchema for result.data when operation === 'transition':\n// {\n//   operation: \"transition\",\n//   success: boolean // Whether the operation was successful,\n//   key: string | undefined // Transitioned issue key,\n//   new_status: string | undefined // New status name,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Transitions example\nconst jira_list_transitions = new JiraBubble({\n  operation: \"list_transitions\", // Get available transitions for an issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n});\n\nconst result = await jira_list_transitions.action();\n// outputSchema for result.data when operation === 'list_transitions':\n// {\n//   operation: \"list_transitions\",\n//   success: boolean // Whether the operation was successful,\n//   transitions: { id: string // Transition ID, name: string // Transition name (e.g., \"Start Progress\", \"Done\"), to: { id: string // Status ID, name: string // Status name (e.g., \"To Do\", \"In Progress\", \"Done\"), statusCategory: { key: string // Category key, name: string // Category name } | undefined // Status category } | undefined // Target status }[] | undefined // Available transitions,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Projects example\nconst jira_list_projects = new JiraBubble({\n  operation: \"list_projects\", // List available Jira projects\n  limit: 50 // default, // Maximum number of projects to return\n  offset: 0 // default, // Starting index for pagination\n});\n\nconst result = await jira_list_projects.action();\n// outputSchema for result.data when operation === 'list_projects':\n// {\n//   operation: \"list_projects\",\n//   success: boolean // Whether the operation was successful,\n//   projects: { id: string // Project ID, key: string // Project key (e.g., \"PROJ\"), name: string // Project name }[] | undefined // Available projects,\n//   total: number | undefined // Total projects,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Issue Types example\nconst jira_list_issue_types = new JiraBubble({\n  operation: \"list_issue_types\", // List issue types for a project\n  project: \"example string\", // Project key (e.g., \"PROJ\")\n});\n\nconst result = await jira_list_issue_types.action();\n// outputSchema for result.data when operation === 'list_issue_types':\n// {\n//   operation: \"list_issue_types\",\n//   success: boolean // Whether the operation was successful,\n//   issue_types: { id: string // Issue type ID, name: string // Issue type name (e.g., \"Task\", \"Bug\", \"Story\"), description: string | undefined // Issue type description, subtask: boolean | undefined // Whether this is a subtask type }[] | undefined // Available issue types,\n//   error: string // Error message if operation failed\n// }\n\n\n// Add Comment example\nconst jira_add_comment = new JiraBubble({\n  operation: \"add_comment\", // Add a comment to an issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n  body: \"example string\", // Comment text (markdown or plain text - auto-converted to ADF). Supports: **bold**, *italic*, `code`, [links](url), # headings, lists, > blockquotes, ``` code blocks ```, ~~strikethrough~~\n});\n\nconst result = await jira_add_comment.action();\n// outputSchema for result.data when operation === 'add_comment':\n// {\n//   operation: \"add_comment\",\n//   success: boolean // Whether the operation was successful,\n//   comment: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: string | undefined // Comment body as plain text, renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp } | undefined // Created comment,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Comments example\nconst jira_get_comments = new JiraBubble({\n  operation: \"get_comments\", // Get comments for an issue\n  key: \"example string\", // Issue key (e.g., \"PROJ-123\")\n  limit: 50 // default, // Maximum number of comments to return\n  offset: 0 // default, // Starting index for pagination\n});\n\nconst result = await jira_get_comments.action();\n// outputSchema for result.data when operation === 'get_comments':\n// {\n//   operation: \"get_comments\",\n//   success: boolean // Whether the operation was successful,\n//   comments: { id: string // Comment ID, author: { accountId: string // User account ID, displayName: string | undefined // User display name, emailAddress: string | undefined // User email address, active: boolean | undefined // Whether the user is active } | null | undefined // Comment author (null if deleted or anonymized), body: string | undefined // Comment body as plain text, renderedBody: string | undefined // Comment body as rendered HTML, created: string | undefined // Creation timestamp, updated: string | undefined // Last update timestamp }[] | undefined // Issue comments,\n//   total: number | undefined // Total comments,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`jira failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "JIRA_CRED"
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblelab/bubble-core",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
     "puppeteer-core": "^24.10.0",
     "resend": "^4.8.0",
     "zod": "^3.24.1",
-    "@bubblelab/shared-schemas": "0.1.31"
+    "@bubblelab/shared-schemas": "0.1.32"
   },
   "devDependencies": {
     "zod-to-json-schema": "^3.24.6",