In recent years...
',\n coverImage: 'https://example.com/cover.jpg',\n canonicalUrl: 'https://blog.example.com/sustainable-tech'\n })\n .build();\n\nconsole.log(article.shareType); // \"article\"\n```\n\n### Image Carousel Post\n\n```typescript\nimport { LinkedInContentBuilder } from '@bernierllc/social-media-content-type-linkedin';\n\nconst carousel = builder\n .setText('Our journey in 9 images')\n .addMedia({\n type: 'image',\n url: 'https://example.com/image1.jpg',\n title: 'Beginning'\n })\n .addMedia({\n type: 'image',\n url: 'https://example.com/image2.jpg',\n title: 'Growth'\n })\n // Add up to 9 images total\n .build();\n```\n\n### Video Post\n\n```typescript\nimport { LinkedInContentBuilder } from '@bernierllc/social-media-content-type-linkedin';\n\nconst video = builder\n .setText('Watch our product demo')\n .addMedia({\n type: 'video',\n url: 'https://example.com/demo.mp4',\n thumbnailUrl: 'https://example.com/thumb.jpg',\n description: 'Full product walkthrough'\n })\n .setShareType('video')\n .build();\n```\n\n### Document Sharing\n\n```typescript\nimport { LinkedInContentBuilder } from '@bernierllc/social-media-content-type-linkedin';\n\nconst document = builder\n .setText('Download our latest whitepaper')\n .setDocument({\n type: 'pdf',\n url: 'https://example.com/whitepaper.pdf',\n title: 'Industry Trends 2025',\n description: 'Comprehensive analysis of market trends'\n })\n .build();\n\nconsole.log(document.shareType); // \"document\"\n```\n\n### Poll Creation\n\n```typescript\nimport { LinkedInContentBuilder } from '@bernierllc/social-media-content-type-linkedin';\n\nconst poll = builder\n .setText('What matters most to you in a workplace?')\n .addPoll({\n question: 'What matters most to you in a workplace?',\n options: [\n 'Work-life balance',\n 'Career growth',\n 'Compensation',\n 'Company culture'\n ],\n durationDays: 7\n })\n .build();\n```\n\n### Content Validation\n\n```typescript\nimport { LinkedInContentValidator } from '@bernierllc/social-media-content-type-linkedin';\n\nconst validator = new LinkedInContentValidator();\n\nconst result = validator.validate(content);\n\nif (!result.valid) {\n console.error('Validation errors:', result.errors);\n // [{\n // field: \"text\",\n // message: \"Text exceeds 3000 characters\",\n // constraint: \"maxTextLength\",\n // value: 3150\n // }]\n}\n\n// Check warnings and suggestions\nconsole.log('Warnings:', result.warnings);\nconsole.log('Suggestions:', result.suggestions);\n```\n\n### Content Transformation\n\n#### From Generic Social Content\n\n```typescript\nimport { LinkedInContentTransformer } from '@bernierllc/social-media-content-type-linkedin';\n\nconst transformer = new LinkedInContentTransformer();\n\nconst genericContent = {\n text: 'Check out our new product!',\n images: ['https://example.com/product.jpg'],\n hashtags: ['tech', 'innovation', 'startup', 'business']\n};\n\nconst linkedInContent = transformer.fromGeneric(genericContent);\n\nconsole.log(linkedInContent);\n// {\n// text: \"Check out our new product!\\n\\n#tech #innovation #startup\",\n// shareType: \"post\",\n// media: [{ type: \"image\", url: \"https://example.com/product.jpg\" }]\n// }\n// Note: Only first 3 hashtags recommended for LinkedIn\n```\n\n#### From Blog Post\n\n```typescript\nimport { LinkedInContentTransformer } from '@bernierllc/social-media-content-type-linkedin';\n\nconst transformer = new LinkedInContentTransformer();\n\n// Short blog post becomes regular post with link\nconst shortBlog = {\n title: 'Quick Tips for Success',\n excerpt: '5 practical tips every professional should know',\n content: 'Tip 1: ...', // < 1000 chars\n url: 'https://blog.example.com/tips',\n featuredImage: 'https://blog.example.com/featured.jpg',\n tags: ['productivity', 'career']\n};\n\nconst linkedInPost = transformer.fromBlogPost(shortBlog);\n\nconsole.log(linkedInPost.shareType); // \"post\"\nconsole.log(linkedInPost.link?.url); // \"https://blog.example.com/tips\"\n\n// Long blog post becomes LinkedIn article\nconst longBlog = {\n title: 'The Complete Guide to Digital Transformation',\n excerpt: 'Everything you need to know about digital transformation',\n content: '...' // > 1000 chars\n + // Long content...\n url: 'https://blog.example.com/guide',\n featuredImage: 'https://blog.example.com/guide-cover.jpg'\n};\n\nconst linkedInArticle = transformer.fromBlogPost(longBlog);\n\nconsole.log(linkedInArticle.shareType); // \"article\"\nconsole.log(linkedInArticle.article?.title); // \"The Complete Guide to...\"\n```\n\n### LinkedIn Optimization\n\n```typescript\nimport { LinkedInContentTransformer } from '@bernierllc/social-media-content-type-linkedin';\n\nconst transformer = new LinkedInContentTransformer();\n\nconst content = {\n text: 'this is a post #tech #business #marketing #sales #startup #innovation',\n shareType: 'post' as const\n};\n\n// Optimize for LinkedIn best practices\nconst optimized = transformer.optimizeForLinkedIn(content);\n\nconsole.log(optimized.text);\n// \"This is a post\\n\\n#tech #business #marketing\"\n// - Capitalized first letter\n// - Limited to 3 hashtags (recommended)\n```\n\n## API Reference\n\n### LinkedInContent\n\nMain content structure for LinkedIn posts.\n\n```typescript\ninterface LinkedInContent {\n text: string; // Post text (max 3000 chars)\n shareType: 'post' | 'article' | 'video' | 'document';\n article?: LinkedInArticle; // Long-form article\n media?: LinkedInMedia[]; // Up to 9 images or 1 video\n document?: LinkedInDocument; // PDF/PPTX/DOCX\n link?: LinkedInLink; // Link preview\n poll?: LinkedInPoll; // Poll configuration\n}\n```\n\n### LinkedInArticle\n\nLinkedIn article (long-form content).\n\n```typescript\ninterface LinkedInArticle {\n title: string; // Max 100 chars\n subtitle?: string; // Max 250 chars\n content: string; // Rich HTML content (max 125K chars)\n coverImage?: string; // Article cover image URL\n canonicalUrl?: string; // Original article URL\n}\n```\n\n### LinkedInMedia\n\nImage or video media item.\n\n```typescript\ninterface LinkedInMedia {\n type: 'image' | 'video';\n url: string;\n title?: string; // Max 200 chars\n description?: string; // Max 2000 chars\n thumbnailUrl?: string; // Video thumbnail (required for video)\n}\n```\n\n### LinkedInDocument\n\nDocument attachment (PDF, PowerPoint, Word).\n\n```typescript\ninterface LinkedInDocument {\n type: 'pdf' | 'pptx' | 'docx';\n url: string;\n title: string; // Max 255 chars\n description?: string;\n}\n```\n\n### LinkedInPoll\n\nPoll configuration.\n\n```typescript\ninterface LinkedInPoll {\n question: string; // Max 140 chars\n options: string[]; // 2-4 options, max 255 chars each\n durationDays: 1 | 3 | 7 | 14; // Poll duration\n}\n```\n\n### LINKEDIN_CONSTRAINTS\n\nPlatform-specific limits and rules.\n\n```typescript\nexport const LINKEDIN_CONSTRAINTS = {\n maxTextLength: 3000, // Post text limit\n maxArticleContentLength: 125000, // Article content limit\n maxMediaItems: 9, // Max images in carousel\n maxVideoCount: 1, // Only 1 video per post\n maxHashtags: 3, // Recommended hashtag count\n maxAbsoluteHashtags: 30, // Technical hashtag limit\n supportedMediaTypes: ['image/png', 'image/jpeg', 'video/mp4'],\n supportedDocumentTypes: ['application/pdf', ...],\n // ... more constraints\n};\n```\n\n### LinkedInContentValidator\n\nValidates content against LinkedIn constraints.\n\n**Methods:**\n\n- `validate(content: LinkedInContent): LinkedInValidationResult` - Validate complete content\n- `validateText(text: string): boolean` - Validate text length\n- `validateArticle(article: LinkedInArticle): boolean` - Validate article structure\n- `validateMedia(media: LinkedInMedia[]): boolean` - Validate media array\n- `validateDocument(doc: LinkedInDocument): boolean` - Validate document\n- `validatePoll(poll: LinkedInPoll): boolean` - Validate poll configuration\n- `validateHashtags(hashtags: string[]): boolean` - Validate hashtag array\n\n### LinkedInContentBuilder\n\nFluent builder for constructing LinkedIn content.\n\n**Methods:**\n\n- `setText(text: string): this` - Set post text\n- `setShareType(type: 'post' | 'article' | 'video' | 'document'): this` - Set content type\n- `addMedia(media: LinkedInMedia): this` - Add media item\n- `setArticle(article: LinkedInArticle): this` - Set article content\n- `setDocument(doc: LinkedInDocument): this` - Set document\n- `setLink(link: LinkedInLink): this` - Set link preview\n- `addPoll(poll: LinkedInPoll): this` - Add poll\n- `setVisibility(visibility: 'public' | 'connections' | 'private'): this` - Set visibility\n- `addHashtag(tag: string): this` - Add hashtag\n- `addMention(username: string): this` - Add user mention\n- `setScheduledFor(date: Date): this` - Set scheduled publish date\n- `build(): LinkedInContent` - Build final content\n- `validate(): LinkedInValidationResult` - Validate current state\n- `reset(): this` - Reset builder to initial state\n\n### LinkedInContentTransformer\n\nTransforms content between LinkedIn and other formats.\n\n**Methods:**\n\n- `fromGeneric(content: GenericSocialContent): LinkedInContent` - Transform generic social content\n- `fromBlogPost(post: BlogPostContent): LinkedInContent` - Transform blog post\n- `toGeneric(content: LinkedInContent): GenericSocialContent` - Convert to generic format\n- `optimizeForLinkedIn(content: LinkedInContent): LinkedInContent` - Optimize for platform\n- `convertToArticle(post: BlogPostContent): LinkedInArticle` - Convert blog to article\n\n## Platform Best Practices\n\n### Hashtag Optimization\n\nLinkedIn recommends using **1-3 hashtags** for optimal visibility. While the technical limit is 30, posts with more than 3 hashtags see reduced engagement.\n\n```typescript\n// Good - 3 hashtags\nbuilder.addHashtag('tech').addHashtag('innovation').addHashtag('startup');\n\n// Too many - reduces visibility\nbuilder.addHashtag('tag1').addHashtag('tag2')...(10 more)...\n```\n\n### Professional Tone\n\nLinkedIn favors professional, industry-focused content:\n\n```typescript\n// Good professional tone\n\"Excited to announce our new product launch. This innovation addresses key challenges in the healthcare industry. #healthcare #innovation #technology\"\n\n// Too casual for LinkedIn\n\"OMG!!! You guys have to check this out 🔥🔥🔥 #amazing #awesome\"\n```\n\n### Long-Form Articles\n\nUse LinkedIn articles for content over 1000 characters for better formatting and engagement:\n\n```typescript\n// Short content (< 1000 chars) - regular post\nconst shortContent = builder.setText('Quick tip: ...').build();\n\n// Long content (> 1000 chars) - article\nconst longContent = builder\n .setText('Read my full analysis')\n .setArticle({\n title: 'Complete Analysis',\n content: '...' // Full content here\n })\n .build();\n```\n\n### Media Best Practices\n\n- **Images**: Use 1200x627px for optimal preview\n- **Videos**: Include thumbnail for better engagement\n- **Carousels**: Use 2-9 images to tell a story\n- **Documents**: Use for whitepapers, reports, presentations\n\n## Configuration\n\nNo runtime configuration required. This is a pure content type definition package with static constraints and validation rules.\n\n## Integration Status\n\n### Logger Integration\n**Status**: Not applicable\n\n**Justification**: This is a pure content type definition package with no runtime operations, side effects, or error conditions that require logging. The LinkedInContentValidator, LinkedInContentBuilder, and LinkedInContentTransformer classes are stateless utility classes that perform validation, building, and transformation operations. All errors are thrown as exceptions that calling code can handle, and there are no background operations, network calls, or state changes that would benefit from structured logging.\n\n**Pattern**: Pure functional utility - no logger integration needed. Logging is handled by consuming packages that use this content type.\n\n### NeverHub Integration\n**Status**: Integrated\n\n**Justification**: This package provides NeverHub service discovery integration through content type registration. Content type packages register themselves with NeverHub so that services can discover available content types at runtime. This enables dynamic content type discovery and allows services to adapt to available content types without hard-coded dependencies.\n\n**Pattern**: Service discovery integration - package registers content type with NeverHub for runtime discovery.\n\n**Example Integration**:\n```typescript\nimport { registerLinkedInContentType } from '@bernierllc/social-media-content-type-linkedin/neverhub-registration';\n\n// Register with NeverHub (if available)\nif (typeof detectNeverHub === 'function') {\n registerLinkedInContentType();\n}\n```\n\n### Docs-Suite Integration\n**Status**: Ready\n\n**Format**: TypeDoc-compatible JSDoc comments are included throughout the source code. All public APIs are documented with examples and type information.\n\n## Dependencies\n\n- **@bernierllc/crypto-utils** (^1.0.2) - Document hash generation\n- **validator** (^13.12.0) - String validation utilities\n\n## Related Packages\n\n- [@bernierllc/social-media-content-type-twitter](../social-media-content-type-twitter) - Twitter content types\n- [@bernierllc/social-media-content-type-facebook](../social-media-content-type-facebook) - Facebook content types\n- [@bernierllc/social-media-content-type-instagram](../social-media-content-type-instagram) - Instagram content types\n- [@bernierllc/social-media-linkedin](../../service/social-media-linkedin) - LinkedIn service integration\n- [@bernierllc/social-media-manager](../../service/social-media-manager) - Multi-platform orchestration\n\n## Examples\n\nSee the `/examples` directory for more comprehensive usage examples:\n\n- `basic-post.ts` - Simple text post\n- `article-publishing.ts` - Long-form article\n- `document-sharing.ts` - PDF/PPTX sharing\n- `blog-transformation.ts` - Blog to LinkedIn conversion\n\n## TypeScript Support\n\nThis package is written in TypeScript and includes complete type definitions. All interfaces and types are exported for use in your TypeScript projects.\n\n## Testing\n\nThis package maintains 98%+ test coverage with comprehensive unit and integration tests.\n\n```bash\n# Run tests\nnpm test\n\n# Run with coverage\nnpm run test:coverage\n\n# Build package\nnpm run build\n\n# Lint code\nnpm run lint\n```\n\n## License\n\nCopyright (c) 2025 Bernier LLC. All rights reserved.\n\nThis package is part of the BernierLLC tools monorepo.\n","readmeFilename":"README.md"}