@sondos_rajeh/piece-relative-time-formatter 0.0.1

package/.eslintrc.json

@@ -0,0 +1,33 @@
+{
+  "extends": [
+    "../../../../.eslintrc.base.json"
+  ],
+  "ignorePatterns": [
+    "!**/*"
+  ],
+  "overrides": [
+    {
+      "files": [
+        "*.ts",
+        "*.tsx",
+        "*.js",
+        "*.jsx"
+      ],
+      "rules": {}
+    },
+    {
+      "files": [
+        "*.ts",
+        "*.tsx"
+      ],
+      "rules": {}
+    },
+    {
+      "files": [
+        "*.js",
+        "*.jsx"
+      ],
+      "rules": {}
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,7 @@
+# pieces-relative-time-formatter
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build pieces-relative-time-formatter` to build the library.

package/dist/packages/pieces/community/framework/packages/pieces/community/framework/README.md

@@ -0,0 +1,11 @@
+# pieces-framework
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build pieces-framework` to build the library.
+
+## Running unit tests
+
+Run `nx test pieces-framework` to execute the unit tests via [Jest](https://jestjs.io).

package/dist/packages/pieces/community/relative-time-formatter/packages/pieces/community/relative-time-formatter/README.md

@@ -0,0 +1,7 @@
+# pieces-relative-time-formatter
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build pieces-relative-time-formatter` to build the library.

package/dist/packages/shared/packages/shared/README.md

@@ -0,0 +1,7 @@
+# shared
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build shared` to build the library.

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@sondos_rajeh/piece-relative-time-formatter",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+
+  "publishConfig": {
+    "access": "public" 
+  }
+}

package/project.json

@@ -0,0 +1,51 @@
+{
+  "name": "@sondos_rajeh/piece-relative-time-formatter",
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/pieces/community/relative-time-formatter/src",
+  "projectType": "library",
+  "release": {
+    "version": {
+      "manifestRootsToUpdate": [
+        "dist/{projectRoot}"
+      ],
+      "currentVersionResolver": "git-tag",
+      "fallbackCurrentVersionResolver": "disk"
+    }
+  },
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": [
+        "{options.outputPath}"
+      ],
+      "options": {
+        "outputPath": "dist/packages/pieces/community/relative-time-formatter",
+        "tsConfig": "packages/pieces/community/relative-time-formatter/tsconfig.lib.json",
+        "packageJson": "packages/pieces/community/relative-time-formatter/package.json",
+        "main": "packages/pieces/community/relative-time-formatter/src/index.ts",
+        "assets": [
+          "packages/pieces/community/relative-time-formatter/*.md",
+          {
+            "input": "packages/pieces/community/relative-time-formatter/src/i18n",
+            "output": "./src/i18n",
+            "glob": "**/!(i18n.json)"
+          }
+        ],
+        "buildableProjectDepsInPackageJsonType": "dependencies",
+        "updateBuildableProjectDepsInPackageJson": true
+      }
+    },
+    "nx-release-publish": {
+      "options": {
+        "packageRoot": "dist/{projectRoot}"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": [
+        "{options.outputFile}"
+      ]
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+
+    import { createPiece, PieceAuth } from "@activepieces/pieces-framework";
+    import { formatRelativeTimeAction } from "./lib/actions/format-relative-time-action";
+
+    export const relativeTimeFormatter = createPiece({
+      displayName: "Relative-time-formatter",
+      auth: PieceAuth.None(),
+      minimumSupportedRelease: '0.36.1',
+      logoUrl: "https://cdn.activepieces.com/pieces/relative-time-formatter.png",
+      authors: [],
+      actions: [formatRelativeTimeAction],
+      triggers: [],
+    });
+    

package/src/lib/actions/format-relative-time-action.ts

@@ -0,0 +1,132 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+
+/**
+ * --- CORE UTILITY LOGIC (Dependency-Free Time Calculation) ---
+ */
+
+const MS_PER_SECOND = 1000;
+const MS_PER_MINUTE = 60 * MS_PER_SECOND;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+const MS_PER_WEEK = 7 * MS_PER_DAY;
+const MS_PER_MONTH = 30 * MS_PER_DAY; // Approximation
+const MS_PER_YEAR = 365 * MS_PER_DAY; // Approximation
+
+// Defines units and their thresholds (in ms) to switch to the next largest unit.
+const TIME_THRESHOLDS = [
+    { unit: 'second', ms: MS_PER_SECOND, threshold: MS_PER_MINUTE * 0.75 }, 
+    { unit: 'minute', ms: MS_PER_MINUTE, threshold: MS_PER_HOUR * 0.9 },     
+    { unit: 'hour', ms: MS_PER_HOUR, threshold: MS_PER_DAY * 0.92 },       
+    { unit: 'day', ms: MS_PER_DAY, threshold: MS_PER_WEEK * 0.9 },          
+    { unit: 'week', ms: MS_PER_WEEK, threshold: MS_PER_MONTH * 0.8 },      
+    { unit: 'month', ms: MS_PER_MONTH, threshold: MS_PER_YEAR * 0.75 },    
+    { unit: 'year', ms: MS_PER_YEAR, threshold: Infinity }
+];
+
+function calculateTimeDifference(targetDate: Date | number, referenceDate: Date | number): { value: number, unit: Intl.RelativeTimeFormatUnit } {
+    const targetTime = targetDate instanceof Date ? targetDate.getTime() : targetDate;
+    const refTime = referenceDate instanceof Date ? referenceDate.getTime() : referenceDate;
+
+    const diffMs = targetTime - refTime;
+    const absDiffMs = Math.abs(diffMs);
+    
+    for (const { unit, ms, threshold } of TIME_THRESHOLDS) {
+        if (absDiffMs < threshold) {
+            const value = Math.trunc(diffMs / ms); 
+            
+            if (unit === 'second' && Math.abs(value) < 1) {
+                return { value: 0, unit: 'second' };
+            }
+            
+            return { value: value, unit: unit as Intl.RelativeTimeFormatUnit };
+        }
+    }
+    
+    return { value: Math.trunc(diffMs / MS_PER_YEAR), unit: 'year' };
+}
+
+// --- ACTIVEPIECES ACTION DEFINITION ---
+
+export const formatRelativeTimeAction = createAction({
+    name: 'format_relative_time',
+    displayName: 'Format Relative Time (No DayJS)',
+    description: 'Converts a date into a localized "time ago" string using native JavaScript Intl APIs.',
+    
+    props: {
+        dateToFormat: Property.DateTime({
+            displayName: 'Target Date/Time',
+            description: 'The date/time to format (e.g., an ISO string from a previous step).',
+            required: true,
+        }),
+        
+        referenceDate: Property.DateTime({
+            displayName: 'Reference Date (Now)',
+            description: 'The date/time to calculate the difference from (defaults to current time if empty).',
+            required: false,
+        }),
+
+        locale: Property.ShortText({
+            displayName: 'Locale',
+            description: 'The language code for output (e.g., "en", "fr", "es").',
+            required: false,
+            defaultValue: 'en',
+        }),
+
+        numericStyle: Property.StaticDropdown({
+            displayName: 'Numeric Style',
+            description: 'Controls if words like "yesterday" or "tomorrow" are used.',
+            required: false,
+            defaultValue: 'auto',
+            options: {
+                options: [
+                    { label: 'Auto (e.g., "yesterday")', value: 'auto' },
+                    { label: 'Always (e.g., "1 day ago")', value: 'always' },
+                ],
+            },
+        }),
+
+        unitStyle: Property.StaticDropdown({
+            displayName: 'Unit Style',
+            description: 'Controls the length of the time unit.',
+            required: false,
+            defaultValue: 'long',
+            options: {
+                options: [
+                    { label: 'Long (e.g., "minutes")', value: 'long' },
+                    { label: 'Short (e.g., "min.")', value: 'short' },
+                    { label: 'Narrow (e.g., "m")', value: 'narrow' },
+                ],
+            },
+        }),
+    },
+
+    async run(context: any) { // FIX: Use 'context.props' and cast context to 'any'
+        const { dateToFormat, referenceDate, locale, numericStyle, unitStyle } = context.props;
+        
+        // Ensure properties are treated as strings as they come from the context props
+        const targetDateString = dateToFormat as string;
+        const referenceDateString = referenceDate as string | undefined;
+
+        // Convert string inputs to Date objects
+        const targetDate = new Date(targetDateString);
+        const refDate = referenceDateString ? new Date(referenceDateString) : new Date();
+
+        // 1. Calculate the signed value and unit
+        const { value, unit } = calculateTimeDifference(targetDate, refDate);
+
+        // 2. Use the native Intl API for final formatting
+        const formatter = new Intl.RelativeTimeFormat(locale || 'en', {
+            numeric: numericStyle || 'auto',
+            style: unitStyle || 'long',
+        });
+
+        const relativeTimeString = formatter.format(value, unit);
+
+        // 3. Return the result object for use in downstream steps
+        return {
+            relative_time: relativeTimeString,
+            value: value,
+            unit: unit,
+        };
+    },
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

package/tsconfig.lib.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}