tpmjs/packages/tools/official/date-parse
Ajax Davis 48c41e8733 feat: add use cases marketing product with AI-generated content
Transform qualifying scenarios into marketing-ready use cases with:
- AI-generated titles, descriptions, ROI estimates, business value
- Persona/industry/category taxonomy for targeting
- Browseable feed with filtering and ranking
- SEO-optimized case study pages
- Daily cron job for generation and ranking

Database:
- Add Persona, Industry, Category lookup tables
- Add UseCase model with marketing content fields
- Add junction tables for personas/industries/categories
- Add SocialProof model for cached metrics

API:
- GET /api/use-cases - Global directory with filtering
- GET /api/use-cases/[id] - Individual use case details
- GET /api/public/users/[username]/collections/[slug]/use-cases
- POST /api/cron/use-cases - Nightly generation job

Frontend:
- /use-cases - Global feed with persona dropdown
- /use-cases/[slug] - SEO case study page
- /[username]/collections/[slug]/use-cases - Collection feed
- UseCasesFeed component - Sortable table component
- UseCaseCaseStudy component - Full case study layout
2026-01-20 16:17:35 +10:00
..
src feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00
CHANGELOG.md chore: version packages 2025-12-31 23:54:47 +10:00
package.json chore: update dependencies with compatibility fixes 2026-01-09 22:49:41 +10:00
README.md feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00
tsconfig.json feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00
tsup.config.bundled_ko2hafosm0g.mjs feat: add use cases marketing product with AI-generated content 2026-01-20 16:17:35 +10:00
tsup.config.ts feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00

@tpmjs/tools-date-parse

Parse dates in various natural language formats using chrono-node.

Installation

npm install @tpmjs/tools-date-parse

Usage

import { dateParseTool } from '@tpmjs/tools-date-parse';

const result = await dateParseTool.execute({
  text: 'Meeting tomorrow at 3pm and follow-up next Friday'
});

console.log(result.count);
// => 2

console.log(result.dates[0]);
// => {
//   parsed: "Thursday, January 16, 2025 at 3:00:00 PM EST",
//   original: "tomorrow at 3pm",
//   iso: "2025-01-16T20:00:00.000Z",
//   timestamp: 1737057600000
// }

Options

// Use a custom reference date
const result = await dateParseTool.execute({
  text: 'in 2 weeks',
  referenceDate: '2024-01-01T00:00:00Z'
});

// Use strict mode for fewer false positives
const result = await dateParseTool.execute({
  text: 'The year 2024 was great',
  strict: true
});

Features

  • Natural language: Parses dates like "tomorrow", "next week", "in 3 days"
  • Absolute dates: Handles "December 25th, 2024", "Jan 1", "2024-01-15"
  • Times: Supports "3pm", "15:30", "9:00 AM"
  • Multiple dates: Extracts all dates from a single text input
  • Reference dates: Calculate relative dates from a custom starting point
  • Strict mode: Reduce false positives with stricter parsing

License

MIT