@messagevisor/core 0.0.1 → 0.1.0

package/lib/evaluate/cli.js

@@ -0,0 +1,179 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluatePlugin = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+var sdk_1 = require("@messagevisor/sdk");
+var builder_1 = require("../builder");
+var error_1 = require("../error");
+var sets_1 = require("../sets");
+var index_1 = require("./index");
+function readAllSegments(datasource) {
+    return __awaiter(this, void 0, void 0, function () {
+        var segmentKeys, entries;
+        var _this = this;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, datasource.listSegments()];
+                case 1:
+                    segmentKeys = _a.sent();
+                    return [4 /*yield*/, Promise.all(segmentKeys.map(function (segmentKey) { return __awaiter(_this, void 0, void 0, function () {
+                            var segment;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, datasource.readSegment(segmentKey)];
+                                    case 1:
+                                        segment = (_a.sent());
+                                        return [2 /*return*/, [segmentKey, segment]];
+                                }
+                            });
+                        }); }))];
+                case 2:
+                    entries = _a.sent();
+                    return [2 /*return*/, Object.fromEntries(entries)];
+            }
+        });
+    });
+}
+function parseJsonOption(optionName, value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new error_1.MessagevisorCLIError("Invalid ".concat(optionName, ": expected valid JSON"));
+    }
+}
+exports.evaluatePlugin = {
+    command: "evaluate",
+    handler: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+        var execution, target, context, values, segments, matched, result, locale, revision, datafile, messagevisor, translation, result, translation, result, error_2;
+        var projectConfig = _b.projectConfig, datasource = _b.datasource, parsed = _b.parsed;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    _c.trys.push([0, 7, , 8]);
+                    if (projectConfig.sets && !parsed.set) {
+                        throw new error_1.MessagevisorCLIError("Pass --set=<set>");
+                    }
+                    if (!projectConfig.sets) return [3 /*break*/, 2];
+                    return [4 /*yield*/, (0, sets_1.getProjectSetExecutions)(projectConfig, datasource, parsed.set)];
+                case 1:
+                    execution = (_c.sent())[0];
+                    projectConfig = execution.projectConfig;
+                    datasource = execution.datasource;
+                    _c.label = 2;
+                case 2:
+                    target = parsed.target;
+                    context = parsed.context ? parseJsonOption("--context", parsed.context) : {};
+                    values = parsed.values ? parseJsonOption("--values", parsed.values) : undefined;
+                    if (parsed.message && parsed.rawMessage) {
+                        throw new error_1.MessagevisorCLIError("Pass either --message=<key> or --rawMessage=<message>, not both");
+                    }
+                    if (!parsed.segment) return [3 /*break*/, 4];
+                    return [4 /*yield*/, readAllSegments(datasource)];
+                case 3:
+                    segments = _c.sent();
+                    matched = (0, index_1.evaluateSegment)(parsed.segment, {
+                        segments: segments,
+                        context: context,
+                    });
+                    result = { segment: parsed.segment, matched: matched };
+                    console.log(parsed.json
+                        ? JSON.stringify(result, null, parsed.pretty ? 2 : 0)
+                        : "Segment \"".concat(parsed.segment, "\" matched: ").concat(matched));
+                    return [2 /*return*/];
+                case 4:
+                    if (!parsed.locale) {
+                        throw new error_1.MessagevisorCLIError("Pass --locale=<locale>");
+                    }
+                    locale = parsed.locale;
+                    return [4 /*yield*/, datasource.readRevision()];
+                case 5:
+                    revision = _c.sent();
+                    return [4 /*yield*/, (0, builder_1.buildDatafile)(projectConfig, datasource, target, locale, revision)];
+                case 6:
+                    datafile = _c.sent();
+                    messagevisor = (0, sdk_1.createMessagevisor)({
+                        datafile: datafile,
+                        context: context,
+                        modules: projectConfig.modules || [],
+                        logLevel: "warn",
+                    });
+                    if (parsed.message) {
+                        translation = messagevisor.translate(parsed.message, values, { context: context });
+                        result = { message: parsed.message, translation: translation };
+                        console.log(parsed.json ? JSON.stringify(result, null, parsed.pretty ? 2 : 0) : translation);
+                        return [2 /*return*/];
+                    }
+                    if (parsed.rawMessage) {
+                        translation = messagevisor.formatMessage(parsed.rawMessage, values);
+                        result = { rawMessage: parsed.rawMessage, translation: translation };
+                        console.log(parsed.json ? JSON.stringify(result, null, parsed.pretty ? 2 : 0) : translation);
+                        return [2 /*return*/];
+                    }
+                    throw new error_1.MessagevisorCLIError("Pass --message=<key>, --rawMessage=<message>, or --segment=<key>");
+                case 7:
+                    error_2 = _c.sent();
+                    if ((0, error_1.printMessagevisorCLIError)(error_2)) {
+                        return [2 /*return*/, false];
+                    }
+                    throw error_2;
+                case 8: return [2 /*return*/];
+            }
+        });
+    }); },
+    examples: [
+        {
+            command: "evaluate --message=auth.signin --locale=en-US",
+            description: "evaluate a message translation",
+        },
+        {
+            command: 'evaluate --message=dashboard.welcome --locale=en-US --values=\'{"name":"Ada"}\'',
+            description: "evaluate a message translation with JSON values",
+        },
+        {
+            command: 'evaluate --rawMessage="Hello {name}" --locale=en-US --values=\'{"name":"Ada"}\'',
+            description: "evaluate a raw message string with JSON values",
+        },
+        {
+            command: 'evaluate --segment=platform-web --context=\'{"platform":"web"}\'',
+            description: "evaluate a segment",
+        },
+    ],
+};
+//# sourceMappingURL=cli.js.map

package/lib/evaluate/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/evaluate/cli.ts"],"names":[],"mappings":"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"}

package/lib/evaluate/index.d.ts

@@ -0,0 +1,10 @@
+import type { Condition, Context, GroupSegment, Segment } from "@messagevisor/types";
+export interface EvaluateConditionOptions {
+    context?: Context;
+    segments?: Record<string, Segment>;
+    resolveFlag?: (featureKey: string, context?: Context) => boolean;
+    resolveVariation?: (experimentKey: string, context?: Context) => string;
+}
+export declare function evaluateCondition(condition: Condition | Condition[] | "*" | undefined, options?: EvaluateConditionOptions): boolean;
+export declare function evaluateGroupSegment(groupSegment: GroupSegment | GroupSegment[] | "*" | undefined, options?: EvaluateConditionOptions): boolean;
+export declare function evaluateSegment(segmentKey: string, options?: EvaluateConditionOptions): boolean;

package/lib/evaluate/index.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateCondition = evaluateCondition;
+exports.evaluateGroupSegment = evaluateGroupSegment;
+exports.evaluateSegment = evaluateSegment;
+function getContextValue(context, attribute) {
+    if (!context) {
+        return undefined;
+    }
+    return attribute
+        .split(".")
+        .reduce(function (value, part) { return (value ? value[part] : undefined); }, context);
+}
+function compareDate(value, expected, operator) {
+    var valueTime = new Date(value).getTime();
+    var expectedTime = new Date(expected).getTime();
+    if (Number.isNaN(valueTime) || Number.isNaN(expectedTime)) {
+        return false;
+    }
+    return operator === "before" ? valueTime < expectedTime : valueTime > expectedTime;
+}
+function evaluateCondition(condition, options) {
+    if (options === void 0) { options = {}; }
+    if (!condition || condition === "*") {
+        return true;
+    }
+    if (Array.isArray(condition)) {
+        return condition.every(function (item) { return evaluateCondition(item, options); });
+    }
+    if (typeof condition === "string") {
+        return evaluateSegment(condition, options);
+    }
+    if ("and" in condition) {
+        return condition.and.every(function (item) { return evaluateCondition(item, options); });
+    }
+    if ("or" in condition) {
+        return condition.or.some(function (item) { return evaluateCondition(item, options); });
+    }
+    if ("not" in condition) {
+        return !condition.not.every(function (item) { return evaluateCondition(item, options); });
+    }
+    if ("feature" in condition) {
+        var enabled = options.resolveFlag
+            ? options.resolveFlag(condition.feature, options.context)
+            : false;
+        return condition.operator === "isEnabled"
+            ? enabled
+            : condition.operator === "isDisabled"
+                ? !enabled
+                : false;
+    }
+    if ("experiment" in condition) {
+        var variation = options.resolveVariation
+            ? options.resolveVariation(condition.experiment, options.context)
+            : undefined;
+        return condition.operator === "hasVariation" ? variation === condition.value : false;
+    }
+    var value = getContextValue(options.context, condition.attribute);
+    var expected = condition.value;
+    switch (condition.operator) {
+        case "equals":
+            return value === expected;
+        case "notEquals":
+            return value !== expected;
+        case "exists":
+            return value !== undefined && value !== null;
+        case "notExists":
+            return value === undefined || value === null;
+        case "greaterThan":
+            return Number(value) > Number(expected);
+        case "greaterThanOrEquals":
+            return Number(value) >= Number(expected);
+        case "lessThan":
+            return Number(value) < Number(expected);
+        case "lessThanOrEquals":
+            return Number(value) <= Number(expected);
+        case "contains":
+            return String(value).includes(String(expected));
+        case "notContains":
+            return !String(value).includes(String(expected));
+        case "startsWith":
+            return String(value).startsWith(String(expected));
+        case "endsWith":
+            return String(value).endsWith(String(expected));
+        case "before":
+            return compareDate(value, expected, "before");
+        case "after":
+            return compareDate(value, expected, "after");
+        case "includes":
+            return Array.isArray(value) && value.includes(expected);
+        case "notIncludes":
+            return !Array.isArray(value) || !value.includes(expected);
+        case "in":
+            return Array.isArray(expected) && expected.includes(value);
+        case "notIn":
+            return !Array.isArray(expected) || !expected.includes(value);
+        default:
+            return false;
+    }
+}
+function evaluateGroupSegment(groupSegment, options) {
+    if (options === void 0) { options = {}; }
+    if (!groupSegment || groupSegment === "*") {
+        return true;
+    }
+    if (Array.isArray(groupSegment)) {
+        return groupSegment.every(function (item) { return evaluateGroupSegment(item, options); });
+    }
+    if (typeof groupSegment === "string") {
+        return evaluateSegment(groupSegment, options);
+    }
+    if ("and" in groupSegment) {
+        return groupSegment.and.every(function (item) { return evaluateGroupSegment(item, options); });
+    }
+    if ("or" in groupSegment) {
+        return groupSegment.or.some(function (item) { return evaluateGroupSegment(item, options); });
+    }
+    if ("not" in groupSegment) {
+        return !groupSegment.not.every(function (item) { return evaluateGroupSegment(item, options); });
+    }
+    return false;
+}
+function evaluateSegment(segmentKey, options) {
+    if (options === void 0) { options = {}; }
+    var segment = options.segments ? options.segments[segmentKey] : undefined;
+    if (!segment || segment.archived) {
+        return false;
+    }
+    return evaluateCondition(segment.conditions, options);
+}
+//# sourceMappingURL=index.js.map

package/lib/evaluate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evaluate/index.ts"],"names":[],"mappings":"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"}

package/lib/examples/coerceExampleIsoDates.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Coerce ISO 8601-like strings in example `values` to `Date` for CLI evaluation (ICU date/time formatters).
+ *
+ * Accepted shapes (non-exhaustive; `Date.parse` must still succeed):
+ * - Calendar: `YYYY-MM-DD`
+ * - Datetime: `T` or space between date and time; `t` / `z` case-insensitive where applicable
+ * - Time: `HH:MM` or `HH:MM:SS`, optional fractional seconds (`.` or `,`), optional `Z` or numeric offset (`±HH`, `±HH:MM`, `±HHMM`)
+ */
+/**
+ * Returns a shallow copy with coerced values (nested plain objects and arrays are walked).
+ */
+export declare function coerceExampleValuesIsoDates(values: Record<string, unknown> | undefined): Record<string, unknown> | undefined;

package/lib/examples/coerceExampleIsoDates.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Coerce ISO 8601-like strings in example `values` to `Date` for CLI evaluation (ICU date/time formatters).
+ *
+ * Accepted shapes (non-exhaustive; `Date.parse` must still succeed):
+ * - Calendar: `YYYY-MM-DD`
+ * - Datetime: `T` or space between date and time; `t` / `z` case-insensitive where applicable
+ * - Time: `HH:MM` or `HH:MM:SS`, optional fractional seconds (`.` or `,`), optional `Z` or numeric offset (`±HH`, `±HH:MM`, `±HHMM`)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceExampleValuesIsoDates = coerceExampleValuesIsoDates;
+var ISO_8601_LIKE = /^\d{4}-\d{2}-\d{2}(?:[Tt ]\d{2}:\d{2}(?::\d{2})?(?:[.,]\d{1,9})?(?:[Zz]|[+-]\d{2}(?::?\d{2})?)?)?$/;
+function isIso8601TimestampString(value) {
+    var trimmed = value.trim();
+    if (!ISO_8601_LIKE.test(trimmed)) {
+        return false;
+    }
+    return !Number.isNaN(Date.parse(coerceParseableIsoLike(trimmed)));
+}
+/**
+ * Normalize a few ISO variants so `Date.parse` behaves consistently (comma decimals, lowercase z).
+ */
+function normalizeIsoLikeForParse(value) {
+    var s = value.trim();
+    if (s.includes(",") && /\d{2}:\d{2}(?::\d{2})?,/.test(s)) {
+        s = s.replace(",", ".");
+    }
+    return s;
+}
+/**
+ * If `Date.parse` rejects a valid-looking ISO string, apply small normalizations (hour-only offset).
+ */
+function coerceParseableIsoLike(trimmed) {
+    var commaNormalized = normalizeIsoLikeForParse(trimmed);
+    if (!Number.isNaN(Date.parse(commaNormalized))) {
+        return commaNormalized;
+    }
+    var s = commaNormalized;
+    if (/[+-]\d{2}:\d{2}$/.test(s) || /[+-]\d{4}$/.test(s)) {
+        return s;
+    }
+    var hourOnlyOffset = s.match(/^(.+)([+-]\d{2})$/);
+    if (hourOnlyOffset) {
+        var withMinutes = "".concat(hourOnlyOffset[1]).concat(hourOnlyOffset[2], ":00");
+        if (!Number.isNaN(Date.parse(withMinutes))) {
+            return withMinutes;
+        }
+    }
+    return s;
+}
+function isPlainObject(value) {
+    return (typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date));
+}
+function coerceLeaf(value) {
+    if (typeof value === "string" && isIso8601TimestampString(value)) {
+        var trimmed = value.trim();
+        return new Date(Date.parse(coerceParseableIsoLike(trimmed)));
+    }
+    if (isPlainObject(value)) {
+        return coerceExampleValuesIsoDates(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map(function (entry) { return coerceLeaf(entry); });
+    }
+    return value;
+}
+/**
+ * Returns a shallow copy with coerced values (nested plain objects and arrays are walked).
+ */
+function coerceExampleValuesIsoDates(values) {
+    if (typeof values === "undefined") {
+        return undefined;
+    }
+    var result = {};
+    for (var _i = 0, _a = Object.keys(values); _i < _a.length; _i++) {
+        var key = _a[_i];
+        result[key] = coerceLeaf(values[key]);
+    }
+    return result;
+}
+//# sourceMappingURL=coerceExampleIsoDates.js.map

package/lib/examples/coerceExampleIsoDates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerceExampleIsoDates.js","sourceRoot":"","sources":["../../src/examples/coerceExampleIsoDates.ts"],"names":[],"mappings":"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"}

package/lib/examples/index.d.ts

@@ -0,0 +1,63 @@
+import type { DatafileContent, FormatPresets } from "@messagevisor/types";
+import type { Plugin } from "../cli";
+import type { ProjectConfig } from "../config";
+import type { Datasource } from "../datasource";
+export interface ResolvedLocaleExample {
+    set?: string;
+    locale: string;
+    sourceLocale: string;
+    exampleIndex: number;
+    matrixIndex?: number;
+    description?: string;
+    rawMessage?: string;
+    message?: string;
+    values?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    formats?: FormatPresets;
+    currency?: string;
+    timeZone?: string;
+    evaluatedTranslation: unknown;
+    evaluationInput?: ExampleEvaluationInput;
+}
+export interface ResolvedMessageExample {
+    set?: string;
+    message: string;
+    locale: string;
+    exampleIndex: number;
+    matrixIndex?: number;
+    description?: string;
+    values?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    formats?: FormatPresets;
+    currency?: string;
+    timeZone?: string;
+    evaluatedTranslation: unknown;
+    evaluationInput?: ExampleEvaluationInput;
+}
+export interface ExampleEvaluationInput {
+    datafile?: DatafileContent;
+    defaultFormats?: Record<string, FormatPresets>;
+    formats?: FormatPresets;
+    context?: Record<string, unknown>;
+    values?: Record<string, unknown>;
+    currency?: string;
+    timeZone?: string;
+}
+export interface ExamplesOutput {
+    locales: ResolvedLocaleExample[];
+    messages: ResolvedMessageExample[];
+}
+export interface ResolveExamplesOptions {
+    set?: string;
+    locale?: string;
+    message?: string;
+    exampleIndex?: number | string;
+    matrixIndex?: number | string;
+    descriptionPattern?: string | RegExp;
+    translationPattern?: string | RegExp;
+    onlyMessages?: boolean;
+    onlyLocales?: boolean;
+    includeEvaluationInput?: boolean;
+}
+export declare function resolveExamples(projectConfig: ProjectConfig, datasource: Datasource, options?: ResolveExamplesOptions): Promise<ExamplesOutput>;
+export declare const examplesPlugin: Plugin;