From c0c7b749e399a7c09ebe02d00ec16a51a168de4c Mon Sep 17 00:00:00 2001 From: sam-prais Date: Wed, 31 Jul 2024 08:47:32 +0300 Subject: [PATCH 1/2] DocWorks for js-wixcode-sdk - 8 changes detected, but 15 issue detected changes: Service site-monitoring.LogEntry has changed summary Service site-monitoring.LogEntry has changed description Service site-monitoring.LogEntry property timestamp has changed summary Service site-monitoring.LogEntry property timestamp has changed description Service site-monitoring has changed summary Service site-monitoring has changed description Service wix-window-frontend operation getAppPageData.examples[0] has changed body Service wix-window operation getAppPageData.examples[0] has changed body issues: Message ViewChangeEventOptions has an unknown property type * (ApppointmentFieldEvent.js (8)) Property target is missing a type annotation (GalleryNavigationStartEvent.js (15)) Operation postMessage has an unknown param type * (HtmlComponent.js (97)) Property data has an unknown type * (HtmlComponentMessageEvent.js (17)) Property fileLimit has mismatching types for get (number) and set (string) (UploadButton.js (128, 149)) Operation set has an unknown param type * (window-frontend.js (201)) Operation get has an unknown return type * (window-frontend.js (234)) Operation set has an unknown param type * (window.js (235)) Operation get has an unknown return type * (window.js (269)) Callback ViewChangeOperation is defined two or more times (AppointmentField.js (347), DatePicker.js (472)) Callback ViewChangeOperation has an unknown return type * (AppointmentField.js (347)) Callback ViewChangeEventHandler is defined two or more times (AppointmentField.js (362), DatePicker.js (466)) Callback Validator has an unknown param type * (ValidatableMixin.js (143)) Property value has an unknown type * (ValueMixin.js (62)) Property value has an unknown type * (ValueMixin.js (89)) --- js-wixcode-sdk/site-monitoring.service.json | 41 ++++++++++--------- .../site-monitoring/LogEntry.service.json | 14 ++++--- .../wix-window-frontend.service.json | 10 +++-- .../wix-window-frontend/Lightbox.service.json | 6 +-- js-wixcode-sdk/wix-window.service.json | 10 +++-- 5 files changed, 43 insertions(+), 38 deletions(-) diff --git a/js-wixcode-sdk/site-monitoring.service.json b/js-wixcode-sdk/site-monitoring.service.json index b26007e3ff..c319eb00e2 100644 --- a/js-wixcode-sdk/site-monitoring.service.json +++ b/js-wixcode-sdk/site-monitoring.service.json @@ -1,21 +1,23 @@ { "name": "site-monitoring", "mixes": [], - "labels": [], + "labels": + [ "changed" ], "location": { "lineno": 1, "filename": "siteMonitoring.js" }, "docs": - { "summary": "JSON representation of Wix site events for exposure to external site monitoring tools.", + { "summary": "JSON representation of logs for exposure to external site monitoring tools.", "description": [ "Velo's [site monitoring](https://support.wix.com/en/article/about-site-monitoring)", - " feature lets you view, analyze, and debug Wix site events. You can examine", - " live site events in real time, or connect site events to an external monitoring", - " tool to generate event metrics and perform error log analysis.", + " feature lets you view, analyze, and debug logs. You can examine", + " logs in real time, or connect Wix Logs to an external monitoring", + " tool to generate log metrics and perform error log analysis.", "", "## How It Works", "", - " Velo's site monitoring tool records Wix site events as [log entries](site-monitoring.LogEntry.html).", - " Each log entry is a JSON object representing a single site event.", + " Velo's site monitoring tool records Wix logs as [log entries](site-monitoring.LogEntry.html).", + " Each log entry is a JSON object representing a single log.", + "", "", "The following is an example of a `logEntry`:", "", @@ -50,23 +52,22 @@ "", " For a detailed description of the JSON representation of a log entry, click [here](site-monitoring.LogEntry.html).", "", - "## Viewing Site Events", + "## Viewing logs", "", - " Velo's site monitoring feature lets you investigate your site events in 3 ways:", + " You can investigate your logs in the following ways:", "", - " + **View live site events in real time:** You can quickly scan basic site event", - " information or view the JSON object representing each event. Events are loaded", - " as they occur. [Learn more](https://support.wix.com/en/article/viewing-live-site-events).", - " + **Connect to Google Stackdriver:** You can easily connect your Wix site events", - " to Google's external monitoring tool. Stackdriver performs log analysis and ", - " generates visual depictions of site event data, allowing you to extract meaningful ", - " insights from your site events. [Learn more](https://support.wix.com/en/article/velo-connecting-site-events-to-google-stackdriver).", - " + **Connect to an external monitoring tool:** You can connect your Wix site", - " events to a monitoring tool of your choice to generate metrics and analyze", - " logs. [Learn more](https://support.wix.com/en/article/connecting-site-events-to-a-monitoring-tool).", + " + **View logs in real time:** You can quickly scan basic log information or view the JSON object representing each log. ", + " Logs are loaded as they occur. [Learn more](https://support.wix.com/en/article/viewing-live-site-events).", + " + **Connect to Google Cloud Logs:** You can easily connect your site's logs to Google's external monitoring tool. ", + " Google Cloud Logs performs log analysis and generates visual depictions of log data, ", + " allowing you to extract meaningful insights ", + " from your logs. [Learn more](https://support.wix.com/en/article/velo-connecting-wix-logs-to-google-cloud-logs).", + " + **Connect to an external monitoring tool:** You can connect your Wix Logs to a ", + " monitoring tool of your choice to generate metrics and ", + " analyze logs. [Learn more](https://support.wix.com/en/article/velo-connecting-wix-logs-to-a-monitoring-tool-advanced).", "", "", - "To learn how to trigger events on your site, click [here](https://support.wix.com/en/article/velo-generating-a-site-monitoring-event-to-debug-your-site)." ], + "To learn how to generate logs on your site, click [here](https://dev.wix.com/docs/develop-websites/articles/workspace-tools/testing-monitoring/testing-troubleshooting/testing-and-troubleshooting-your-code#debugging-with-logs)." ], "links": [], "examples": [], "extra": diff --git a/js-wixcode-sdk/site-monitoring/LogEntry.service.json b/js-wixcode-sdk/site-monitoring/LogEntry.service.json index f55b6ba50e..d665319720 100644 --- a/js-wixcode-sdk/site-monitoring/LogEntry.service.json +++ b/js-wixcode-sdk/site-monitoring/LogEntry.service.json @@ -1,16 +1,17 @@ { "name": "LogEntry", "memberOf": "site-monitoring", "mixes": [], - "labels": [], + "labels": + [ "changed" ], "location": { "lineno": 68, "filename": "siteMonitoring.js" }, "docs": - { "summary": "A single record of a Wix site event in JSON format.", + { "summary": "A single record of a log in JSON format.", "description": [ "Note the following terminology:", "", - " + **Log entry:** Single record of a Wix site event.", + " + **Log entry:** Single record of a Wix log.", " + **Log:** Collection of log entries associated with the same site and namespace.", "", " The following is an example of a `LogEntry`:", @@ -330,7 +331,8 @@ "extra": { } }, { "name": "timestamp", - "labels": [], + "labels": + [ "changed" ], "get": true, "set": false, "type": "string", @@ -338,9 +340,9 @@ [ { "lineno": 113, "filename": "siteMonitoring.js" } ], "docs": - { "summary": "Time the site event occurred.", + { "summary": "Time the log occurred.", "description": - [ "Time the event recorded by the log entry occurred. Displayed as UTC time in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format." ], + [ "Time the log occurred. Displayed as UTC time in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format." ], "links": [], "examples": [ { "title": "Log entry timestamp", diff --git a/js-wixcode-sdk/wix-window-frontend.service.json b/js-wixcode-sdk/wix-window-frontend.service.json index 8d1799a990..a8b908e00b 100644 --- a/js-wixcode-sdk/wix-window-frontend.service.json +++ b/js-wixcode-sdk/wix-window-frontend.service.json @@ -1,6 +1,7 @@ { "name": "wix-window-frontend", "mixes": [], - "labels": [], + "labels": + [ "changed" ], "location": { "lineno": 1, "filename": "window-frontend.js" }, @@ -401,7 +402,8 @@ "extra": { } }, { "name": "getAppPageData", - "labels": [], + "labels": + [ "changed" ], "nameParams": [], "params": [], "ret": @@ -426,11 +428,11 @@ "examples": [ { "title": "Get the data passed to a custom app page", "body": - [ "import wixWindow from 'wix-window';", + [ "import wixWindowFrontend from 'wix-window-frontend';", "", "// ...", "", - "let appData = wixWindow.getAppPageData(); // {nextSection: {sectionId: \"Booking Form\"}}" ], + "let appData = wixWindowFrontend.getAppPageData(); // {nextSection: {sectionId: \"Booking Form\"}}" ], "extra": { } } ], "extra": diff --git a/js-wixcode-sdk/wix-window-frontend/Lightbox.service.json b/js-wixcode-sdk/wix-window-frontend/Lightbox.service.json index 2388f007ca..09aafbded4 100644 --- a/js-wixcode-sdk/wix-window-frontend/Lightbox.service.json +++ b/js-wixcode-sdk/wix-window-frontend/Lightbox.service.json @@ -1,8 +1,7 @@ { "name": "Lightbox", "memberOf": "wix-window-frontend", "mixes": [], - "labels": - [ "changed" ], + "labels": [], "location": { "lineno": 327, "filename": "window-frontend.js" }, @@ -175,8 +174,7 @@ "extra": { } }, { "name": "getContext", - "labels": - [ "changed" ], + "labels": [], "nameParams": [], "params": [], "ret": diff --git a/js-wixcode-sdk/wix-window.service.json b/js-wixcode-sdk/wix-window.service.json index 0431509d6b..630f5c53c8 100644 --- a/js-wixcode-sdk/wix-window.service.json +++ b/js-wixcode-sdk/wix-window.service.json @@ -1,6 +1,7 @@ { "name": "wix-window", "mixes": [], - "labels": [], + "labels": + [ "changed" ], "location": { "lineno": 1, "filename": "window.js" }, @@ -468,7 +469,8 @@ "extra": { } }, { "name": "getAppPageData", - "labels": [], + "labels": + [ "changed" ], "nameParams": [], "params": [], "ret": @@ -493,11 +495,11 @@ "examples": [ { "title": "Get the data passed to a custom app page", "body": - [ "import wixWindow from 'wix-window';", + [ "import wixWindowFrontend from 'wix-window-frontend';", "", "// ...", "", - "let appData = wixWindow.getAppPageData(); // {nextSection: {sectionId: \"Booking Form\"}}" ], + "let appData = wixWindowFrontend.getAppPageData(); // {nextSection: {sectionId: \"Booking Form\"}}" ], "extra": { } } ], "extra": From 514970408ac2a818e72a44f66e3c1a2a1c2626f1 Mon Sep 17 00:00:00 2001 From: sam-prais Date: Wed, 31 Jul 2024 10:00:02 +0300 Subject: [PATCH 2/2] DocWorks for js-wixcode-sdk - no significant changes detected, but 15 issue detected issues: Message ViewChangeEventOptions has an unknown property type * (ApppointmentFieldEvent.js (8)) Property target is missing a type annotation (GalleryNavigationStartEvent.js (15)) Operation postMessage has an unknown param type * (HtmlComponent.js (97)) Property data has an unknown type * (HtmlComponentMessageEvent.js (17)) Property fileLimit has mismatching types for get (number) and set (string) (UploadButton.js (128, 149)) Operation set has an unknown param type * (window-frontend.js (201)) Operation get has an unknown return type * (window-frontend.js (234)) Operation set has an unknown param type * (window.js (235)) Operation get has an unknown return type * (window.js (269)) Callback ViewChangeOperation is defined two or more times (AppointmentField.js (347), DatePicker.js (472)) Callback ViewChangeOperation has an unknown return type * (AppointmentField.js (347)) Callback ViewChangeEventHandler is defined two or more times (AppointmentField.js (362), DatePicker.js (466)) Callback Validator has an unknown param type * (ValidatableMixin.js (143)) Property value has an unknown type * (ValueMixin.js (62)) Property value has an unknown type * (ValueMixin.js (89)) --- js-wixcode-sdk/site-monitoring.service.json | 3 +-- js-wixcode-sdk/site-monitoring/LogEntry.service.json | 6 ++---- js-wixcode-sdk/wix-window-frontend.service.json | 6 ++---- js-wixcode-sdk/wix-window.service.json | 6 ++---- 4 files changed, 7 insertions(+), 14 deletions(-) diff --git a/js-wixcode-sdk/site-monitoring.service.json b/js-wixcode-sdk/site-monitoring.service.json index c319eb00e2..3d81479cab 100644 --- a/js-wixcode-sdk/site-monitoring.service.json +++ b/js-wixcode-sdk/site-monitoring.service.json @@ -1,7 +1,6 @@ { "name": "site-monitoring", "mixes": [], - "labels": - [ "changed" ], + "labels": [], "location": { "lineno": 1, "filename": "siteMonitoring.js" }, diff --git a/js-wixcode-sdk/site-monitoring/LogEntry.service.json b/js-wixcode-sdk/site-monitoring/LogEntry.service.json index d665319720..5f4aa2568f 100644 --- a/js-wixcode-sdk/site-monitoring/LogEntry.service.json +++ b/js-wixcode-sdk/site-monitoring/LogEntry.service.json @@ -1,8 +1,7 @@ { "name": "LogEntry", "memberOf": "site-monitoring", "mixes": [], - "labels": - [ "changed" ], + "labels": [], "location": { "lineno": 68, "filename": "siteMonitoring.js" }, @@ -331,8 +330,7 @@ "extra": { } }, { "name": "timestamp", - "labels": - [ "changed" ], + "labels": [], "get": true, "set": false, "type": "string", diff --git a/js-wixcode-sdk/wix-window-frontend.service.json b/js-wixcode-sdk/wix-window-frontend.service.json index a8b908e00b..095c695e48 100644 --- a/js-wixcode-sdk/wix-window-frontend.service.json +++ b/js-wixcode-sdk/wix-window-frontend.service.json @@ -1,7 +1,6 @@ { "name": "wix-window-frontend", "mixes": [], - "labels": - [ "changed" ], + "labels": [], "location": { "lineno": 1, "filename": "window-frontend.js" }, @@ -402,8 +401,7 @@ "extra": { } }, { "name": "getAppPageData", - "labels": - [ "changed" ], + "labels": [], "nameParams": [], "params": [], "ret": diff --git a/js-wixcode-sdk/wix-window.service.json b/js-wixcode-sdk/wix-window.service.json index 630f5c53c8..e5fe9d431f 100644 --- a/js-wixcode-sdk/wix-window.service.json +++ b/js-wixcode-sdk/wix-window.service.json @@ -1,7 +1,6 @@ { "name": "wix-window", "mixes": [], - "labels": - [ "changed" ], + "labels": [], "location": { "lineno": 1, "filename": "window.js" }, @@ -469,8 +468,7 @@ "extra": { } }, { "name": "getAppPageData", - "labels": - [ "changed" ], + "labels": [], "nameParams": [], "params": [], "ret":