Update to Sai.

Author: hotoo

Makefile

@@ -7,12 +7,12 @@ install:
 
 build:
 	@spm build
-	@googlecc ${PROJ_ROOT}/src/seer-monitor.js ${PROJ_ROOT}/dist/seer-monitor.js
+	@googlecc ${PROJ_ROOT}/src/seer-sai.js ${PROJ_ROOT}/dist/seer-sai.js
 	@googlecc ${PROJ_ROOT}/src/seer-jsniffer.js ${PROJ_ROOT}/dist/seer-jsniffer.js
-	@cat ${PROJ_ROOT}/dist/seer-monitor.js > ${PROJ_ROOT}/dist/seer.js
+	@cat ${PROJ_ROOT}/dist/seer-sai.js > ${PROJ_ROOT}/dist/seer.js
 	@cat ${PROJ_ROOT}/dist/seer-jsniffer.js >> ${PROJ_ROOT}/dist/seer.js
-	@rm ${PROJ_ROOT}/dist/seer-monitor.js ${PROJ_ROOT}/dist/seer-jsniffer.js
-	@cat ${PROJ_ROOT}/src/seer-monitor.js > ${PROJ_ROOT}/dist/seer-debug.js
+	@rm ${PROJ_ROOT}/dist/seer-sai.js ${PROJ_ROOT}/dist/seer-jsniffer.js
+	@cat ${PROJ_ROOT}/src/seer-sai.js > ${PROJ_ROOT}/dist/seer-debug.js
 	@cat ${PROJ_ROOT}/src/seer-jsniffer.js >> ${PROJ_ROOT}/dist/seer-debug.js
 
 build-doc:

README.md

@@ -1,18 +1,16 @@
 
-# monitor: 通用前端监控采集脚本。
+# Sai: 通用前端监控采集脚本。
 
 ---
 
-[![spm package](http://spmjs.io/badge/monitor)](http://spmjs.io/package/monitor)
-[![Build Status](https://secure.travis-ci.org/totorojs/monitor.png?branch=master)](https://travis-ci.org/totorojs/monitor)
-[![Coverage Status](https://coveralls.io/repos/totorojs/monitor/badge.png?branch=master)](https://coveralls.io/r/totorojs/monitor)
+[![spm package](http://spmjs.io/badge/sai)](http://spmjs.io/package/sai)
+[![Build Status](https://secure.travis-ci.org/saijs/sai.js.png?branch=master)](https://travis-ci.org/saijs/sai.js)
+[![Coverage Status](https://coveralls.io/repos/saijs/sai.js/badge.png?branch=master)](https://coveralls.io/r/saijs/sai.js)
 
 
-为了和整体的 totoro 质量体系保持一致，特为前端监控脚本取小名为 `chibi`，
-龙猫中最小的那只龙猫（chibi totoro）。
-chibi 体型小巧，白色透明特质正好与前端监控的小巧、不可见特质相匹配。
+Sai 是《棋魂》中追求神乎其技的魂，千年来他隐身身后，为追求神乎其技孜孜不倦。
 
-![chibi](resources/chibi.png)
+![sai](resources/sai.png)
 
 ## 概述
 
@@ -29,9 +27,9 @@ chibi 体型小巧，白色透明特质正好与前端监控的小巧、不可
 
 大致结构如下图：
 
-![前端监控组件结构](resources/monitor-code-structure.png)
+![前端监控组件结构](resources/code-structure.png)
 
-从上图看，前端监控(monitor 模块)提供了核心的 `log()` 接口，
+从上图看，前端监控(Sai 模块)提供了核心的 `log()` 接口，
 和 `on()`, `off()` 事件机制，其中 `log()` 接口提供了可扩展的数据传输方案，
 `on()`, `off()` 事件机制提供了简单易用的扩展能力。
 
@@ -42,9 +40,9 @@ JSniffer 同时还扩展了 `lost()` 方法，在外部模块或资源加载失
 方法，监控到 JavaScript 异常时，附加这些缺失的资源信息，辅助异常分析。
 
 JavaScript 异常是前端监控中最重要、最常用的信息，同时为了简化 API，所以将
-这两个接口扩展附加在 monitor 模块上。
+这两个接口扩展附加在 Sai 模块上。
 
-其他的 DOMLint, SENS 等第三方独立的监控模块，都直接调用 `monitor.log()` 接口
+其他的 DOMLint, SENS 等第三方独立的监控模块，都直接调用 `Sai.log()` 接口
 传输数据。
 
 
@@ -57,7 +55,7 @@ JavaScript 异常是前端监控中最重要、最常用的信息，同时为了
     小巧的先行脚本建议内联（也可以外联）在页面头部，在所有脚本和外部资源之前。
     用于收集全局的异常，并为后续业务准备好可用的 API。
 
-* monitor.js
+* sai.js
 
     后置监控模块（这是一个 CMD 模块）可以通过异步方式加载在页面底部，
     用于处理监控日志的发送和其他扩展支持。
@@ -74,7 +72,7 @@ JavaScript 异常是前端监控中最重要、最常用的信息，同时为了
   page content...
 
   <script type="text/javascript">
-  seajs.use("monitor", function(monitor){
+  seajs.use("sai", function(Sai){
   });
   </script>
   </body>
@@ -86,26 +84,26 @@ JavaScript 异常是前端监控中最重要、最常用的信息，同时为了
 
 一般情况下，JavaScript 异常监控前置脚本已经自动收集了页面上抛出的异常，
 但也有部分场景，业务逻辑中 catch 捕获住了抛出 JavaScript 异常，避免影响后续
-的业务逻辑，但同时希望监控到这个异常场景，可以主动调用 `monitor.error()` 接口：
+的业务逻辑，但同时希望监控到这个异常场景，可以主动调用 `Sai.error()` 接口：
 
 ```javascript
 try{
   throw new Error("msg");
 }catch(ex){
-  monitor.error(ex);
+  Sai.error(ex);
 }
 ```
 
 
 ## API
 
 
-### monitor.error(Error error)
+### Sai.error(Error error)
 
 JavaScript 异常监控的接口，可以用于主动监控被捕获的 JavaScript 异常。
 
 
-### monitor.log(Object seed [, String profile])
+### Sai.log(Object seed [, String profile])
 
 前端监控的通用频次监控接口。通过这个发送监控数据，并配合对应的日志处理和数据分析，
 可以完成多种监控需求。
@@ -114,7 +112,7 @@ JavaScript 异常监控的接口，可以用于主动监控被捕获的 JavaScri
 * `profile`: 日志类型，默认为 `log`。
 
 
-### monitor.on(String eventName, Function handler)
+### Sai.on(String eventName, Function handler)
 
 监控到特定类型的数据时，会触发的特定事件。内置支持的事件类型包括：
 
@@ -124,24 +122,24 @@ JavaScript 异常监控的接口，可以用于主动监控被捕获的 JavaScri
 * 其他任意的自定义类型类似。
 
 
-### monitor.off(String eventName [, Function handler])
+### Sai.off(String eventName [, Function handler])
 
 取消通过 on 绑定的事件。
 
 
-### monitor.lost(String uri)
+### Sai.lost(String uri)
 
 页面加载特定资源失败时，可以调用这个方法。
 缺失的资源对于异常分析有较大帮助。
 
 范例：
 
 ```html
-<script src="sea.js" onerror="window.monitor && monitor.lost && monitor.lost(this.src)"></script>
+<script src="sea.js" onerror="window.Sai && Sai.lost && Sai.lost(this.src)"></script>
 <script>
 // seajs 2.1 开始支持，但 error 事件仍有缺陷，seajs 2.2 的 error 事件较适合本场景。
 seajs.on("error", function(module){
-  window.monitor && monitor.lost && monitor.lost(module.uri);
+  window.Sai && Sai.lost && Sai.lost(module.uri);
 });
 </script>
 ```

doc/install.md

@@ -34,9 +34,9 @@
   <script type="text/javascript">
 
   // 如果前置脚本未准备好，建议不加载后置脚本。
-  // 如果需要采样监控，请在采样命中后 use 加载 monitor 模块。
-  if(window.monitor && rateHited){
-    seajs.use(["monitor"], function(monitor){
+  // 如果需要采样监控，请在采样命中后 use 加载 Sai 模块。
+  if(window.Sai && rateHited){
+    seajs.use(["sai"], function(Sai){
     });
   }
 

examples/index.md

@@ -9,7 +9,7 @@ button{
 }
 </style>
 
-<script type="text/javascript" src="../src/seer-monitor.js"></script>
+<script type="text/javascript" src="../src/seer-sai.js"></script>
 <script type="text/javascript" src="../src/seer-jsniffer.js"></script>
 
 
@@ -26,46 +26,46 @@ button{
   // 命中率：[0,1]: 实际对应采样率：[0%,100%]
   var rate = 1;
   if(!hit(rate)){return;}
-  seajs.use("monitor", function(monitor){
+  seajs.use("sai", function(Sai){
   });
 })();
 ````
 
 ----
 
-<script type="text/javascript" onerror="window.monitor && monitor.lost(this.src)" src="http://example.com/404.js"></script>
+<script type="text/javascript" onerror="window.Sai && Sai.lost(this.src)" src="http://example.com/404.js"></script>
 
 <button type="button" id="btn-ex1">throw new Error()</button>
-<button type="button" id="btn-ex2">monitor.error(new Error())</button>
+<button type="button" id="btn-ex2">Sai.error(new Error())</button>
 <button type="button" id="btn-ex3">try undefined var</button>
 
 ----
 
-<button type="button" id="btn3">monitor.log(seed)</button>
-<button type="button" id="btn4">monitor.log(seed, profile)</button>
-<button type="button" id="btn5">monitor.log(productLine, product, code)</button>
-<button type="button" id="btn6">monitor.log(Object)</button>
-<button type="button" id="btn7">monitor.log({profile})</button>
+<button type="button" id="btn3">Sai.log(seed)</button>
+<button type="button" id="btn4">Sai.log(seed, profile)</button>
+<button type="button" id="btn5">Sai.log(productLine, product, code)</button>
+<button type="button" id="btn6">Sai.log(Object)</button>
+<button type="button" id="btn7">Sai.log({profile})</button>
 
 <script type="text/javascript">
 seajs.on("error", function(module){
-  window.monitor && monitor.lost(module.uri);
+  window.Sai && Sai.lost(module.uri);
 });
 seajs.use("http://www.example.com/404");
 
-seajs.use(["jquery", "monitor"], function($, monitor){
+seajs.use(["jquery", "sai"], function($, Sai){
   $("#btn-ex1").click(function(clickEx1){
     throw new Error("throw new error message.");
   });
   $("#btn-ex2").click(function(clickEx2){
-    monitor.error(new Error("log new error message."));
+    Sai.error(new Error("log new error message."));
   });
   $("#btn-ex3").click(function(clickEx3){
     function a2(a2,a21,a22){
     try{
       notDefined();
     }catch(ex){
-      monitor.error(ex);
+      Sai.error(ex);
     }
     }
     function a1(a1){
@@ -74,22 +74,22 @@ seajs.use(["jquery", "monitor"], function($, monitor){
     a1(1);
   });
   $("#btn3").click(function(){
-    monitor.log("test-seed");
+    Sai.log("test-seed");
   });
   $("#btn4").click(function(){
-    monitor.log("test-seed", "test-profile");
+    Sai.log("test-seed", "test-profile");
   });
   $("#btn5").click(function(){
-    monitor.log("productLine", "product", "code");
+    Sai.log("productLine", "product", "code");
   });
   $("#btn6").click(function(){
-    monitor.log({
+    Sai.log({
       "userKey": 0,
       "key2": "2"
     });
   });
   $("#btn7").click(function(){
-    monitor.log({
+    Sai.log({
       "userKey": 0,
       "key2": "2",
       "profile": "user-profile"

examples/monitor-on.md examples/sai-on.md

@@ -1,4 +1,4 @@
-# monitor.on() events.
+# Sai.on() events.
 
 ---
 
@@ -9,20 +9,20 @@ button{
 }
 </style>
 
-<script type="text/javascript" src="../src/seer-monitor.js"></script>
+<script type="text/javascript" src="../src/seer-sai.js"></script>
 <script type="text/javascript" src="../src/seer-jsniffer.js"></script>
 
 
 ````javascript
 (function(){
 
-  seajs.use("monitor", function(monitor){
+  seajs.use("sai", function(Sai){
 
-    monitor.on("*", function(meta){
+    Sai.on("*", function(meta){
       meta.uid = "user_id";
     });
 
-    monitor.on("jserror", function(meta){
+    Sai.on("jserror", function(meta){
       meta.error_id = "error_id";
     });
 
@@ -45,19 +45,19 @@ button{
 
 <script type="text/javascript">
 
-seajs.use(["jquery", "monitor"], function($, monitor){
+seajs.use(["jquery", "sai"], function($, Sai){
   $("#btn-ex1").click(function(clickEx1){
     throw new Error("throw new error message.");
   });
   $("#btn-ex2").click(function(clickEx2){
-    monitor.error(new Error("log new error message."));
+    Sai.error(new Error("log new error message."));
   });
   $("#btn-ex3").click(function(clickEx3){
     function a2(a2,a21,a22){
     try{
       notDefined();
     }catch(ex){
-      monitor.error(ex);
+      Sai.error(ex);
     }
     }
     function a1(a1){
@@ -66,7 +66,7 @@ seajs.use(["jquery", "monitor"], function($, monitor){
     a1(1);
   });
   $("#btn-log").click(function(clickEx2){
-    monitor.log("seed");
+    Sai.log("seed");
   });
 });
 </script>

package.json

@@ -1,23 +1,23 @@
 {
-  "name": "monitor",
-  "version": "2.4.0",
+  "name": "sai",
+  "version": "3.0.0",
   "description": "通用前端监控脚本",
-  "homepage": "https://github.com/totorojs/monitor",
+  "homepage": "https://github.com/saijs/sai.js",
   "author": "闲耘 <[email protected]>",
   "maintainers": [
-    "冒顿 <[email protected]>"
+    "闲耘 <[email protected]>"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/totorojs/monitor.git"
+    "url": "https://github.com/saijs/sai.js.git"
   },
-  "bugs": "https://github.com/totorojs/monitor/issues",
+  "bugs": "https://github.com/saijs/sai.js/issues",
   "keywords": ["utility"],
   "licenses": "MIT",
   "scripts": {
   },
   "spm": {
-    "main": "monitor.js",
+    "main": "sai.js",
     "dependencies": {
       "detector": "2.0.1",
       "arale-events": "1.2.0"

resources/chibi.png

@@ -2,7 +2,7 @@
 var win = window;
 var doc = win.document;
 var loc = win.location;
-var M = win.monitor;
+var M = win.Sai;
 
 var detector = require("detector");
 var Events = require("arale-events");
@@ -207,5 +207,5 @@ M._DATAS.push = function(){
 // 主动发送已捕获的异常。
 timedSend();
 
-win.monitor = M;
+win.Sai = M;
 module.exports = M;