@sondos_rajeh/piece-relative-time-formatter 0.0.9 → 0.1.0

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@sondos_rajeh/piece-relative-time-formatter",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "type": "commonjs",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
   "dependencies": {
     "@sinclair/typebox": "0.34.11",
     "deepmerge-ts": "7.1.0",
@@ -17,15 +17,9 @@
     "access": "public"
   },
   "files": [
-    "dist"
+    "src"
   ],
   "description": "time formater package",
-  "scripts": {
-    "test": "npm test"
-  },
-  "keywords": [
-    "relative-time-formatter"
-  ],
   "author": "sondos",
   "license": "MIT",
   "overrides": {
@@ -42,4 +36,4 @@
     "@opentelemetry/sdk-trace-base": "latest",
     "@opentelemetry/api": "latest"
   }
-}
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export declare const relativeTimeFormatter: import("@activepieces/pieces-framework").Piece<import("@activepieces/pieces-framework").PieceAuthProperty>;

package/src/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relativeTimeFormatter = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const format_relative_time_action_1 = require("./lib/actions/format-relative-time-action");
+exports.relativeTimeFormatter = (0, pieces_framework_1.createPiece)({
+    displayName: "Relative-time-formatter",
+    auth: pieces_framework_1.PieceAuth.None(),
+    minimumSupportedRelease: '0.36.1',
+    logoUrl: "https://cdn.activepieces.com/pieces/relative-time-formatter.png",
+    authors: [],
+    actions: [format_relative_time_action_1.formatRelativeTimeAction],
+    triggers: [],
+});
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/pieces/community/relative-time-formatter/src/index.ts"],"names":[],"mappings":";;;AACI,qEAAwE;AACxE,2FAAqF;AAExE,QAAA,qBAAqB,GAAG,IAAA,8BAAW,EAAC;IAC/C,WAAW,EAAE,yBAAyB;IACtC,IAAI,EAAE,4BAAS,CAAC,IAAI,EAAE;IACtB,uBAAuB,EAAE,QAAQ;IACjC,OAAO,EAAE,iEAAiE;IAC1E,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,CAAC,sDAAwB,CAAC;IACnC,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+export declare const formatRelativeTimeAction: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").PieceAuthProperty, {
+    dateToFormat: import("@activepieces/pieces-framework").DateTimeProperty<true>;
+    referenceDate: import("@activepieces/pieces-framework").DateTimeProperty<false>;
+    locale: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    numericStyle: import("@activepieces/pieces-framework").StaticDropdownProperty<string, false>;
+    unitStyle: import("@activepieces/pieces-framework").StaticDropdownProperty<string, false>;
+}>;

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

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatRelativeTimeAction = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@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, referenceDate) {
+    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 };
+        }
+    }
+    return { value: Math.trunc(diffMs / MS_PER_YEAR), unit: 'year' };
+}
+// --- ACTIVEPIECES ACTION DEFINITION ---
+exports.formatRelativeTimeAction = (0, pieces_framework_1.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: pieces_framework_1.Property.DateTime({
+            displayName: 'Target Date/Time',
+            description: 'The date/time to format (e.g., an ISO string from a previous step).',
+            required: true,
+        }),
+        referenceDate: pieces_framework_1.Property.DateTime({
+            displayName: 'Reference Date (Now)',
+            description: 'The date/time to calculate the difference from (defaults to current time if empty).',
+            required: false,
+        }),
+        locale: pieces_framework_1.Property.ShortText({
+            displayName: 'Locale',
+            description: 'The language code for output (e.g., "en", "fr", "es").',
+            required: false,
+            defaultValue: 'en',
+        }),
+        numericStyle: pieces_framework_1.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: pieces_framework_1.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' },
+                ],
+            },
+        }),
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { dateToFormat, referenceDate, locale, numericStyle, unitStyle } = context.props;
+            // Ensure properties are treated as strings as they come from the context props
+            const targetDateString = dateToFormat;
+            const referenceDateString = referenceDate;
+            // 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,
+            };
+        });
+    },
+});
+//# sourceMappingURL=format-relative-time-action.js.map

package/src/lib/actions/format-relative-time-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-relative-time-action.js","sourceRoot":"","sources":["../../../../../../../../packages/pieces/community/relative-time-formatter/src/lib/actions/format-relative-time-action.ts"],"names":[],"mappings":"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"}