@cossistant/types 0.1.1 → 0.1.2

package/api/timeline-item.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-item.js","names":[],"sources":["../../src/api/timeline-item.ts"],"sourcesContent":["import { z } from \"@hono/zod-openapi\";\n\nimport {\n\tConversationEventType,\n\tConversationTimelineType,\n\tTimelineItemVisibility,\n} from \"../enums\";\nimport { TOOL_TIMELINE_LOG_TYPE } from \"../tool-timeline-policy\";\n\n// ============================================================================\n// AI SDK v6 COMPATIBLE PART SCHEMAS\n// These follow Vercel AI SDK v6 patterns for UIMessagePart types.\n// Cossistant extensions use providerMetadata/callProviderMetadata.cossistant namespace.\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Cossistant Provider Metadata (extension point for all parts)\n// ----------------------------------------------------------------------------\nconst cossistantToolTimelineMetadataSchema = z.object({\n\tlogType: z\n\t\t.enum([\n\t\t\tTOOL_TIMELINE_LOG_TYPE.CUSTOMER_FACING,\n\t\t\tTOOL_TIMELINE_LOG_TYPE.LOG,\n\t\t\tTOOL_TIMELINE_LOG_TYPE.DECISION,\n\t\t])\n\t\t.openapi({\n\t\t\tdescription:\n\t\t\t\t\"Tool timeline classification: conversation-visible, log-only, or decision stage\",\n\t\t}),\n\ttriggerMessageId: z.string().openapi({\n\t\tdescription:\n\t\t\t\"Message ID that triggered the tool/decision workflow execution\",\n\t}),\n\tworkflowRunId: z.string().openapi({\n\t\tdescription:\n\t\t\t\"Workflow run identifier used to correlate tool timeline updates\",\n\t}),\n\ttriggerVisibility: z.enum([\"public\", \"private\"]).optional().openapi({\n\t\tdescription:\n\t\t\t\"Visibility of the trigger message at the time the tool was executed\",\n\t}),\n});\n\nconst cossistantProviderMetadataSchema = z\n\t.object({\n\t\tcossistant: z\n\t\t\t.object({\n\t\t\t\tvisibility: z.enum([\"public\", \"private\"]).optional().openapi({\n\t\t\t\t\tdescription: \"Part-level visibility control for filtering\",\n\t\t\t\t}),\n\t\t\t\tprogressMessage: z.string().optional().openapi({\n\t\t\t\t\tdescription: \"Custom progress message to display during execution\",\n\t\t\t\t}),\n\t\t\t\tknowledgeId: z.string().optional().openapi({\n\t\t\t\t\tdescription: \"Reference to a Cossistant knowledge entry\",\n\t\t\t\t}),\n\t\t\t\ttoolTimeline: cossistantToolTimelineMetadataSchema.optional().openapi({\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Tool timeline metadata used to classify visibility and trigger linkage\",\n\t\t\t\t}),\n\t\t\t})\n\t\t\t.optional(),\n\t})\n\t.passthrough()\n\t.optional();\n\n// ----------------------------------------------------------------------------\n// TEXT PART (AI SDK compatible)\n// ----------------------------------------------------------------------------\nconst textPartSchema = z.object({\n\ttype: z.literal(\"text\").openapi({\n\t\tdescription: \"Text content part - matches AI SDK TextUIPart\",\n\t}),\n\ttext: z.string().openapi({\n\t\tdescription: \"The text content\",\n\t}),\n\tstate: z.enum([\"streaming\", \"done\"]).optional().openapi({\n\t\tdescription:\n\t\t\t\"AI SDK state: 'streaming' = still processing, 'done' = complete\",\n\t}),\n});\n\n// ----------------------------------------------------------------------------\n// REASONING PART (AI SDK compatible - for AI chain-of-thought)\n// ----------------------------------------------------------------------------\nconst reasoningPartSchema = z.object({\n\ttype: z.literal(\"reasoning\").openapi({\n\t\tdescription:\n\t\t\t\"AI reasoning/chain-of-thought - matches AI SDK ReasoningUIPart\",\n\t}),\n\ttext: z.string().openapi({\n\t\tdescription: \"The reasoning text content\",\n\t}),\n\tstate: z.enum([\"streaming\", \"done\"]).optional().openapi({\n\t\tdescription:\n\t\t\t\"AI SDK state: 'streaming' = still processing, 'done' = complete\",\n\t}),\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// TOOL PART (AI SDK compatible - for tool invocations)\n// AI SDK uses type: `tool-${toolName}` pattern, but we use a generic schema\n// with toolName field for flexibility. Type checking happens at runtime.\n// ----------------------------------------------------------------------------\nconst toolStateSchema = z.enum([\"partial\", \"result\", \"error\"]).openapi({\n\tdescription:\n\t\t\"AI SDK tool state: 'partial' = executing, 'result' = success, 'error' = failed\",\n});\n\nconst toolPartSchema = z.object({\n\ttype: z\n\t\t.string()\n\t\t.regex(/^tool-.+$/)\n\t\t.openapi({\n\t\t\tdescription: \"Tool type following AI SDK pattern: tool-{toolName}\",\n\t\t}),\n\ttoolCallId: z.string().openapi({\n\t\tdescription: \"Unique identifier for this tool invocation\",\n\t}),\n\ttoolName: z.string().openapi({\n\t\tdescription: \"Name of the tool being invoked\",\n\t}),\n\tinput: z.record(z.string(), z.unknown()).openapi({\n\t\tdescription: \"Input parameters passed to the tool\",\n\t}),\n\toutput: z.unknown().optional().openapi({\n\t\tdescription: \"Output returned by the tool (when state is 'result')\",\n\t}),\n\tstate: toolStateSchema,\n\terrorText: z.string().optional().openapi({\n\t\tdescription: \"Error message when state is 'error'\",\n\t}),\n\tcallProviderMetadata: cossistantProviderMetadataSchema,\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// SOURCE URL PART (AI SDK compatible - for citations)\n// ----------------------------------------------------------------------------\nconst sourceUrlPartSchema = z.object({\n\ttype: z.literal(\"source-url\").openapi({\n\t\tdescription: \"URL source citation - matches AI SDK SourceUrlUIPart\",\n\t}),\n\tsourceId: z.string().openapi({\n\t\tdescription: \"Unique identifier for this source\",\n\t}),\n\turl: z.string().url().openapi({\n\t\tdescription: \"URL of the source\",\n\t}),\n\ttitle: z.string().optional().openapi({\n\t\tdescription: \"Title of the source\",\n\t}),\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// SOURCE DOCUMENT PART (AI SDK compatible - for document citations)\n// ----------------------------------------------------------------------------\nconst sourceDocumentPartSchema = z.object({\n\ttype: z.literal(\"source-document\").openapi({\n\t\tdescription:\n\t\t\t\"Document source citation - matches AI SDK SourceDocumentUIPart\",\n\t}),\n\tsourceId: z.string().openapi({\n\t\tdescription: \"Unique identifier for this source\",\n\t}),\n\tmediaType: z.string().openapi({\n\t\tdescription: \"IANA media type of the document\",\n\t}),\n\ttitle: z.string().openapi({\n\t\tdescription: \"Title of the document\",\n\t}),\n\tfilename: z.string().optional().openapi({\n\t\tdescription: \"Filename of the document\",\n\t}),\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// STEP START PART (AI SDK compatible - for multi-step boundaries)\n// ----------------------------------------------------------------------------\nconst stepStartPartSchema = z.object({\n\ttype: z.literal(\"step-start\").openapi({\n\t\tdescription: \"Step boundary marker - matches AI SDK StepStartUIPart\",\n\t}),\n});\n\n// ----------------------------------------------------------------------------\n// FILE PART (AI SDK compatible)\n// ----------------------------------------------------------------------------\nconst filePartSchema = z.object({\n\ttype: z.literal(\"file\").openapi({\n\t\tdescription: \"File attachment - matches AI SDK FileUIPart\",\n\t}),\n\turl: z.string().openapi({\n\t\tdescription: \"URL of the file (can be hosted URL or Data URL)\",\n\t}),\n\tmediaType: z.string().openapi({\n\t\tdescription: \"IANA media type of the file\",\n\t}),\n\tfilename: z.string().optional().openapi({\n\t\tdescription: \"Original filename\",\n\t}),\n\t// Cossistant extension: additional file metadata\n\tsize: z.number().optional().openapi({\n\t\tdescription: \"Size of the file in bytes\",\n\t}),\n});\n\n// ----------------------------------------------------------------------------\n// IMAGE PART (Cossistant extension - more detailed than AI SDK file)\n// ----------------------------------------------------------------------------\nconst imagePartSchema = z.object({\n\ttype: z.literal(\"image\").openapi({\n\t\tdescription: \"Image attachment with dimensions\",\n\t}),\n\turl: z.string().openapi({\n\t\tdescription: \"URL of the image\",\n\t}),\n\tmediaType: z.string().openapi({\n\t\tdescription: \"IANA media type of the image\",\n\t}),\n\t// Use lowercase 'filename' for AI SDK consistency\n\t// Note: Legacy data may have 'fileName' - conversion utilities handle both\n\tfilename: z.string().optional().openapi({\n\t\tdescription: \"Original filename of the image\",\n\t}),\n\tsize: z.number().optional().openapi({\n\t\tdescription: \"Size of the image in bytes\",\n\t}),\n\twidth: z.number().optional().openapi({\n\t\tdescription: \"Width of the image in pixels\",\n\t}),\n\theight: z.number().optional().openapi({\n\t\tdescription: \"Height of the image in pixels\",\n\t}),\n});\n\n// ============================================================================\n// COSSISTANT-SPECIFIC PART SCHEMAS\n// These are Cossistant-specific parts not in AI SDK\n// ============================================================================\n\nconst timelinePartEventSchema = z.object({\n\ttype: z.literal(\"event\").openapi({\n\t\tdescription: \"Type of timeline part - always 'event' for event parts\",\n\t}),\n\teventType: z\n\t\t.enum([\n\t\t\tConversationEventType.ASSIGNED,\n\t\t\tConversationEventType.UNASSIGNED,\n\t\t\tConversationEventType.PARTICIPANT_REQUESTED,\n\t\t\tConversationEventType.PARTICIPANT_JOINED,\n\t\t\tConversationEventType.PARTICIPANT_LEFT,\n\t\t\tConversationEventType.STATUS_CHANGED,\n\t\t\tConversationEventType.PRIORITY_CHANGED,\n\t\t\tConversationEventType.TAG_ADDED,\n\t\t\tConversationEventType.TAG_REMOVED,\n\t\t\tConversationEventType.RESOLVED,\n\t\t\tConversationEventType.REOPENED,\n\t\t\tConversationEventType.VISITOR_BLOCKED,\n\t\t\tConversationEventType.VISITOR_UNBLOCKED,\n\t\t\tConversationEventType.VISITOR_IDENTIFIED,\n\t\t])\n\t\t.openapi({\n\t\t\tdescription: \"Type of event that occurred\",\n\t\t}),\n\tactorUserId: z.string().nullable().openapi({\n\t\tdescription: \"User that triggered the event, if applicable\",\n\t}),\n\tactorAiAgentId: z.string().nullable().openapi({\n\t\tdescription: \"AI agent that triggered the event, if applicable\",\n\t}),\n\ttargetUserId: z.string().nullable().openapi({\n\t\tdescription: \"User targeted by the event, if applicable\",\n\t}),\n\ttargetAiAgentId: z.string().nullable().openapi({\n\t\tdescription: \"AI agent targeted by the event, if applicable\",\n\t}),\n\tmessage: z.string().nullable().optional().openapi({\n\t\tdescription: \"Optional human readable message attached to the event\",\n\t}),\n});\n\nconst timelinePartMetadataSchema = z.object({\n\ttype: z.literal(\"metadata\").openapi({\n\t\tdescription: \"Type of timeline part - always 'metadata' for metadata parts\",\n\t}),\n\tsource: z.enum([\"email\", \"widget\", \"api\"]).openapi({\n\t\tdescription: \"Source channel through which the message was created\",\n\t}),\n});\n\n// ============================================================================\n// TIMELINE ITEM PARTS UNION\n// Combines AI SDK compatible parts with Cossistant-specific parts\n// ============================================================================\n\nexport const timelineItemPartsSchema = z\n\t.array(\n\t\tz.union([\n\t\t\t// AI SDK compatible parts\n\t\t\ttextPartSchema,\n\t\t\treasoningPartSchema,\n\t\t\ttoolPartSchema,\n\t\t\tsourceUrlPartSchema,\n\t\t\tsourceDocumentPartSchema,\n\t\t\tstepStartPartSchema,\n\t\t\tfilePartSchema,\n\t\t\timagePartSchema,\n\t\t\t// Cossistant-specific parts\n\t\t\ttimelinePartEventSchema,\n\t\t\ttimelinePartMetadataSchema,\n\t\t])\n\t)\n\t.openapi({\n\t\tdescription:\n\t\t\t\"Array of timeline parts that make up the timeline item content. Includes AI SDK compatible parts (text, reasoning, tool-*, source-url, source-document, step-start, file, image) and Cossistant-specific parts (event, metadata).\",\n\t});\n\nexport const timelineItemSchema = z.object({\n\tid: z.string().optional().openapi({\n\t\tdescription: \"Unique identifier for the timeline item\",\n\t}),\n\tconversationId: z.string().openapi({\n\t\tdescription: \"ID of the conversation this timeline item belongs to\",\n\t}),\n\torganizationId: z.string().openapi({\n\t\tdescription: \"ID of the organization this timeline item belongs to\",\n\t}),\n\tvisibility: z\n\t\t.enum([TimelineItemVisibility.PUBLIC, TimelineItemVisibility.PRIVATE])\n\t\t.openapi({\n\t\t\tdescription: \"Visibility level of the timeline item\",\n\t\t}),\n\ttype: z\n\t\t.enum([\n\t\t\tConversationTimelineType.MESSAGE,\n\t\t\tConversationTimelineType.EVENT,\n\t\t\tConversationTimelineType.IDENTIFICATION,\n\t\t\tConversationTimelineType.TOOL,\n\t\t])\n\t\t.openapi({\n\t\t\tdescription:\n\t\t\t\t\"Type of timeline item - message, event, identification, or tool call\",\n\t\t}),\n\ttext: z.string().nullable().openapi({\n\t\tdescription: \"Main text content of the timeline item\",\n\t}),\n\ttool: z.string().nullable().optional().openapi({\n\t\tdescription: \"Optional tool identifier associated with this timeline item\",\n\t}),\n\tparts: timelineItemPartsSchema,\n\tuserId: z.string().nullable().openapi({\n\t\tdescription: \"ID of the user who created this timeline item, if applicable\",\n\t}),\n\taiAgentId: z.string().nullable().openapi({\n\t\tdescription:\n\t\t\t\"ID of the AI agent that created this timeline item, if applicable\",\n\t}),\n\tvisitorId: z.string().nullable().openapi({\n\t\tdescription:\n\t\t\t\"ID of the visitor who created this timeline item, if applicable\",\n\t}),\n\tcreatedAt: z.string().openapi({\n\t\tdescription: \"ISO 8601 timestamp when the timeline item was created\",\n\t}),\n\tdeletedAt: z.string().nullable().optional().openapi({\n\t\tdescription:\n\t\t\t\"ISO 8601 timestamp when the timeline item was deleted, if applicable\",\n\t}),\n});\n\nexport type timelineItemSchema = z.infer<typeof timelineItemSchema>;\n\nexport type TimelineItem = z.infer<typeof timelineItemSchema>;\nexport type TimelineItemParts = z.infer<typeof timelineItemPartsSchema>;\n\n// AI SDK compatible part types\nexport type TextPart = z.infer<typeof textPartSchema>;\nexport type ReasoningPart = z.infer<typeof reasoningPartSchema>;\nexport type ToolPart = z.infer<typeof toolPartSchema>;\nexport type SourceUrlPart = z.infer<typeof sourceUrlPartSchema>;\nexport type SourceDocumentPart = z.infer<typeof sourceDocumentPartSchema>;\nexport type StepStartPart = z.infer<typeof stepStartPartSchema>;\nexport type FilePart = z.infer<typeof filePartSchema>;\nexport type ImagePart = z.infer<typeof imagePartSchema>;\n\n// Cossistant-specific part types\nexport type TimelinePartEvent = z.infer<typeof timelinePartEventSchema>;\nexport type TimelinePartMetadata = z.infer<typeof timelinePartMetadataSchema>;\n\n// Backward-compatible type aliases (deprecated, use new names)\n/** @deprecated Use `FilePart` instead */\nexport type TimelinePartFile = FilePart;\n/** @deprecated Use `ImagePart` instead */\nexport type TimelinePartImage = ImagePart;\n/** @deprecated Use `TextPart` instead */\nexport type TimelinePartText = TextPart;\n\n// Provider metadata type for extensions\nexport type CossistantProviderMetadata = z.infer<\n\ttypeof cossistantProviderMetadataSchema\n>;\nexport type CossistantToolTimelineMetadata = z.infer<\n\ttypeof cossistantToolTimelineMetadataSchema\n>;\n\n// Tool state type\nexport type ToolState = z.infer<typeof toolStateSchema>;\n\n// Export schemas for external use\nexport {\n\ttextPartSchema,\n\treasoningPartSchema,\n\ttoolPartSchema,\n\ttoolStateSchema,\n\tsourceUrlPartSchema,\n\tsourceDocumentPartSchema,\n\tstepStartPartSchema,\n\tfilePartSchema,\n\timagePartSchema,\n\ttimelinePartEventSchema,\n\ttimelinePartMetadataSchema,\n\tcossistantProviderMetadataSchema,\n};\n\n// REST API Schemas\nexport const getConversationTimelineItemsRequestSchema = z\n\t.object({\n\t\tlimit: z.coerce.number().min(1).max(100).default(50).openapi({\n\t\t\tdescription: \"Number of timeline items to fetch per page\",\n\t\t\tdefault: 50,\n\t\t}),\n\t\tcursor: z.string().nullable().optional().openapi({\n\t\t\tdescription:\n\t\t\t\t\"Cursor for pagination (timestamp_id format from previous response)\",\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Query parameters for fetching conversation timeline items\",\n\t});\n\nexport type GetConversationTimelineItemsRequest = z.infer<\n\ttypeof getConversationTimelineItemsRequestSchema\n>;\n\nexport const getConversationTimelineItemsResponseSchema = z\n\t.object({\n\t\titems: z.array(timelineItemSchema).openapi({\n\t\t\tdescription: \"Array of timeline items in chronological order\",\n\t\t}),\n\t\tnextCursor: z.string().nullable().openapi({\n\t\t\tdescription:\n\t\t\t\t\"Cursor for the next page, null if no more items are available\",\n\t\t}),\n\t\thasNextPage: z.boolean().openapi({\n\t\t\tdescription: \"Whether there are more items available to fetch\",\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Response containing paginated timeline items\",\n\t});\n\nexport type GetConversationTimelineItemsResponse = z.infer<\n\ttypeof getConversationTimelineItemsResponseSchema\n>;\n\n// Send Timeline Item (Message) Schemas\nexport const sendTimelineItemRequestSchema = z\n\t.object({\n\t\tconversationId: z.string().openapi({\n\t\t\tdescription: \"ID of the conversation to send the timeline item to\",\n\t\t}),\n\t\titem: z.object({\n\t\t\tid: z.string().optional().openapi({\n\t\t\t\tdescription: \"Optional client-generated ID for the timeline item\",\n\t\t\t}),\n\t\t\ttype: z\n\t\t\t\t.enum([\n\t\t\t\t\tConversationTimelineType.MESSAGE,\n\t\t\t\t\tConversationTimelineType.EVENT,\n\t\t\t\t])\n\t\t\t\t.default(ConversationTimelineType.MESSAGE)\n\t\t\t\t.openapi({\n\t\t\t\t\tdescription: \"Type of timeline item - defaults to MESSAGE\",\n\t\t\t\t\tdefault: ConversationTimelineType.MESSAGE,\n\t\t\t\t}),\n\t\t\ttext: z.string().openapi({\n\t\t\t\tdescription: \"Main text content of the timeline item\",\n\t\t\t}),\n\t\t\tparts: timelineItemPartsSchema.optional(),\n\t\t\tvisibility: z\n\t\t\t\t.enum([TimelineItemVisibility.PUBLIC, TimelineItemVisibility.PRIVATE])\n\t\t\t\t.default(TimelineItemVisibility.PUBLIC)\n\t\t\t\t.openapi({\n\t\t\t\t\tdescription: \"Visibility level of the timeline item\",\n\t\t\t\t\tdefault: TimelineItemVisibility.PUBLIC,\n\t\t\t\t}),\n\t\t\ttool: z.string().nullable().optional().openapi({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Optional tool identifier when sending non-message timeline items\",\n\t\t\t}),\n\t\t\tuserId: z.string().nullable().optional().openapi({\n\t\t\t\tdescription: \"ID of the user creating this timeline item\",\n\t\t\t}),\n\t\t\taiAgentId: z.string().nullable().optional().openapi({\n\t\t\t\tdescription: \"ID of the AI agent creating this timeline item\",\n\t\t\t}),\n\t\t\tvisitorId: z.string().nullable().optional().openapi({\n\t\t\t\tdescription: \"ID of the visitor creating this timeline item\",\n\t\t\t}),\n\t\t\tcreatedAt: z.string().optional().openapi({\n\t\t\t\tdescription: \"Optional timestamp for the timeline item\",\n\t\t\t}),\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Request body for sending a timeline item to a conversation\",\n\t});\n\nexport type SendTimelineItemRequest = z.infer<\n\ttypeof sendTimelineItemRequestSchema\n>;\n\nexport const sendTimelineItemResponseSchema = z\n\t.object({\n\t\titem: timelineItemSchema.openapi({\n\t\t\tdescription: \"The created timeline item\",\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Response containing the created timeline item\",\n\t});\n\nexport type SendTimelineItemResponse = z.infer<\n\ttypeof sendTimelineItemResponseSchema\n>;\n"],"mappings":"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"}
+{"version":3,"file":"timeline-item.js","names":[],"sources":["../../src/api/timeline-item.ts"],"sourcesContent":["import { z } from \"@hono/zod-openapi\";\n\nimport {\n\tConversationEventType,\n\tConversationTimelineType,\n\tTimelineItemVisibility,\n} from \"../enums\";\nimport { TOOL_TIMELINE_LOG_TYPE } from \"../tool-timeline-policy\";\n\n// ============================================================================\n// AI SDK v6 COMPATIBLE PART SCHEMAS\n// These follow Vercel AI SDK v6 patterns for UIMessagePart types.\n// Cossistant extensions use providerMetadata/callProviderMetadata.cossistant namespace.\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Cossistant Provider Metadata (extension point for all parts)\n// ----------------------------------------------------------------------------\nconst cossistantToolTimelineMetadataSchema = z.object({\n\tlogType: z\n\t\t.enum([\n\t\t\tTOOL_TIMELINE_LOG_TYPE.CUSTOMER_FACING,\n\t\t\tTOOL_TIMELINE_LOG_TYPE.LOG,\n\t\t\tTOOL_TIMELINE_LOG_TYPE.DECISION,\n\t\t])\n\t\t.openapi({\n\t\t\tdescription:\n\t\t\t\t\"Tool timeline classification: conversation-visible, log-only, or decision stage\",\n\t\t}),\n\ttriggerMessageId: z.string().openapi({\n\t\tdescription:\n\t\t\t\"Message ID that triggered the tool/decision workflow execution\",\n\t}),\n\tworkflowRunId: z.string().openapi({\n\t\tdescription:\n\t\t\t\"Workflow run identifier used to correlate tool timeline updates\",\n\t}),\n\ttriggerVisibility: z.enum([\"public\", \"private\"]).optional().openapi({\n\t\tdescription:\n\t\t\t\"Visibility of the trigger message at the time the tool was executed\",\n\t}),\n});\n\nconst cossistantProviderMetadataSchema = z\n\t.object({\n\t\tcossistant: z\n\t\t\t.object({\n\t\t\t\tvisibility: z.enum([\"public\", \"private\"]).optional().openapi({\n\t\t\t\t\tdescription: \"Part-level visibility control for filtering\",\n\t\t\t\t}),\n\t\t\t\tprogressMessage: z.string().optional().openapi({\n\t\t\t\t\tdescription: \"Custom progress message to display during execution\",\n\t\t\t\t}),\n\t\t\t\tknowledgeId: z.string().optional().openapi({\n\t\t\t\t\tdescription: \"Reference to a Cossistant knowledge entry\",\n\t\t\t\t}),\n\t\t\t\ttoolTimeline: cossistantToolTimelineMetadataSchema.optional().openapi({\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Tool timeline metadata used to classify visibility and trigger linkage\",\n\t\t\t\t}),\n\t\t\t})\n\t\t\t.optional(),\n\t})\n\t.passthrough()\n\t.optional();\n\n// ----------------------------------------------------------------------------\n// TEXT PART (AI SDK compatible)\n// ----------------------------------------------------------------------------\nconst textPartSchema = z.object({\n\ttype: z.literal(\"text\").openapi({\n\t\tdescription: \"Text content part - matches AI SDK TextUIPart\",\n\t}),\n\ttext: z.string().openapi({\n\t\tdescription: \"The text content\",\n\t}),\n\tstate: z.enum([\"streaming\", \"done\"]).optional().openapi({\n\t\tdescription:\n\t\t\t\"AI SDK state: 'streaming' = still processing, 'done' = complete\",\n\t}),\n});\n\n// ----------------------------------------------------------------------------\n// REASONING PART (AI SDK compatible - for AI chain-of-thought)\n// ----------------------------------------------------------------------------\nconst reasoningPartSchema = z.object({\n\ttype: z.literal(\"reasoning\").openapi({\n\t\tdescription:\n\t\t\t\"AI reasoning/chain-of-thought - matches AI SDK ReasoningUIPart\",\n\t}),\n\ttext: z.string().openapi({\n\t\tdescription: \"The reasoning text content\",\n\t}),\n\tstate: z.enum([\"streaming\", \"done\"]).optional().openapi({\n\t\tdescription:\n\t\t\t\"AI SDK state: 'streaming' = still processing, 'done' = complete\",\n\t}),\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// TOOL PART (AI SDK compatible - for tool invocations)\n// AI SDK uses type: `tool-${toolName}` pattern, but we use a generic schema\n// with toolName field for flexibility. Type checking happens at runtime.\n// ----------------------------------------------------------------------------\nconst toolStateSchema = z.enum([\"partial\", \"result\", \"error\"]).openapi({\n\tdescription:\n\t\t\"AI SDK tool state: 'partial' = executing, 'result' = success, 'error' = failed\",\n});\n\nconst toolPartSchema = z.object({\n\ttype: z\n\t\t.string()\n\t\t.regex(/^tool-.+$/)\n\t\t.openapi({\n\t\t\tdescription: \"Tool type following AI SDK pattern: tool-{toolName}\",\n\t\t}),\n\ttoolCallId: z.string().openapi({\n\t\tdescription: \"Unique identifier for this tool invocation\",\n\t}),\n\ttoolName: z.string().openapi({\n\t\tdescription: \"Name of the tool being invoked\",\n\t}),\n\tinput: z.record(z.string(), z.unknown()).openapi({\n\t\tdescription: \"Input parameters passed to the tool\",\n\t}),\n\toutput: z.unknown().optional().openapi({\n\t\tdescription: \"Output returned by the tool (when state is 'result')\",\n\t}),\n\tstate: toolStateSchema,\n\terrorText: z.string().optional().openapi({\n\t\tdescription: \"Error message when state is 'error'\",\n\t}),\n\tcallProviderMetadata: cossistantProviderMetadataSchema,\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// SOURCE URL PART (AI SDK compatible - for citations)\n// ----------------------------------------------------------------------------\nconst sourceUrlPartSchema = z.object({\n\ttype: z.literal(\"source-url\").openapi({\n\t\tdescription: \"URL source citation - matches AI SDK SourceUrlUIPart\",\n\t}),\n\tsourceId: z.string().openapi({\n\t\tdescription: \"Unique identifier for this source\",\n\t}),\n\turl: z.string().url().openapi({\n\t\tdescription: \"URL of the source\",\n\t}),\n\ttitle: z.string().optional().openapi({\n\t\tdescription: \"Title of the source\",\n\t}),\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// SOURCE DOCUMENT PART (AI SDK compatible - for document citations)\n// ----------------------------------------------------------------------------\nconst sourceDocumentPartSchema = z.object({\n\ttype: z.literal(\"source-document\").openapi({\n\t\tdescription:\n\t\t\t\"Document source citation - matches AI SDK SourceDocumentUIPart\",\n\t}),\n\tsourceId: z.string().openapi({\n\t\tdescription: \"Unique identifier for this source\",\n\t}),\n\tmediaType: z.string().openapi({\n\t\tdescription: \"IANA media type of the document\",\n\t}),\n\ttitle: z.string().openapi({\n\t\tdescription: \"Title of the document\",\n\t}),\n\tfilename: z.string().optional().openapi({\n\t\tdescription: \"Filename of the document\",\n\t}),\n\tproviderMetadata: cossistantProviderMetadataSchema,\n});\n\n// ----------------------------------------------------------------------------\n// STEP START PART (AI SDK compatible - for multi-step boundaries)\n// ----------------------------------------------------------------------------\nconst stepStartPartSchema = z.object({\n\ttype: z.literal(\"step-start\").openapi({\n\t\tdescription: \"Step boundary marker - matches AI SDK StepStartUIPart\",\n\t}),\n});\n\n// ----------------------------------------------------------------------------\n// FILE PART (AI SDK compatible)\n// ----------------------------------------------------------------------------\nconst filePartSchema = z.object({\n\ttype: z.literal(\"file\").openapi({\n\t\tdescription: \"File attachment - matches AI SDK FileUIPart\",\n\t}),\n\turl: z.string().openapi({\n\t\tdescription: \"URL of the file (can be hosted URL or Data URL)\",\n\t}),\n\tmediaType: z.string().openapi({\n\t\tdescription: \"IANA media type of the file\",\n\t}),\n\tfilename: z.string().optional().openapi({\n\t\tdescription: \"Original filename\",\n\t}),\n\t// Cossistant extension: additional file metadata\n\tsize: z.number().optional().openapi({\n\t\tdescription: \"Size of the file in bytes\",\n\t}),\n});\n\n// ----------------------------------------------------------------------------\n// IMAGE PART (Cossistant extension - more detailed than AI SDK file)\n// ----------------------------------------------------------------------------\nconst imagePartSchema = z.object({\n\ttype: z.literal(\"image\").openapi({\n\t\tdescription: \"Image attachment with dimensions\",\n\t}),\n\turl: z.string().openapi({\n\t\tdescription: \"URL of the image\",\n\t}),\n\tmediaType: z.string().openapi({\n\t\tdescription: \"IANA media type of the image\",\n\t}),\n\t// Use lowercase 'filename' for AI SDK consistency\n\t// Note: Legacy data may have 'fileName' - conversion utilities handle both\n\tfilename: z.string().optional().openapi({\n\t\tdescription: \"Original filename of the image\",\n\t}),\n\tsize: z.number().optional().openapi({\n\t\tdescription: \"Size of the image in bytes\",\n\t}),\n\twidth: z.number().optional().openapi({\n\t\tdescription: \"Width of the image in pixels\",\n\t}),\n\theight: z.number().optional().openapi({\n\t\tdescription: \"Height of the image in pixels\",\n\t}),\n});\n\n// ============================================================================\n// COSSISTANT-SPECIFIC PART SCHEMAS\n// These are Cossistant-specific parts not in AI SDK\n// ============================================================================\n\nconst timelinePartEventSchema = z.object({\n\ttype: z.literal(\"event\").openapi({\n\t\tdescription: \"Type of timeline part - always 'event' for event parts\",\n\t}),\n\teventType: z\n\t\t.enum([\n\t\t\tConversationEventType.ASSIGNED,\n\t\t\tConversationEventType.UNASSIGNED,\n\t\t\tConversationEventType.PARTICIPANT_REQUESTED,\n\t\t\tConversationEventType.PARTICIPANT_JOINED,\n\t\t\tConversationEventType.PARTICIPANT_LEFT,\n\t\t\tConversationEventType.STATUS_CHANGED,\n\t\t\tConversationEventType.PRIORITY_CHANGED,\n\t\t\tConversationEventType.TAG_ADDED,\n\t\t\tConversationEventType.TAG_REMOVED,\n\t\t\tConversationEventType.RESOLVED,\n\t\t\tConversationEventType.REOPENED,\n\t\t\tConversationEventType.VISITOR_BLOCKED,\n\t\t\tConversationEventType.VISITOR_UNBLOCKED,\n\t\t\tConversationEventType.VISITOR_IDENTIFIED,\n\t\t\tConversationEventType.AI_PAUSED,\n\t\t\tConversationEventType.AI_RESUMED,\n\t\t])\n\t\t.openapi({\n\t\t\tdescription: \"Type of event that occurred\",\n\t\t}),\n\tactorUserId: z.string().nullable().openapi({\n\t\tdescription: \"User that triggered the event, if applicable\",\n\t}),\n\tactorAiAgentId: z.string().nullable().openapi({\n\t\tdescription: \"AI agent that triggered the event, if applicable\",\n\t}),\n\ttargetUserId: z.string().nullable().openapi({\n\t\tdescription: \"User targeted by the event, if applicable\",\n\t}),\n\ttargetAiAgentId: z.string().nullable().openapi({\n\t\tdescription: \"AI agent targeted by the event, if applicable\",\n\t}),\n\tmessage: z.string().nullable().optional().openapi({\n\t\tdescription: \"Optional human readable message attached to the event\",\n\t}),\n});\n\nconst timelinePartMetadataSchema = z.object({\n\ttype: z.literal(\"metadata\").openapi({\n\t\tdescription: \"Type of timeline part - always 'metadata' for metadata parts\",\n\t}),\n\tsource: z.enum([\"email\", \"widget\", \"api\"]).openapi({\n\t\tdescription: \"Source channel through which the message was created\",\n\t}),\n});\n\n// ============================================================================\n// TIMELINE ITEM PARTS UNION\n// Combines AI SDK compatible parts with Cossistant-specific parts\n// ============================================================================\n\nexport const timelineItemPartsSchema = z\n\t.array(\n\t\tz.union([\n\t\t\t// AI SDK compatible parts\n\t\t\ttextPartSchema,\n\t\t\treasoningPartSchema,\n\t\t\ttoolPartSchema,\n\t\t\tsourceUrlPartSchema,\n\t\t\tsourceDocumentPartSchema,\n\t\t\tstepStartPartSchema,\n\t\t\tfilePartSchema,\n\t\t\timagePartSchema,\n\t\t\t// Cossistant-specific parts\n\t\t\ttimelinePartEventSchema,\n\t\t\ttimelinePartMetadataSchema,\n\t\t])\n\t)\n\t.openapi({\n\t\tdescription:\n\t\t\t\"Array of timeline parts that make up the timeline item content. Includes AI SDK compatible parts (text, reasoning, tool-*, source-url, source-document, step-start, file, image) and Cossistant-specific parts (event, metadata).\",\n\t});\n\nexport const timelineItemSchema = z.object({\n\tid: z.string().optional().openapi({\n\t\tdescription: \"Unique identifier for the timeline item\",\n\t}),\n\tconversationId: z.string().openapi({\n\t\tdescription: \"ID of the conversation this timeline item belongs to\",\n\t}),\n\torganizationId: z.string().openapi({\n\t\tdescription: \"ID of the organization this timeline item belongs to\",\n\t}),\n\tvisibility: z\n\t\t.enum([TimelineItemVisibility.PUBLIC, TimelineItemVisibility.PRIVATE])\n\t\t.openapi({\n\t\t\tdescription: \"Visibility level of the timeline item\",\n\t\t}),\n\ttype: z\n\t\t.enum([\n\t\t\tConversationTimelineType.MESSAGE,\n\t\t\tConversationTimelineType.EVENT,\n\t\t\tConversationTimelineType.IDENTIFICATION,\n\t\t\tConversationTimelineType.TOOL,\n\t\t])\n\t\t.openapi({\n\t\t\tdescription:\n\t\t\t\t\"Type of timeline item - message, event, identification, or tool call\",\n\t\t}),\n\ttext: z.string().nullable().openapi({\n\t\tdescription: \"Main text content of the timeline item\",\n\t}),\n\ttool: z.string().nullable().optional().openapi({\n\t\tdescription: \"Optional tool identifier associated with this timeline item\",\n\t}),\n\tparts: timelineItemPartsSchema,\n\tuserId: z.string().nullable().openapi({\n\t\tdescription: \"ID of the user who created this timeline item, if applicable\",\n\t}),\n\taiAgentId: z.string().nullable().openapi({\n\t\tdescription:\n\t\t\t\"ID of the AI agent that created this timeline item, if applicable\",\n\t}),\n\tvisitorId: z.string().nullable().openapi({\n\t\tdescription:\n\t\t\t\"ID of the visitor who created this timeline item, if applicable\",\n\t}),\n\tcreatedAt: z.string().openapi({\n\t\tdescription: \"ISO 8601 timestamp when the timeline item was created\",\n\t}),\n\tdeletedAt: z.string().nullable().optional().openapi({\n\t\tdescription:\n\t\t\t\"ISO 8601 timestamp when the timeline item was deleted, if applicable\",\n\t}),\n});\n\nexport type timelineItemSchema = z.infer<typeof timelineItemSchema>;\n\nexport type TimelineItem = z.infer<typeof timelineItemSchema>;\nexport type TimelineItemParts = z.infer<typeof timelineItemPartsSchema>;\n\n// AI SDK compatible part types\nexport type TextPart = z.infer<typeof textPartSchema>;\nexport type ReasoningPart = z.infer<typeof reasoningPartSchema>;\nexport type ToolPart = z.infer<typeof toolPartSchema>;\nexport type SourceUrlPart = z.infer<typeof sourceUrlPartSchema>;\nexport type SourceDocumentPart = z.infer<typeof sourceDocumentPartSchema>;\nexport type StepStartPart = z.infer<typeof stepStartPartSchema>;\nexport type FilePart = z.infer<typeof filePartSchema>;\nexport type ImagePart = z.infer<typeof imagePartSchema>;\n\n// Cossistant-specific part types\nexport type TimelinePartEvent = z.infer<typeof timelinePartEventSchema>;\nexport type TimelinePartMetadata = z.infer<typeof timelinePartMetadataSchema>;\n\n// Backward-compatible type aliases (deprecated, use new names)\n/** @deprecated Use `FilePart` instead */\nexport type TimelinePartFile = FilePart;\n/** @deprecated Use `ImagePart` instead */\nexport type TimelinePartImage = ImagePart;\n/** @deprecated Use `TextPart` instead */\nexport type TimelinePartText = TextPart;\n\n// Provider metadata type for extensions\nexport type CossistantProviderMetadata = z.infer<\n\ttypeof cossistantProviderMetadataSchema\n>;\nexport type CossistantToolTimelineMetadata = z.infer<\n\ttypeof cossistantToolTimelineMetadataSchema\n>;\n\n// Tool state type\nexport type ToolState = z.infer<typeof toolStateSchema>;\n\n// Export schemas for external use\nexport {\n\ttextPartSchema,\n\treasoningPartSchema,\n\ttoolPartSchema,\n\ttoolStateSchema,\n\tsourceUrlPartSchema,\n\tsourceDocumentPartSchema,\n\tstepStartPartSchema,\n\tfilePartSchema,\n\timagePartSchema,\n\ttimelinePartEventSchema,\n\ttimelinePartMetadataSchema,\n\tcossistantProviderMetadataSchema,\n};\n\n// REST API Schemas\nexport const getConversationTimelineItemsRequestSchema = z\n\t.object({\n\t\tlimit: z.coerce.number().min(1).max(100).default(50).openapi({\n\t\t\tdescription: \"Number of timeline items to fetch per page\",\n\t\t\tdefault: 50,\n\t\t}),\n\t\tcursor: z.string().nullable().optional().openapi({\n\t\t\tdescription:\n\t\t\t\t\"Cursor for pagination (timestamp_id format from previous response)\",\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Query parameters for fetching conversation timeline items\",\n\t});\n\nexport type GetConversationTimelineItemsRequest = z.infer<\n\ttypeof getConversationTimelineItemsRequestSchema\n>;\n\nexport const getConversationTimelineItemsResponseSchema = z\n\t.object({\n\t\titems: z.array(timelineItemSchema).openapi({\n\t\t\tdescription: \"Array of timeline items in chronological order\",\n\t\t}),\n\t\tnextCursor: z.string().nullable().openapi({\n\t\t\tdescription:\n\t\t\t\t\"Cursor for the next page, null if no more items are available\",\n\t\t}),\n\t\thasNextPage: z.boolean().openapi({\n\t\t\tdescription: \"Whether there are more items available to fetch\",\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Response containing paginated timeline items\",\n\t});\n\nexport type GetConversationTimelineItemsResponse = z.infer<\n\ttypeof getConversationTimelineItemsResponseSchema\n>;\n\n// Send Timeline Item (Message) Schemas\nexport const sendTimelineItemRequestSchema = z\n\t.object({\n\t\tconversationId: z.string().openapi({\n\t\t\tdescription: \"ID of the conversation to send the timeline item to\",\n\t\t}),\n\t\titem: z.object({\n\t\t\tid: z.string().optional().openapi({\n\t\t\t\tdescription: \"Optional client-generated ID for the timeline item\",\n\t\t\t}),\n\t\t\ttype: z\n\t\t\t\t.enum([\n\t\t\t\t\tConversationTimelineType.MESSAGE,\n\t\t\t\t\tConversationTimelineType.EVENT,\n\t\t\t\t])\n\t\t\t\t.default(ConversationTimelineType.MESSAGE)\n\t\t\t\t.openapi({\n\t\t\t\t\tdescription: \"Type of timeline item - defaults to MESSAGE\",\n\t\t\t\t\tdefault: ConversationTimelineType.MESSAGE,\n\t\t\t\t}),\n\t\t\ttext: z.string().openapi({\n\t\t\t\tdescription: \"Main text content of the timeline item\",\n\t\t\t}),\n\t\t\tparts: timelineItemPartsSchema.optional(),\n\t\t\tvisibility: z\n\t\t\t\t.enum([TimelineItemVisibility.PUBLIC, TimelineItemVisibility.PRIVATE])\n\t\t\t\t.default(TimelineItemVisibility.PUBLIC)\n\t\t\t\t.openapi({\n\t\t\t\t\tdescription: \"Visibility level of the timeline item\",\n\t\t\t\t\tdefault: TimelineItemVisibility.PUBLIC,\n\t\t\t\t}),\n\t\t\ttool: z.string().nullable().optional().openapi({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Optional tool identifier when sending non-message timeline items\",\n\t\t\t}),\n\t\t\tuserId: z.string().nullable().optional().openapi({\n\t\t\t\tdescription: \"ID of the user creating this timeline item\",\n\t\t\t}),\n\t\t\taiAgentId: z.string().nullable().optional().openapi({\n\t\t\t\tdescription: \"ID of the AI agent creating this timeline item\",\n\t\t\t}),\n\t\t\tvisitorId: z.string().nullable().optional().openapi({\n\t\t\t\tdescription: \"ID of the visitor creating this timeline item\",\n\t\t\t}),\n\t\t\tcreatedAt: z.string().optional().openapi({\n\t\t\t\tdescription: \"Optional timestamp for the timeline item\",\n\t\t\t}),\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Request body for sending a timeline item to a conversation\",\n\t});\n\nexport type SendTimelineItemRequest = z.infer<\n\ttypeof sendTimelineItemRequestSchema\n>;\n\nexport const sendTimelineItemResponseSchema = z\n\t.object({\n\t\titem: timelineItemSchema.openapi({\n\t\t\tdescription: \"The created timeline item\",\n\t\t}),\n\t})\n\t.openapi({\n\t\tdescription: \"Response containing the created timeline item\",\n\t});\n\nexport type SendTimelineItemResponse = z.infer<\n\ttypeof sendTimelineItemResponseSchema\n>;\n"],"mappings":"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"}

package/api/user.d.ts

@@ -7,7 +7,7 @@ import { z } from "@hono/zod-openapi";
  */
 declare const userResponseSchema: z.ZodObject<{
   id: z.ZodULID;
-  name: z.ZodOptional<z.ZodString>;
+  name: z.ZodNullable<z.ZodString>;
   email: z.ZodEmail;
   role: z.ZodNullable<z.ZodString>;
   image: z.ZodNullable<z.ZodURL>;

package/api/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","names":[],"sources":["../../src/api/user.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;cAAa,oBAAkB,CAAA,CAAA;;;;;;;;;;cAsClB,gCAA8B,CAAA,CAAA;;;EAtCZ,KAAA,eAAA,cAAA,YAAA,CAAA,CAAA;CAAA,eAAA,CAAA;AAsClB,KAuBD,YAAA,GAAe,CAAA,CAAE,KAvBhB,CAAA,OAuB6B,kBAFvC,CAAA;KAGS,wBAAA,GAA2B,CAAA,CAAE,aACjC"}
+{"version":3,"file":"user.d.ts","names":[],"sources":["../../src/api/user.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;cAAa,oBAAkB,CAAA,CAAA;;;;;;;;;;cAmClB,gCAA8B,CAAA,CAAA;;;EAnCZ,KAAA,eAAA,cAAA,YAAA,CAAA,CAAA;CAAA,eAAA,CAAA;AAmClB,KAuBD,YAAA,GAAe,CAAA,CAAE,KAvBhB,CAAA,OAuB6B,kBAFvC,CAAA;KAGS,wBAAA,GAA2B,CAAA,CAAE,aACjC"}

package/api/user.js

@@ -9,10 +9,10 @@ const userResponseSchema = z.object({
 		description: "The user's unique identifier.",
 		example: "01JG000000000000000000000"
 	}),
-	name: z.string().openapi({
+	name: z.string().nullable().openapi({
 		description: "The user's name.",
 		example: "John Doe"
-	}).optional(),
+	}),
 	email: z.email().openapi({
 		description: "The user's email address.",
 		example: "john.doe@example.com"

package/api/user.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.js","names":[],"sources":["../../src/api/user.ts"],"sourcesContent":["import { z } from \"@hono/zod-openapi\";\n\n/**\n * Visitor data update request schema\n */\nexport const userResponseSchema = z.object({\n\tid: z.ulid().openapi({\n\t\tdescription: \"The user's unique identifier.\",\n\t\texample: \"01JG000000000000000000000\",\n\t}),\n\tname: z\n\t\t.string()\n\t\t.openapi({\n\t\t\tdescription: \"The user's name.\",\n\t\t\texample: \"John Doe\",\n\t\t})\n\t\t.optional(),\n\temail: z.email().openapi({\n\t\tdescription: \"The user's email address.\",\n\t\texample: \"john.doe@example.com\",\n\t}),\n\trole: z.string().nullable().openapi({\n\t\tdescription: \"The user's role.\",\n\t\texample: \"admin\",\n\t}),\n\timage: z.url().nullable().openapi({\n\t\tdescription: \"The user's image URL.\",\n\t\texample: \"https://example.com/image.png\",\n\t}),\n\tcreatedAt: z.string().openapi({\n\t\tdescription: \"The user's creation date.\",\n\t\texample: \"2021-01-01T00:00:00.000Z\",\n\t}),\n\tupdatedAt: z.string().openapi({\n\t\tdescription: \"The user's last update date.\",\n\t\texample: \"2021-01-01T00:00:00.000Z\",\n\t}),\n\tlastSeenAt: z.string().nullable().openapi({\n\t\tdescription: \"The user's last seen date.\",\n\t\texample: \"2021-01-01T00:00:00.000Z\",\n\t}),\n});\n\nexport const updateUserProfileRequestSchema = z\n\t.object({\n\t\tuserId: z.ulid({ message: \"Missing user identifier.\" }).openapi({\n\t\t\tdescription: \"The identifier of the user that should be updated.\",\n\t\t\texample: \"01JG000000000000000000000\",\n\t\t}),\n\t\tname: z\n\t\t\t.string({ message: \"Enter your name.\" })\n\t\t\t.trim()\n\t\t\t.min(1, { message: \"Enter your name.\" })\n\t\t\t.max(120, {\n\t\t\t\tmessage: \"Name must be 120 characters or fewer.\",\n\t\t\t}),\n\t\timage: z\n\t\t\t.string()\n\t\t\t.url({ message: \"Provide a valid image URL.\" })\n\t\t\t.nullable()\n\t\t\t.optional(),\n\t})\n\t.openapi({\n\t\tdescription: \"Payload used to update the current user's profile details.\",\n\t});\n\nexport type UserResponse = z.infer<typeof userResponseSchema>;\nexport type UpdateUserProfileRequest = z.infer<\n\ttypeof updateUserProfileRequestSchema\n>;\n"],"mappings":";;;;;;AAKA,MAAa,qBAAqB,EAAE,OAAO;CAC1C,IAAI,EAAE,MAAM,CAAC,QAAQ;EACpB,aAAa;EACb,SAAS;EACT,CAAC;CACF,MAAM,EACJ,QAAQ,CACR,QAAQ;EACR,aAAa;EACb,SAAS;EACT,CAAC,CACD,UAAU;CACZ,OAAO,EAAE,OAAO,CAAC,QAAQ;EACxB,aAAa;EACb,SAAS;EACT,CAAC;CACF,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;EACnC,aAAa;EACb,SAAS;EACT,CAAC;CACF,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ;EACjC,aAAa;EACb,SAAS;EACT,CAAC;CACF,WAAW,EAAE,QAAQ,CAAC,QAAQ;EAC7B,aAAa;EACb,SAAS;EACT,CAAC;CACF,WAAW,EAAE,QAAQ,CAAC,QAAQ;EAC7B,aAAa;EACb,SAAS;EACT,CAAC;CACF,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;EACzC,aAAa;EACb,SAAS;EACT,CAAC;CACF,CAAC;AAEF,MAAa,iCAAiC,EAC5C,OAAO;CACP,QAAQ,EAAE,KAAK,EAAE,SAAS,4BAA4B,CAAC,CAAC,QAAQ;EAC/D,aAAa;EACb,SAAS;EACT,CAAC;CACF,MAAM,EACJ,OAAO,EAAE,SAAS,oBAAoB,CAAC,CACvC,MAAM,CACN,IAAI,GAAG,EAAE,SAAS,oBAAoB,CAAC,CACvC,IAAI,KAAK,EACT,SAAS,yCACT,CAAC;CACH,OAAO,EACL,QAAQ,CACR,IAAI,EAAE,SAAS,8BAA8B,CAAC,CAC9C,UAAU,CACV,UAAU;CACZ,CAAC,CACD,QAAQ,EACR,aAAa,8DACb,CAAC"}
+{"version":3,"file":"user.js","names":[],"sources":["../../src/api/user.ts"],"sourcesContent":["import { z } from \"@hono/zod-openapi\";\n\n/**\n * Visitor data update request schema\n */\nexport const userResponseSchema = z.object({\n\tid: z.ulid().openapi({\n\t\tdescription: \"The user's unique identifier.\",\n\t\texample: \"01JG000000000000000000000\",\n\t}),\n\tname: z.string().nullable().openapi({\n\t\tdescription: \"The user's name.\",\n\t\texample: \"John Doe\",\n\t}),\n\temail: z.email().openapi({\n\t\tdescription: \"The user's email address.\",\n\t\texample: \"john.doe@example.com\",\n\t}),\n\trole: z.string().nullable().openapi({\n\t\tdescription: \"The user's role.\",\n\t\texample: \"admin\",\n\t}),\n\timage: z.url().nullable().openapi({\n\t\tdescription: \"The user's image URL.\",\n\t\texample: \"https://example.com/image.png\",\n\t}),\n\tcreatedAt: z.string().openapi({\n\t\tdescription: \"The user's creation date.\",\n\t\texample: \"2021-01-01T00:00:00.000Z\",\n\t}),\n\tupdatedAt: z.string().openapi({\n\t\tdescription: \"The user's last update date.\",\n\t\texample: \"2021-01-01T00:00:00.000Z\",\n\t}),\n\tlastSeenAt: z.string().nullable().openapi({\n\t\tdescription: \"The user's last seen date.\",\n\t\texample: \"2021-01-01T00:00:00.000Z\",\n\t}),\n});\n\nexport const updateUserProfileRequestSchema = z\n\t.object({\n\t\tuserId: z.ulid({ message: \"Missing user identifier.\" }).openapi({\n\t\t\tdescription: \"The identifier of the user that should be updated.\",\n\t\t\texample: \"01JG000000000000000000000\",\n\t\t}),\n\t\tname: z\n\t\t\t.string({ message: \"Enter your name.\" })\n\t\t\t.trim()\n\t\t\t.min(1, { message: \"Enter your name.\" })\n\t\t\t.max(120, {\n\t\t\t\tmessage: \"Name must be 120 characters or fewer.\",\n\t\t\t}),\n\t\timage: z\n\t\t\t.string()\n\t\t\t.url({ message: \"Provide a valid image URL.\" })\n\t\t\t.nullable()\n\t\t\t.optional(),\n\t})\n\t.openapi({\n\t\tdescription: \"Payload used to update the current user's profile details.\",\n\t});\n\nexport type UserResponse = z.infer<typeof userResponseSchema>;\nexport type UpdateUserProfileRequest = z.infer<\n\ttypeof updateUserProfileRequestSchema\n>;\n"],"mappings":";;;;;;AAKA,MAAa,qBAAqB,EAAE,OAAO;CAC1C,IAAI,EAAE,MAAM,CAAC,QAAQ;EACpB,aAAa;EACb,SAAS;EACT,CAAC;CACF,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;EACnC,aAAa;EACb,SAAS;EACT,CAAC;CACF,OAAO,EAAE,OAAO,CAAC,QAAQ;EACxB,aAAa;EACb,SAAS;EACT,CAAC;CACF,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;EACnC,aAAa;EACb,SAAS;EACT,CAAC;CACF,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ;EACjC,aAAa;EACb,SAAS;EACT,CAAC;CACF,WAAW,EAAE,QAAQ,CAAC,QAAQ;EAC7B,aAAa;EACb,SAAS;EACT,CAAC;CACF,WAAW,EAAE,QAAQ,CAAC,QAAQ;EAC7B,aAAa;EACb,SAAS;EACT,CAAC;CACF,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;EACzC,aAAa;EACb,SAAS;EACT,CAAC;CACF,CAAC;AAEF,MAAa,iCAAiC,EAC5C,OAAO;CACP,QAAQ,EAAE,KAAK,EAAE,SAAS,4BAA4B,CAAC,CAAC,QAAQ;EAC/D,aAAa;EACb,SAAS;EACT,CAAC;CACF,MAAM,EACJ,OAAO,EAAE,SAAS,oBAAoB,CAAC,CACvC,MAAM,CACN,IAAI,GAAG,EAAE,SAAS,oBAAoB,CAAC,CACvC,IAAI,KAAK,EACT,SAAS,yCACT,CAAC;CACH,OAAO,EACL,QAAQ,CACR,IAAI,EAAE,SAAS,8BAA8B,CAAC,CAC9C,UAAU,CACV,UAAU;CACZ,CAAC,CACD,QAAQ,EACR,aAAa,8DACb,CAAC"}

package/api/visitor.d.ts

@@ -19,6 +19,134 @@ declare const publicContactResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type PublicContact = z.infer<typeof publicContactResponseSchema>;
 type VisitorMetadata = z.infer<typeof visitorMetadataSchema>;
+declare const attributionChannelSchema: z.ZodEnum<{
+  email: "email";
+  direct: "direct";
+  paid: "paid";
+  organic_search: "organic_search";
+  social: "social";
+  referral: "referral";
+}>;
+declare const visitorAttributionReferrerSchema: z.ZodObject<{
+  url: z.ZodNullable<z.ZodString>;
+  domain: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const visitorAttributionLandingSchema: z.ZodObject<{
+  url: z.ZodNullable<z.ZodString>;
+  path: z.ZodNullable<z.ZodString>;
+  title: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const visitorAttributionUtmSchema: z.ZodObject<{
+  source: z.ZodNullable<z.ZodString>;
+  medium: z.ZodNullable<z.ZodString>;
+  campaign: z.ZodNullable<z.ZodString>;
+  content: z.ZodNullable<z.ZodString>;
+  term: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const visitorAttributionClickIdsSchema: z.ZodObject<{
+  gclid: z.ZodNullable<z.ZodString>;
+  gbraid: z.ZodNullable<z.ZodString>;
+  wbraid: z.ZodNullable<z.ZodString>;
+  fbclid: z.ZodNullable<z.ZodString>;
+  msclkid: z.ZodNullable<z.ZodString>;
+  ttclid: z.ZodNullable<z.ZodString>;
+  li_fat_id: z.ZodNullable<z.ZodString>;
+  twclid: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const visitorAttributionFirstTouchSchema: z.ZodObject<{
+  channel: z.ZodEnum<{
+    email: "email";
+    direct: "direct";
+    paid: "paid";
+    organic_search: "organic_search";
+    social: "social";
+    referral: "referral";
+  }>;
+  isDirect: z.ZodBoolean;
+  referrer: z.ZodObject<{
+    url: z.ZodNullable<z.ZodString>;
+    domain: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  landing: z.ZodObject<{
+    url: z.ZodNullable<z.ZodString>;
+    path: z.ZodNullable<z.ZodString>;
+    title: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  utm: z.ZodObject<{
+    source: z.ZodNullable<z.ZodString>;
+    medium: z.ZodNullable<z.ZodString>;
+    campaign: z.ZodNullable<z.ZodString>;
+    content: z.ZodNullable<z.ZodString>;
+    term: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  clickIds: z.ZodObject<{
+    gclid: z.ZodNullable<z.ZodString>;
+    gbraid: z.ZodNullable<z.ZodString>;
+    wbraid: z.ZodNullable<z.ZodString>;
+    fbclid: z.ZodNullable<z.ZodString>;
+    msclkid: z.ZodNullable<z.ZodString>;
+    ttclid: z.ZodNullable<z.ZodString>;
+    li_fat_id: z.ZodNullable<z.ZodString>;
+    twclid: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  capturedAt: z.ZodString;
+}, z.core.$strip>;
+declare const visitorAttributionSchema: z.ZodObject<{
+  version: z.ZodLiteral<1>;
+  firstTouch: z.ZodObject<{
+    channel: z.ZodEnum<{
+      email: "email";
+      direct: "direct";
+      paid: "paid";
+      organic_search: "organic_search";
+      social: "social";
+      referral: "referral";
+    }>;
+    isDirect: z.ZodBoolean;
+    referrer: z.ZodObject<{
+      url: z.ZodNullable<z.ZodString>;
+      domain: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    landing: z.ZodObject<{
+      url: z.ZodNullable<z.ZodString>;
+      path: z.ZodNullable<z.ZodString>;
+      title: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    utm: z.ZodObject<{
+      source: z.ZodNullable<z.ZodString>;
+      medium: z.ZodNullable<z.ZodString>;
+      campaign: z.ZodNullable<z.ZodString>;
+      content: z.ZodNullable<z.ZodString>;
+      term: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    clickIds: z.ZodObject<{
+      gclid: z.ZodNullable<z.ZodString>;
+      gbraid: z.ZodNullable<z.ZodString>;
+      wbraid: z.ZodNullable<z.ZodString>;
+      fbclid: z.ZodNullable<z.ZodString>;
+      msclkid: z.ZodNullable<z.ZodString>;
+      ttclid: z.ZodNullable<z.ZodString>;
+      li_fat_id: z.ZodNullable<z.ZodString>;
+      twclid: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    capturedAt: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const visitorCurrentPageSchema: z.ZodObject<{
+  url: z.ZodNullable<z.ZodString>;
+  path: z.ZodNullable<z.ZodString>;
+  title: z.ZodNullable<z.ZodString>;
+  referrerUrl: z.ZodNullable<z.ZodString>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+type AttributionChannel = z.infer<typeof attributionChannelSchema>;
+type VisitorAttributionReferrer = z.infer<typeof visitorAttributionReferrerSchema>;
+type VisitorAttributionLanding = z.infer<typeof visitorAttributionLandingSchema>;
+type VisitorAttributionUtm = z.infer<typeof visitorAttributionUtmSchema>;
+type VisitorAttributionClickIds = z.infer<typeof visitorAttributionClickIdsSchema>;
+type VisitorAttributionFirstTouch = z.infer<typeof visitorAttributionFirstTouchSchema>;
+type VisitorAttribution = z.infer<typeof visitorAttributionSchema>;
+type VisitorCurrentPage = z.infer<typeof visitorCurrentPageSchema>;
 /**
  * Visitor data update request schema
  */
@@ -48,6 +176,54 @@ declare const updateVisitorRequestSchema: z.ZodObject<{
   timezone: z.ZodOptional<z.ZodString>;
   screenResolution: z.ZodOptional<z.ZodString>;
   viewport: z.ZodOptional<z.ZodString>;
+  attribution: z.ZodOptional<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    firstTouch: z.ZodObject<{
+      channel: z.ZodEnum<{
+        email: "email";
+        direct: "direct";
+        paid: "paid";
+        organic_search: "organic_search";
+        social: "social";
+        referral: "referral";
+      }>;
+      isDirect: z.ZodBoolean;
+      referrer: z.ZodObject<{
+        url: z.ZodNullable<z.ZodString>;
+        domain: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      landing: z.ZodObject<{
+        url: z.ZodNullable<z.ZodString>;
+        path: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      utm: z.ZodObject<{
+        source: z.ZodNullable<z.ZodString>;
+        medium: z.ZodNullable<z.ZodString>;
+        campaign: z.ZodNullable<z.ZodString>;
+        content: z.ZodNullable<z.ZodString>;
+        term: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      clickIds: z.ZodObject<{
+        gclid: z.ZodNullable<z.ZodString>;
+        gbraid: z.ZodNullable<z.ZodString>;
+        wbraid: z.ZodNullable<z.ZodString>;
+        fbclid: z.ZodNullable<z.ZodString>;
+        msclkid: z.ZodNullable<z.ZodString>;
+        ttclid: z.ZodNullable<z.ZodString>;
+        li_fat_id: z.ZodNullable<z.ZodString>;
+        twclid: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      capturedAt: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+  currentPage: z.ZodOptional<z.ZodObject<{
+    url: z.ZodNullable<z.ZodString>;
+    path: z.ZodNullable<z.ZodString>;
+    title: z.ZodNullable<z.ZodString>;
+    referrerUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodBoolean]>, z.ZodNull]>>>;
 }, z.core.$strip>;
 type UpdateVisitorRequest = z.infer<typeof updateVisitorRequestSchema>;
@@ -99,6 +275,54 @@ declare const visitorResponseSchema: z.ZodObject<{
   blockedAt: z.ZodNullable<z.ZodString>;
   blockedByUserId: z.ZodNullable<z.ZodString>;
   isBlocked: z.ZodBoolean;
+  attribution: z.ZodNullable<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    firstTouch: z.ZodObject<{
+      channel: z.ZodEnum<{
+        email: "email";
+        direct: "direct";
+        paid: "paid";
+        organic_search: "organic_search";
+        social: "social";
+        referral: "referral";
+      }>;
+      isDirect: z.ZodBoolean;
+      referrer: z.ZodObject<{
+        url: z.ZodNullable<z.ZodString>;
+        domain: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      landing: z.ZodObject<{
+        url: z.ZodNullable<z.ZodString>;
+        path: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      utm: z.ZodObject<{
+        source: z.ZodNullable<z.ZodString>;
+        medium: z.ZodNullable<z.ZodString>;
+        campaign: z.ZodNullable<z.ZodString>;
+        content: z.ZodNullable<z.ZodString>;
+        term: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      clickIds: z.ZodObject<{
+        gclid: z.ZodNullable<z.ZodString>;
+        gbraid: z.ZodNullable<z.ZodString>;
+        wbraid: z.ZodNullable<z.ZodString>;
+        fbclid: z.ZodNullable<z.ZodString>;
+        msclkid: z.ZodNullable<z.ZodString>;
+        ttclid: z.ZodNullable<z.ZodString>;
+        li_fat_id: z.ZodNullable<z.ZodString>;
+        twclid: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+      capturedAt: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+  currentPage: z.ZodNullable<z.ZodObject<{
+    url: z.ZodNullable<z.ZodString>;
+    path: z.ZodNullable<z.ZodString>;
+    title: z.ZodNullable<z.ZodString>;
+    referrerUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
   contact: z.ZodNullable<z.ZodObject<{
     id: z.ZodULID;
     externalId: z.ZodNullable<z.ZodString>;
@@ -134,5 +358,5 @@ declare const publicVisitorResponseSchema: z.ZodObject<{
 type PublicVisitor = z.infer<typeof publicVisitorResponseSchema>;
 type PublicVisitorResponse = PublicVisitor;
 //#endregion
-export { PublicContact, PublicVisitor, PublicVisitorResponse, UpdateVisitorMetadataRequest, UpdateVisitorRequest, Visitor, VisitorMetadata, VisitorResponse, publicContactResponseSchema, publicVisitorResponseSchema, updateVisitorMetadataRequestSchema, updateVisitorRequestSchema, visitorMetadataSchema, visitorProfileSchema, visitorResponseSchema };
+export { AttributionChannel, PublicContact, PublicVisitor, PublicVisitorResponse, UpdateVisitorMetadataRequest, UpdateVisitorRequest, Visitor, VisitorAttribution, VisitorAttributionClickIds, VisitorAttributionFirstTouch, VisitorAttributionLanding, VisitorAttributionReferrer, VisitorAttributionUtm, VisitorCurrentPage, VisitorMetadata, VisitorResponse, attributionChannelSchema, publicContactResponseSchema, publicVisitorResponseSchema, updateVisitorMetadataRequestSchema, updateVisitorRequestSchema, visitorAttributionClickIdsSchema, visitorAttributionFirstTouchSchema, visitorAttributionLandingSchema, visitorAttributionReferrerSchema, visitorAttributionSchema, visitorAttributionUtmSchema, visitorCurrentPageSchema, visitorMetadataSchema, visitorProfileSchema, visitorResponseSchema };
 //# sourceMappingURL=visitor.d.ts.map

package/api/visitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visitor.d.ts","names":[],"sources":["../../src/api/visitor.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;;AAAkC,cAArB,qBAAqB,EAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,SAAA,CAAA,CAAA,EAAA,CAAA,CAAA,UAAA,CAAA,CAAA,EAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA;;;;AAAA,cAQrB,2BARqB,EAQM,CAAA,CAAA,SARN,CAAA;EAAA,EAAA,WAAA;EAAA,IAAA,eAAA,YAAA,CAAA;EAAA,KAAA,eAAA,YAAA,CAAA;EAAA,KAAA,eAAA,YAAA,CAAA;EAQrB,YAAA,eAAA,YAsBX,CAAA;;KAEU,aAAA,GAAgB,CAAA,CAAE,aAAa;KAE/B,eAAA,GAAkB,CAAA,CAAE,aAAa;;;;cAKhC,4BAA0B,CAAA,CAAA;;;;EA/BC,OAAA,eAAA,YAAA,CAAA;EAAA,cAAA,eAAA,YAAA,CAAA;EAwB5B,EAAA,eAAa,YAAkB,CAAA;EAE/B,SAAA,eAAe,YAAkB,CAAA;EAKhC,MAAA,eAAA,YAsJX,CAAA;;;;;;;;;;;;;;;;;;;;KAEU,oBAAA,GAAuB,CAAA,CAAE,aAAa;cAErC,oCAAkC,CAAA,CAAA;;;KAOnC,4BAAA,GAA+B,CAAA,CAAE,aACrC;cAGK,sBAAoB,CAAA,CAAA;;;;;;;;;;;;;;;;;cA2BpB,uBAAqB,CAAA,CAAA;;;;;;;;;;EAhMK,MAAA,eAAA,YAAA,CAAA;EAAA,OAAA,eAAA,YAAA,CAAA;EAwJ3B,WAAA,eAAoB,YAAkB,CAAA;EAErC,QAAA,eAAA,YAAA,CAAA;;;;;;;;;;;EAAkC,SAAA,eAAA,YAAA,CAAA;EAAA,eAAA,eAAA,YAAA,CAAA;EAOnC,SAAA,cAAA;EAIC,OAAA,eAAA,YAsBX,CAAA;;;;;;;;;;;;;;;KAkHU,OAAA,GAAU,CAAA,CAAE,aAAa;KACzB,eAAA,GAAkB;;;;cAKjB,6BAA2B,CAAA,CAAA;;EA9IP,SAAA,cAAA;EAAA,QAAA,eAAA,YAAA,CAAA;EA2BpB,OAAA,eAAA,YA2GX,CAAA;;;;;;;;KAiCU,aAAA,GAAgB,CAAA,CAAE,aAAa;KAC/B,qBAAA,GAAwB"}
+{"version":3,"file":"visitor.d.ts","names":[],"sources":["../../src/api/visitor.ts"],"sourcesContent":[],"mappings":"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"}

package/api/visitor.js

@@ -32,6 +32,143 @@ const publicContactResponseSchema = z.object({
 		example: "a1b2c3d4"
 	})
 });
+const attributionChannelSchema = z.enum([
+	"direct",
+	"email",
+	"paid",
+	"organic_search",
+	"social",
+	"referral"
+]);
+const nullableStringSchema = z.string().nullable();
+const nullableUrlSchema = z.string().url().nullable();
+const visitorAttributionReferrerSchema = z.object({
+	url: nullableUrlSchema.openapi({
+		description: "Sanitized external referrer URL without arbitrary query data.",
+		example: "https://news.ycombinator.com/item?id=123"
+	}),
+	domain: nullableStringSchema.openapi({
+		description: "Normalized referrer hostname.",
+		example: "news.ycombinator.com"
+	})
+});
+const visitorAttributionLandingSchema = z.object({
+	url: nullableUrlSchema.openapi({
+		description: "Sanitized landing page URL including only supported attribution params.",
+		example: "https://app.example.com/pricing?utm_source=hn&utm_medium=community"
+	}),
+	path: nullableStringSchema.openapi({
+		description: "Landing page path.",
+		example: "/pricing"
+	}),
+	title: nullableStringSchema.openapi({
+		description: "Document title captured on the landing page.",
+		example: "Pricing | Example"
+	})
+});
+const visitorAttributionUtmSchema = z.object({
+	source: nullableStringSchema.openapi({
+		description: "UTM source value.",
+		example: "hn"
+	}),
+	medium: nullableStringSchema.openapi({
+		description: "UTM medium value.",
+		example: "community"
+	}),
+	campaign: nullableStringSchema.openapi({
+		description: "UTM campaign value.",
+		example: "launch_week"
+	}),
+	content: nullableStringSchema.openapi({
+		description: "UTM content value.",
+		example: "hero_cta"
+	}),
+	term: nullableStringSchema.openapi({
+		description: "UTM term value.",
+		example: "ai support"
+	})
+});
+const visitorAttributionClickIdsSchema = z.object({
+	gclid: nullableStringSchema.openapi({
+		description: "Google Ads click identifier.",
+		example: "gclid_123"
+	}),
+	gbraid: nullableStringSchema.openapi({
+		description: "Google iOS app click identifier.",
+		example: "gbraid_123"
+	}),
+	wbraid: nullableStringSchema.openapi({
+		description: "Google web-to-app click identifier.",
+		example: "wbraid_123"
+	}),
+	fbclid: nullableStringSchema.openapi({
+		description: "Meta click identifier.",
+		example: "fbclid_123"
+	}),
+	msclkid: nullableStringSchema.openapi({
+		description: "Microsoft Ads click identifier.",
+		example: "msclkid_123"
+	}),
+	ttclid: nullableStringSchema.openapi({
+		description: "TikTok click identifier.",
+		example: "ttclid_123"
+	}),
+	li_fat_id: nullableStringSchema.openapi({
+		description: "LinkedIn click identifier.",
+		example: "li_fat_id_123"
+	}),
+	twclid: nullableStringSchema.openapi({
+		description: "X/Twitter click identifier.",
+		example: "twclid_123"
+	})
+});
+const visitorAttributionFirstTouchSchema = z.object({
+	channel: attributionChannelSchema.openapi({
+		description: "Derived acquisition channel.",
+		example: "referral"
+	}),
+	isDirect: z.boolean().openapi({
+		description: "Whether the visit should be treated as direct traffic.",
+		example: false
+	}),
+	referrer: visitorAttributionReferrerSchema,
+	landing: visitorAttributionLandingSchema,
+	utm: visitorAttributionUtmSchema,
+	clickIds: visitorAttributionClickIdsSchema,
+	capturedAt: z.string().openapi({
+		description: "When the first-touch attribution snapshot was captured.",
+		example: "2026-03-12T10:00:00.000Z"
+	})
+});
+const visitorAttributionSchema = z.object({
+	version: z.literal(1).openapi({
+		description: "Schema version for the attribution payload.",
+		example: 1
+	}),
+	firstTouch: visitorAttributionFirstTouchSchema
+});
+const visitorCurrentPageSchema = z.object({
+	url: nullableUrlSchema.openapi({
+		description: "Sanitized current page URL including only supported attribution params.",
+		example: "https://app.example.com/pricing"
+	}),
+	path: nullableStringSchema.openapi({
+		description: "Current page path.",
+		example: "/pricing"
+	}),
+	title: nullableStringSchema.openapi({
+		description: "Current document title.",
+		example: "Pricing | Example"
+	}),
+	referrerUrl: nullableUrlSchema.openapi({
+		description: "Sanitized document referrer URL for the current page context.",
+		example: "https://news.ycombinator.com/item?id=123"
+	}),
+	updatedAt: z.string().openapi({
+		description: "When the current page context was last updated.",
+		example: "2026-03-12T10:00:05.000Z"
+	})
+});
 /**
 * Visitor data update request schema
 */
@@ -121,6 +258,8 @@ const updateVisitorRequestSchema = z.object({
 		description: "The visitor's viewport size.",
 		example: "1920x900"
 	}).optional(),
+	attribution: visitorAttributionSchema.openapi({ description: "Normalized acquisition data captured for this visitor." }).optional(),
+	currentPage: visitorCurrentPageSchema.openapi({ description: "Latest page context captured for this visitor." }).optional(),
 	metadata: visitorMetadataSchema.openapi({
 		description: "Additional custom metadata for the visitor.",
 		example: {
@@ -267,6 +406,8 @@ const visitorResponseSchema = z.object({
 		description: "Whether the visitor is currently blocked.",
 		example: true
 	}),
+	attribution: visitorAttributionSchema.nullable().openapi({ description: "Normalized acquisition data captured for this visitor." }),
+	currentPage: visitorCurrentPageSchema.nullable().openapi({ description: "Latest page context captured for this visitor." }),
 	contact: contactResponseSchema.nullable()
 });
 /**
@@ -297,5 +438,5 @@ const publicVisitorResponseSchema = z.object({
 });
 
 //#endregion
-export { publicContactResponseSchema, publicVisitorResponseSchema, updateVisitorMetadataRequestSchema, updateVisitorRequestSchema, visitorMetadataSchema, visitorProfileSchema, visitorResponseSchema };
+export { attributionChannelSchema, publicContactResponseSchema, publicVisitorResponseSchema, updateVisitorMetadataRequestSchema, updateVisitorRequestSchema, visitorAttributionClickIdsSchema, visitorAttributionFirstTouchSchema, visitorAttributionLandingSchema, visitorAttributionReferrerSchema, visitorAttributionSchema, visitorAttributionUtmSchema, visitorCurrentPageSchema, visitorMetadataSchema, visitorProfileSchema, visitorResponseSchema };
 //# sourceMappingURL=visitor.js.map