Tally MCP

<!-- Generated by SpecStory --> # Proceed with version 9.5 (2025-06-06 17:46:22) _**User**_ Please proceed with 9.5 --- _**Assistant**_ --- I'll help you proceed with subtask 9.5. Let me first check the current status and details of this subtask. --- --- Now let me check what's been implemented so far in the codebase related to form sharing and publication: --- <details> <summary>Listed directory src • **8** results</summary> | Name | |-------| | 📁 `models` | | 📁 `tools` | | 📁 `services` | | 📁 `middleware` | | 📁 `utils` | | 📁 `__tests__` | | 📄 `server.ts` | | 📄 `index.ts` | </details> --- <details> <summary>Listed directory src/models • **9** results</summary> | Name | |-------| | 📄 `index.ts` | | 📄 `team-models.ts` | | 📄 `api-key.ts` | | 📄 `tally-schemas.ts` | | 📄 `template.ts` | | 📄 `form-config.ts` | | 📄 `form-version.ts` | | 📄 `form-config-schemas.ts` | | 📄 `errors.ts` | </details> --- <details> <summary>Listed directory src/services • **14** results</summary> | Name | |-------| | 📄 `index.ts` | | 📄 `team-service.ts` | | 📁 `__tests__` | | 📄 `api-key-service.ts` | | 📄 `form-permission-service.ts` | | 📄 `workspace-service.ts` | | 📄 `TallyApiClient.ts` | | 📄 `submission-service.ts` | | 📄 `nlp-service.ts` | | 📄 `template-service.ts` | | 📄 `form-modification-operations.ts` | | 📄 `tally-api-service.ts` | | 📄 `form-modification-parser.ts` | | 📄 `TokenManager.ts` | </details> --- I notice there's no FormPublicationService yet. Let me check if there are any form sharing related models or schemas: --- <details> <summary>Grep search for "FormSharing|Publication|sharing|publication" • **5** files</summary> | File | Line | Match | |------|------|-------| | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-05_14-04-create-prd-for-tally-so-api-server.md` | L61 | `+ - **Form Sharing**: Manages form publication, sharing settings, and embed code generation` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.taskmaster/docs/prd.txt` | L31 | `- **Form Sharing**: Manages form publication, sharing settings, and embed code generation` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2670 | `The next suggested subtask is 9.5 "Implement Form Sharing and Publication Settings". Would you like me to proceed with that?` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2686 | `Great! I'll proceed with subtask 9.5 "Implement Form Sharing and Publication Settings". Let me first get the details of this subtask and then start implementation.` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2694 | `Perfect! Now let me set this subtask to in-progress and start implementing the Form Sharing and Publication Settings functionality.` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2707 | `<summary>Searched codebase "form sharing publication embed code generation TallyForm form visibility" • **25** results</summary>` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2749 | `Now let me create the models and schemas for form sharing and publication functionality:` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2758 | `+ // FORM VISIBILITY AND SHARING TYPES` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2775 | `+ export const FormPublicationSettingsSchema = z.object({` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L2962 | `+ // SHARING OPERATIONS AND BULK ACTIONS` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L3035 | `+ export const FormSharingStatsSchema = z.object({` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L3057 | `+ export type FormPublicationSettings = z.infer<typeof FormPublicationSettingsSchema>;` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L3074 | `+ export type FormSharingStats = z.infer<typeof FormSharingStatsSchema>;` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L3079 | `Now let me update the models index to export the new form sharing models:` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L3092 | `+ export * from './form-sharing-models';` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_20-28-continue-with-version-10-5.md` | L3109 | `Now let me create the FormPublicationService that will handle all the sharing and publication functionality:` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-05_16-32-continue-previous-discussion.md` | L1662 | `Now let me debug the port conflict issue first. The problem might be that both servers are sharing some state or the first server isn't actually binding to the port properly. Let me check if we can improve the port binding detection:` | | `file:///Users/cryophobic/dev/projects/tally-mcp/.specstory/history/2025-06-06_17-27-continue-with-the-next-task.md` | L31 | `- ⏱️ Subtask 9.5: Implement Form Sharing and Publication Settings - **Pending**` | </details> --- Let me check if the form sharing models were already created: --- <details> <summary>Searched codebase "form-sharing-models" • **0** results</summary> No results found </details> --- Could not find file 'src/models' in the workspace. --- <details> <summary>Listed directory src/models • **9** results</summary> | Name | |-------| | 📄 `index.ts` | | 📄 `team-models.ts` | | 📄 `api-key.ts` | | 📄 `tally-schemas.ts` | | 📄 `template.ts` | | 📄 `form-config.ts` | | 📄 `form-version.ts` | | 📄 `form-config-schemas.ts` | | 📄 `errors.ts` | </details> --- I see that the form-sharing-models.ts file doesn't exist yet. Let me check the models index to see what's currently exported: --- Read file: src/models/index.ts --- Now I need to create the form sharing models and the FormPublicationService. Let me start by creating the form sharing models: --- ```diff - + import { z } from 'zod'; + + // FORM VISIBILITY AND SHARING TYPES + + export enum FormVisibility { + PRIVATE = 'private', + ORGANIZATION = 'organization', + PUBLIC = 'public', + PASSWORD_PROTECTED = 'password_protected', + LINK_ONLY = 'link_only' + } + + export enum EmbedTheme { + LIGHT = 'light', + DARK = 'dark', + AUTO = 'auto', + CUSTOM = 'custom' + } + + export enum ShareLinkType { + STANDARD = 'standard', + EMBED = 'embed', + QR_CODE = 'qr_code', + SOCIAL = 'social' + } + + // ZOD SCHEMAS + + export const FormVisibilitySchema = z.nativeEnum(FormVisibility); + export const EmbedThemeSchema = z.nativeEnum(EmbedTheme); + export const ShareLinkTypeSchema = z.nativeEnum(ShareLinkType); + + export const FormPublicationSettingsSchema = z.object({ + formId: z.string(), + visibility: FormVisibilitySchema, + isPublished: z.boolean().default(false), + publishedAt: z.string().datetime().optional(), + unpublishedAt: z.string().datetime().optional(), + + // Access Control + passwordRequired: z.boolean().default(false), + password: z.string().optional(), + allowedDomains: z.array(z.string()).optional(), + ipWhitelist: z.array(z.string()).optional(), + + // Scheduling + publishDate: z.string().datetime().optional(), + unpublishDate: z.string().datetime().optional(), + + // Notifications + notifyOnSubmission: z.boolean().default(true), + notificationEmails: z.array(z.string().email()), + + // SEO and Metadata + metaTitle: z.string().optional(), + metaDescription: z.string().optional(), + customSlug: z.string().optional(), + + // Advanced Settings + trackAnalytics: z.boolean().default(true), + allowIndexing: z.boolean().default(false), + requireCaptcha: z.boolean().default(false), + + // Created/Updated timestamps + createdAt: z.string().datetime(), + updatedAt: z.string().datetime() + }); + + export const EmbedCodeSettingsSchema = z.object({ + formId: z.string(), + theme: EmbedThemeSchema.default(EmbedTheme.LIGHT), + autoHeight: z.boolean().default(true), + width: z.string().default('100%'), + height: z.string().optional(), + backgroundColor: z.string().optional(), + borderRadius: z.number().min(0).max(50).default(8), + + // Behavior Settings + hideHeader: z.boolean().default(false), + hideFooter: z.boolean().default(false), + enableRedirect: z.boolean().default(true), + redirectUrl: z.string().url().optional(), + + // Loading and Animation + showLoadingSpinner: z.boolean().default(true), + animateOnLoad: z.boolean().default(true), + + // Custom CSS + customCss: z.string().optional(), + + // Security + allowedOrigins: z.array(z.string()).optional(), + sandbox: z.boolean().default(true) + }); + + export const ShareLinkSchema = z.object({ + id: z.string(), + formId: z.string(), + type: ShareLinkTypeSchema, + url: z.string().url(), + shortUrl: z.string().url().optional(), + + // Access Control + isActive: z.boolean().default(true), + passwordProtected: z.boolean().default(false), + password: z.string().optional(), + + // Usage Limits + maxUses: z.number().positive().optional(), + currentUses: z.number().min(0).default(0), + + // Expiration + expiresAt: z.string().datetime().optional(), + + // Tracking + trackClicks: z.boolean().default(true), + trackSubmissions: z.boolean().default(true), + + // Metadata + title: z.string().optional(), + description: z.string().optional(), + tags: z.array(z.string()).default([]), + + // Timestamps + createdAt: z.string().datetime(), + updatedAt: z.string().datetime(), + lastAccessedAt: z.string().datetime().optional() + }); + + export const FormSharingStatsSchema = z.object({ + formId: z.string(), + + // View Statistics + totalViews: z.number().min(0).default(0), + uniqueViews: z.number().min(0).default(0), + viewsToday: z.number().min(0).default(0), + viewsThisWeek: z.number().min(0).default(0), + viewsThisMonth: z.number().min(0).default(0), + + // Submission Statistics + totalSubmissions: z.number().min(0).default(0), + submissionsToday: z.number().min(0).default(0), + submissionsThisWeek: z.number().min(0).default(0), + submissionsThisMonth: z.number().min(0).default(0), + + // Conversion Metrics + conversionRate: z.number().min(0).max(100).default(0), + averageTimeToComplete: z.number().min(0).optional(), // in seconds + + // Traffic Sources + topReferrers: z.array(z.object({ + domain: z.string(), + visits: z.number().min(0) + })).default([]), + + // Geographic Data + topCountries: z.array(z.object({ + country: z.string(), + visits: z.number().min(0) + })).default([]), + + // Device/Browser Stats + deviceStats: z.object({ + desktop: z.number().min(0).default(0), + mobile: z.number().min(0).default(0), + tablet: z.number().min(0).default(0) + }).default({}), + + // Timestamps + lastUpdated: z.string().datetime() + }); + + export const BulkSharingOperationSchema = z.object({ + operationType: z.enum(['publish', 'unpublish', 'update_settings', 'generate_links']), + formIds: z.array(z.string()).min(1), + settings: z.record(z.any()).optional(), + + // Scheduling + executeAt: z.string().datetime().optional(), + + // Progress Tracking + status: z.enum(['pending', 'in_progress', 'completed', 'failed']).default('pending'), + completedCount: z.number().min(0).default(0), + failedCount: z.number().min(0).default(0), + errors: z.array(z.string()).default([]), + + // Timestamps + createdAt: z.string().datetime(), + startedAt: z.string().datetime().optional(), + completedAt: z.string().datetime().optional() + }); + + // TYPESCRIPT INTERFACES + + export type FormPublicationSettings = z.infer<typeof FormPublicationSettingsSchema>; + export type EmbedCodeSettings = z.infer<typeof EmbedCodeSettingsSchema>; + export type ShareLink = z.infer<typeof ShareLinkSchema>; + export type FormSharingStats = z.infer<typeof FormSharingStatsSchema>; + export type BulkSharingOperation = z.infer<typeof BulkSharingOperationSchema>; + + // HELPER INTERFACES + + export interface GeneratedEmbedCode { + html: string; + javascript: string; + iframe: string; + settings: EmbedCodeSettings; + } + + export interface ShareLinkGenerationOptions { + type: ShareLinkType; + customSlug?: string; + password?: string; + expirationHours?: number; + maxUses?: number; + trackingEnabled?: boolean; + } + + export interface FormAnalyticsData { + formId: string; + period: 'day' | 'week' | 'month' | 'year'; + metrics: { + views: number[]; + submissions: number[]; + conversionRates: number[]; + dates: string[]; + }; + summary: FormSharingStats; + } + + export interface PublicationValidationResult { + isValid: boolean; + errors: string[]; + warnings: string[]; + canPublish: boolean; + } ``` --- Now let me update the models index to export the new form sharing models: --- ```diff // Export team and organization models export * from './team-models'; + + // Export form sharing and publication models + export * from './form-sharing-models'; ``` --- Now let me create the FormPublicationService to handle all the sharing and publication functionality: --- Cancelled --- Cancelled --- --- ---