tpmjs-datetime-tools 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# DateTime Tools for TPMJS
+
+TPMJS tools for getting current date and time in various formats and timezones.
+
+## Installation
+
+```bash
+npm install @lmwat/datetime-tools
+```
+
+## Tools
+
+### getCurrentDateTime
+
+Gets the current date and time in various formats and timezones.
+
+**Parameters:**
+- `timezone` (optional): Timezone string (e.g., "America/New_York", "Europe/London", "Asia/Tokyo", "UTC"). Defaults to system timezone.
+- `format` (optional): Output format:
+  - `"iso"`: ISO 8601 format (default)
+  - `"locale"`: Localized string format
+  - `"unix"`: Unix timestamp (seconds since epoch)
+  - `"custom"`: Detailed breakdown with date components
+- `includeOffset` (optional): Include timezone offset in response (default: false)
+
+**Returns:**
+- `success`: Boolean indicating if the operation was successful
+- `datetime`: The formatted date/time string
+- `timestamp`: JavaScript timestamp (milliseconds since epoch)
+- `unixTimestamp`: Unix timestamp (seconds since epoch)
+- `timezone`: The timezone used
+- `offset`: Timezone offset (if includeOffset is true)
+- `components`: Detailed date components (only when format is "custom")
+
+**Example Usage:**
+
+```typescript
+import { getCurrentDateTime } from '@lmwat/datetime-tools';
+
+// Get current time in ISO format
+const result1 = await getCurrentDateTime.execute({});
+// Returns: { success: true, datetime: "2026-02-13T10:30:00.000Z", ... }
+
+// Get current time in New York timezone
+const result2 = await getCurrentDateTime.execute({
+  timezone: 'America/New_York',
+  format: 'locale'
+});
+// Returns: { success: true, datetime: "2/13/2026, 5:30:00 AM", ... }
+
+// Get detailed breakdown with timezone offset
+const result3 = await getCurrentDateTime.execute({
+  format: 'custom',
+  includeOffset: true
+});
+// Returns detailed components including year, month, day, hour, etc.
+```
+
+## Publishing to TPMJS
+
+This tool is designed to be published to [TPMJS](https://tpmjs.com), where it will be automatically indexed and made available for AI agents to use.
+
+After publishing to npm, your tool will appear on tpmjs.com within 15 minutes.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import * as ai from 'ai';
+import { z } from 'zod';
+
+declare const getCurrentDateTime: ai.Tool<z.ZodObject<{
+    timezone: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["iso", "locale", "unix", "custom"]>>;
+    includeOffset: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    format: "iso" | "locale" | "unix" | "custom";
+    includeOffset: boolean;
+    timezone?: string | undefined;
+}, {
+    timezone?: string | undefined;
+    format?: "iso" | "locale" | "unix" | "custom" | undefined;
+    includeOffset?: boolean | undefined;
+}>, any> & {
+    execute: (args: {
+        format: "iso" | "locale" | "unix" | "custom";
+        includeOffset: boolean;
+        timezone?: string | undefined;
+    }, options: ai.ToolExecutionOptions) => PromiseLike<any>;
+};
+
+export { getCurrentDateTime };

package/dist/index.js

@@ -0,0 +1,88 @@
+// src/tools/getCurrentDateTime.ts
+import { tool } from "ai";
+import { z } from "zod";
+var GetCurrentDateTimeSchema = z.object({
+  timezone: z.string().optional().describe('Optional timezone (e.g., "America/New_York", "Europe/London", "Asia/Tokyo", "UTC"). Defaults to system timezone.'),
+  format: z.enum(["iso", "locale", "unix", "custom"]).default("iso").describe('Output format: "iso" for ISO 8601, "locale" for localized string, "unix" for Unix timestamp, "custom" for detailed breakdown'),
+  includeOffset: z.boolean().default(false).describe("Include timezone offset in the response")
+});
+var getCurrentDateTime = tool({
+  description: "Gets the current date and time in various formats and timezones. Supports ISO 8601, localized strings, Unix timestamps, and detailed date components.",
+  parameters: GetCurrentDateTimeSchema,
+  async execute(input) {
+    if (input.format && !["iso", "locale", "unix", "custom"].includes(input.format)) {
+      return {
+        success: false,
+        error: "Invalid format specified",
+        message: "Format must be one of: iso, locale, unix, custom"
+      };
+    }
+    try {
+      const now = /* @__PURE__ */ new Date();
+      let formattedDate;
+      let offset;
+      if (input.includeOffset || input.format === "custom") {
+        const offsetMinutes = -now.getTimezoneOffset();
+        const offsetHours = Math.floor(Math.abs(offsetMinutes) / 60);
+        const offsetMins = Math.abs(offsetMinutes) % 60;
+        const sign = offsetMinutes >= 0 ? "+" : "-";
+        offset = `${sign}${String(offsetHours).padStart(2, "0")}:${String(offsetMins).padStart(2, "0")}`;
+      }
+      switch (input.format) {
+        case "iso":
+          formattedDate = input.timezone ? new Date(now.toLocaleString("en-US", { timeZone: input.timezone })).toISOString() : now.toISOString();
+          break;
+        case "locale":
+          formattedDate = input.timezone ? now.toLocaleString("en-US", { timeZone: input.timezone }) : now.toLocaleString();
+          break;
+        case "unix":
+          formattedDate = Math.floor(now.getTime() / 1e3).toString();
+          break;
+        case "custom":
+          const dateInTz = input.timezone ? new Date(now.toLocaleString("en-US", { timeZone: input.timezone })) : now;
+          return {
+            success: true,
+            datetime: dateInTz.toISOString(),
+            components: {
+              year: dateInTz.getFullYear(),
+              month: dateInTz.getMonth() + 1,
+              day: dateInTz.getDate(),
+              hour: dateInTz.getHours(),
+              minute: dateInTz.getMinutes(),
+              second: dateInTz.getSeconds(),
+              millisecond: dateInTz.getMilliseconds(),
+              dayOfWeek: dateInTz.toLocaleDateString("en-US", { weekday: "long" }),
+              monthName: dateInTz.toLocaleDateString("en-US", { month: "long" })
+            },
+            timestamp: now.getTime(),
+            unixTimestamp: Math.floor(now.getTime() / 1e3),
+            timezone: input.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone,
+            offset
+          };
+        default:
+          formattedDate = now.toISOString();
+      }
+      const response = {
+        success: true,
+        datetime: formattedDate,
+        timestamp: now.getTime(),
+        unixTimestamp: Math.floor(now.getTime() / 1e3),
+        timezone: input.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone
+      };
+      if (input.includeOffset && offset) {
+        response.offset = offset;
+      }
+      return response;
+    } catch (error) {
+      return {
+        success: false,
+        error: "Failed to get current date/time",
+        message: error instanceof Error ? error.message : "Unknown error occurred"
+      };
+    }
+  }
+});
+export {
+  getCurrentDateTime
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/getCurrentDateTime.ts"],"sourcesContent":["import { tool } from 'ai';\nimport { z } from 'zod';\n\nconst GetCurrentDateTimeSchema = z.object({\n  timezone: z.string()\n    .optional()\n    .describe('Optional timezone (e.g., \"America/New_York\", \"Europe/London\", \"Asia/Tokyo\", \"UTC\"). Defaults to system timezone.'),\n  format: z.enum(['iso', 'locale', 'unix', 'custom'])\n    .default('iso')\n    .describe('Output format: \"iso\" for ISO 8601, \"locale\" for localized string, \"unix\" for Unix timestamp, \"custom\" for detailed breakdown'),\n  includeOffset: z.boolean()\n    .default(false)\n    .describe('Include timezone offset in the response'),\n});\n\nexport const getCurrentDateTime = tool({\n  description: 'Gets the current date and time in various formats and timezones. Supports ISO 8601, localized strings, Unix timestamps, and detailed date components.',\n  parameters: GetCurrentDateTimeSchema,\n  async execute(input) {\n    // Defensive parameter validation\n    if (input.format && !['iso', 'locale', 'unix', 'custom'].includes(input.format)) {\n      return {\n        success: false,\n        error: 'Invalid format specified',\n        message: 'Format must be one of: iso, locale, unix, custom',\n      };\n    }\n\n    try {\n      const now = new Date();\n      let formattedDate: string;\n      let offset: string | undefined;\n\n      // Calculate timezone offset if requested\n      if (input.includeOffset || input.format === 'custom') {\n        const offsetMinutes = -now.getTimezoneOffset();\n        const offsetHours = Math.floor(Math.abs(offsetMinutes) / 60);\n        const offsetMins = Math.abs(offsetMinutes) % 60;\n        const sign = offsetMinutes >= 0 ? '+' : '-';\n        offset = `${sign}${String(offsetHours).padStart(2, '0')}:${String(offsetMins).padStart(2, '0')}`;\n      }\n\n      switch (input.format) {\n        case 'iso':\n          formattedDate = input.timezone\n            ? new Date(now.toLocaleString('en-US', { timeZone: input.timezone })).toISOString()\n            : now.toISOString();\n          break;\n\n        case 'locale':\n          formattedDate = input.timezone\n            ? now.toLocaleString('en-US', { timeZone: input.timezone })\n            : now.toLocaleString();\n          break;\n\n        case 'unix':\n          formattedDate = Math.floor(now.getTime() / 1000).toString();\n          break;\n\n        case 'custom':\n          const dateInTz = input.timezone\n            ? new Date(now.toLocaleString('en-US', { timeZone: input.timezone }))\n            : now;\n\n          return {\n            success: true,\n            datetime: dateInTz.toISOString(),\n            components: {\n              year: dateInTz.getFullYear(),\n              month: dateInTz.getMonth() + 1,\n              day: dateInTz.getDate(),\n              hour: dateInTz.getHours(),\n              minute: dateInTz.getMinutes(),\n              second: dateInTz.getSeconds(),\n              millisecond: dateInTz.getMilliseconds(),\n              dayOfWeek: dateInTz.toLocaleDateString('en-US', { weekday: 'long' }),\n              monthName: dateInTz.toLocaleDateString('en-US', { month: 'long' }),\n            },\n            timestamp: now.getTime(),\n            unixTimestamp: Math.floor(now.getTime() / 1000),\n            timezone: input.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone,\n            offset: offset,\n          };\n\n        default:\n          formattedDate = now.toISOString();\n      }\n\n      const response: any = {\n        success: true,\n        datetime: formattedDate,\n        timestamp: now.getTime(),\n        unixTimestamp: Math.floor(now.getTime() / 1000),\n        timezone: input.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone,\n      };\n\n      if (input.includeOffset && offset) {\n        response.offset = offset;\n      }\n\n      return response;\n    } catch (error) {\n      return {\n        success: false,\n        error: 'Failed to get current date/time',\n        message: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "tpmjs-datetime-tools",
+  "version": "1.0.0",
+  "description": "TPMJS tools for getting current date and time in various formats and timezones",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "tpmjs",
+    "datetime",
+    "time",
+    "date",
+    "utilities",
+    "timezone"
+  ],
+  "tpmjs": {
+    "category": "utilities",
+    "tools": [
+      {
+        "name": "getCurrentDateTime",
+        "description": "Gets the current date and time in various formats and timezones"
+      }
+    ]
+  },
+  "author": "lmwat",
+  "license": "MIT",
+  "dependencies": {
+    "ai": "^4.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}