@leancodepl/api-date-datefns 8.4.0 → 8.5.1

package/README.md

@@ -0,0 +1,130 @@
+# @leancodepl/api-date-datefns
+
+Date conversion utilities using date-fns for API date types.
+
+## Installation
+
+```bash
+npm install @leancodepl/api-date-datefns
+# or
+yarn add @leancodepl/api-date-datefns
+```
+
+## API
+
+### `fromApiDate(date)`
+
+Converts ApiDateOnly to JavaScript Date using date-fns.
+
+**Parameters:**
+
+- `date: ApiDateOnly` - The API date string to convert
+
+**Returns:** JavaScript Date object
+
+### `toApiDate(date)`
+
+Converts JavaScript Date to ApiDateOnly using date-fns.
+
+**Parameters:**
+
+- `date: Date` - The JavaScript Date to convert
+
+**Returns:** ApiDateOnly string
+
+### `fromApiTime(time)`
+
+Converts ApiTimeOnly to JavaScript Date using date-fns.
+
+**Parameters:**
+
+- `time: ApiTimeOnly` - The API time string to convert
+
+**Returns:** JavaScript Date object
+
+### `toApiTime(time)`
+
+Converts JavaScript Date to ApiTimeOnly using date-fns.
+
+**Parameters:**
+
+- `time: Date` - The JavaScript Date to convert
+
+**Returns:** ApiTimeOnly string
+
+### `fromApiDateTimeOffset(dateTimeOffset)`
+
+Converts ApiDateTimeOffset to JavaScript Date using date-fns.
+
+**Parameters:**
+
+- `dateTimeOffset: ApiDateTimeOffset` - The API datetime with offset string to convert
+
+**Returns:** JavaScript Date object
+
+### `toApiDateTimeOffset(dateTimeOffset)`
+
+Converts JavaScript Date to ApiDateTimeOffset using date-fns.
+
+**Parameters:**
+
+- `dateTimeOffset: Date` - The JavaScript Date to convert
+
+**Returns:** ApiDateTimeOffset string
+
+### `fromApiTimeSpan(timeSpan)`
+
+Converts ApiTimeSpan to milliseconds using date-fns.
+
+**Parameters:**
+
+- `timeSpan: ApiTimeSpan` - The API timespan string to convert
+
+**Returns:** Duration in milliseconds
+
+### `toApiTimeSpan(differenceInMilliseconds)`
+
+Converts milliseconds to ApiTimeSpan using date-fns.
+
+**Parameters:**
+
+- `differenceInMilliseconds: number` - The duration in milliseconds to convert
+
+**Returns:** ApiTimeSpan string
+
+## Usage Examples
+
+### Date Conversion
+
+```typescript
+import { fromApiDate, toApiDate } from "@leancodepl/api-date-datefns"
+
+const apiDate = "2023-12-25"
+const jsDate = fromApiDate(apiDate)
+console.log(jsDate) // Date object
+
+const convertedBack = toApiDate(jsDate)
+console.log(convertedBack) // '2023-12-25'
+```
+
+### Time Conversion
+
+```typescript
+import { fromApiTime, toApiTime } from "@leancodepl/api-date-datefns"
+
+const apiTime = "14:30:00"
+const jsDate = fromApiTime(apiTime)
+const convertedBack = toApiTime(jsDate)
+console.log(convertedBack) // '14:30:00'
+```
+
+### DateTime with Offset
+
+```typescript
+import { fromApiDateTimeOffset, toApiDateTimeOffset } from "@leancodepl/api-date-datefns"
+
+const apiDateTime = "2023-12-25T14:30:00+01:00"
+const jsDate = fromApiDateTimeOffset(apiDateTime)
+const convertedBack = toApiDateTimeOffset(jsDate)
+console.log(convertedBack) // '2023-12-25T14:30:00+01:00'
+```

package/package.json

@@ -1,25 +1,56 @@
 {
   "name": "@leancodepl/api-date-datefns",
-  "version": "8.4.0",
+  "version": "8.5.1",
   "license": "Apache-2.0",
   "dependencies": {
-    "@leancodepl/api-date": "8.4.0",
-    "@leancodepl/api-date-utils": "8.4.0",
+    "@leancodepl/api-date": "8.5.1",
+    "@leancodepl/api-date-utils": "8.5.1",
     "date-fns": ">=2.0.0"
   },
   "devDependencies": {
     "timezone-mock": "1.3.6"
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leancodepl/js_corelibrary.git",
+    "directory": "packages/cqrs-clients/custom-types/date/api-date-datefns"
+  },
+  "homepage": "https://github.com/leancodepl/js_corelibrary",
+  "bugs": {
+    "url": "https://github.com/leancodepl/js_corelibrary/issues"
+  },
+  "description": "Date-fns integration for API date type conversion",
+  "keywords": [
+    "date",
+    "date-fns",
+    "api",
+    "conversion",
+    "typescript",
+    "javascript",
+    "leancode"
+  ],
+  "author": {
+    "name": "LeanCode",
+    "url": "https://leancode.co"
+  },
+  "sideEffects": false,
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "module": "./index.esm.js",
-      "types": "./index.esm.d.ts",
+      "types": "./index.d.ts",
       "import": "./index.cjs.mjs",
       "default": "./index.cjs.js"
     }
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
-  "types": "./index.esm.d.ts"
+  "types": "./index.d.ts"
 }

package/src/lib/date/fromApiDate.d.ts

@@ -1,3 +1,19 @@
 import type { ApiDateOnly } from "@leancodepl/api-date";
+/**
+ * Converts ApiDateOnly to JavaScript Date using date-fns.
+ *
+ * Parses API date string format to JavaScript Date object with support
+ * for optional parameters. Uses date-fns parse function internally.
+ *
+ * @param date - The API date string to convert
+ * @returns JavaScript Date object or undefined if date is undefined
+ * @example
+ * ```typescript
+ * import { fromApiDate } from '@leancodepl/api-date-datefns';
+ *
+ * const jsDate = fromApiDate('2023-12-25');
+ * console.log(jsDate); // Date object for December 25, 2023
+ * ```
+ */
 export declare function fromApiDate(date: ApiDateOnly): Date;
 export declare function fromApiDate(date: ApiDateOnly | undefined): Date | undefined;

package/src/lib/date/toApiDate.d.ts

@@ -1,3 +1,19 @@
 import type { ApiDateOnly } from "@leancodepl/api-date";
+/**
+ * Converts JavaScript Date to ApiDateOnly using date-fns.
+ *
+ * Formats JavaScript Date object to API date string format with support
+ * for optional parameters. Uses date-fns format function internally.
+ *
+ * @param date - The JavaScript Date to convert
+ * @returns ApiDateOnly string or undefined if date is undefined
+ * @example
+ * ```typescript
+ * import { toApiDate } from '@leancodepl/api-date-datefns';
+ *
+ * const apiDate = toApiDate(new Date('2023-12-25'));
+ * console.log(apiDate); // '2023-12-25'
+ * ```
+ */
 export declare function toApiDate(date: Date): ApiDateOnly;
 export declare function toApiDate(date: Date | undefined): ApiDateOnly | undefined;

package/index.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/index";