rian 0.2.1 → 0.2.3

package/exporter.otel.http/index.js

@@ -1,110 +1 @@
-// src/exporter.otel.http.ts
-const { name:rian_name, version:rian_version } = require('rian/package.json');
-var SpanStatusCode_UNSET = 0;
-var SpanStatusCode_ERROR = 2;
-var convert_value_to_anyvalue = (value) => {
-  let type = typeof value, any_value = {};
-  if (type === "string")
-    any_value.stringValue = value;
-  else if (type === "number")
-    if (Number.isInteger(value))
-      any_value.intValue = value;
-    else
-      any_value.doubleValue = value;
-  else if (type === "boolean")
-    any_value.boolValue = value;
-  else if (Array.isArray(value))
-    any_value.arrayValue = {
-      values: value.map((i) => convert_value_to_anyvalue(i))
-    };
-  else if (value)
-    any_value.kvlistValue = { values: convert_object_to_kv(value) };
-  return any_value;
-};
-var convert_object_to_kv = (input) => {
-  const value = [];
-  for (let key of Object.keys(input)) {
-    value.push({
-      key,
-      value: convert_value_to_anyvalue(input[key])
-    });
-  }
-  return value;
-};
-var map_kind = (kind) => {
-  switch (kind) {
-    default:
-    case "INTERNAL": {
-      return 1;
-    }
-    case "SERVER": {
-      return 2;
-    }
-    case "CLIENT": {
-      return 3;
-    }
-    case "PRODUCER": {
-      return 4;
-    }
-    case "CONSUMER": {
-      return 5;
-    }
-  }
-};
-var exporter = (request) => (spans, context) => {
-  const otel_spans = [];
-  for (let span of spans) {
-    const { kind, error, ...span_ctx } = span.context;
-    let status;
-    if (error) {
-      status = {
-        code: SpanStatusCode_ERROR
-      };
-      if ("message" in error) {
-        status.message = error.message;
-      }
-    }
-    otel_spans.push({
-      traceId: span.id.trace_id,
-      spanId: span.id.parent_id,
-      parentSpanId: span.parent?.parent_id,
-      name: span.name,
-      kind: map_kind(kind || "INTERNAL"),
-      startTimeUnixNano: span.start * 1e6,
-      endTimeUnixNano: span.end ? span.end * 1e6 : void 0,
-      droppedAttributesCount: 0,
-      droppedEventsCount: 0,
-      droppedLinksCount: 0,
-      attributes: convert_object_to_kv(span_ctx),
-      status: status || { code: SpanStatusCode_UNSET },
-      events: span.events.map((i) => ({
-        name: i.name,
-        attributes: convert_object_to_kv(i.attributes),
-        droppedAttributesCount: 0,
-        timeUnixNano: i.timestamp * 1e6
-      }))
-    });
-  }
-  return request({
-    resourceSpans: [
-      {
-        resource: {
-          attributes: convert_object_to_kv(context),
-          droppedAttributesCount: 0
-        },
-        instrumentationLibrarySpans: [
-          {
-            instrumentationLibrary: {
-              name: rian_name,
-              version: rian_version
-            },
-            spans: otel_spans
-          }
-        ]
-      }
-    ]
-  });
-};
-
-
-exports.exporter = exporter;
+const { name:e, version:t } = require('rian/package.json');var r=e=>{let t=typeof e,n={};return"string"===t?n.stringValue=e:"number"===t?Number.isInteger(e)?n.intValue=e:n.doubleValue=e:"boolean"===t?n.boolValue=e:Array.isArray(e)?n.arrayValue={values:e.map((e=>r(e)))}:e&&(n.kvlistValue={values:a(e)}),n},a=e=>{let t=[];for(let a of Object.keys(e))t.push({key:a,value:r(e[a])});return t},n=e=>{switch(e){default:case"INTERNAL":return 1;case"SERVER":return 2;case"CLIENT":return 3;case"PRODUCER":return 4;case"CONSUMER":return 5}},s=r=>(s,i)=>{let u=[];for(let e of s){let t,{kind:r,error:s,...i}=e.context;s&&(t={code:2},"message"in s&&(t.message=s.message)),u.push({traceId:e.id.trace_id,spanId:e.id.parent_id,parentSpanId:e.parent?.parent_id,name:e.name,kind:n(r||"INTERNAL"),startTimeUnixNano:1e6*e.start,endTimeUnixNano:e.end?1e6*e.end:void 0,droppedAttributesCount:0,droppedEventsCount:0,droppedLinksCount:0,attributes:a(i),status:t||{code:0},events:e.events.map((e=>({name:e.name,attributes:a(e.attributes),droppedAttributesCount:0,timeUnixNano:1e6*e.timestamp})))})}return r({resourceSpans:[{resource:{attributes:a(i),droppedAttributesCount:0},instrumentationLibrarySpans:[{instrumentationLibrary:{name:e,version:t},spans:u}]}]})};exports.exporter=s;

package/exporter.otel.http/index.mjs

@@ -1,110 +1 @@
-// src/exporter.otel.http.ts
-import { name as rian_name, version as rian_version } from "rian/package.json";
-var SpanStatusCode_UNSET = 0;
-var SpanStatusCode_ERROR = 2;
-var convert_value_to_anyvalue = (value) => {
-  let type = typeof value, any_value = {};
-  if (type === "string")
-    any_value.stringValue = value;
-  else if (type === "number")
-    if (Number.isInteger(value))
-      any_value.intValue = value;
-    else
-      any_value.doubleValue = value;
-  else if (type === "boolean")
-    any_value.boolValue = value;
-  else if (Array.isArray(value))
-    any_value.arrayValue = {
-      values: value.map((i) => convert_value_to_anyvalue(i))
-    };
-  else if (value)
-    any_value.kvlistValue = { values: convert_object_to_kv(value) };
-  return any_value;
-};
-var convert_object_to_kv = (input) => {
-  const value = [];
-  for (let key of Object.keys(input)) {
-    value.push({
-      key,
-      value: convert_value_to_anyvalue(input[key])
-    });
-  }
-  return value;
-};
-var map_kind = (kind) => {
-  switch (kind) {
-    default:
-    case "INTERNAL": {
-      return 1;
-    }
-    case "SERVER": {
-      return 2;
-    }
-    case "CLIENT": {
-      return 3;
-    }
-    case "PRODUCER": {
-      return 4;
-    }
-    case "CONSUMER": {
-      return 5;
-    }
-  }
-};
-var exporter = (request) => (spans, context) => {
-  const otel_spans = [];
-  for (let span of spans) {
-    const { kind, error, ...span_ctx } = span.context;
-    let status;
-    if (error) {
-      status = {
-        code: SpanStatusCode_ERROR
-      };
-      if ("message" in error) {
-        status.message = error.message;
-      }
-    }
-    otel_spans.push({
-      traceId: span.id.trace_id,
-      spanId: span.id.parent_id,
-      parentSpanId: span.parent?.parent_id,
-      name: span.name,
-      kind: map_kind(kind || "INTERNAL"),
-      startTimeUnixNano: span.start * 1e6,
-      endTimeUnixNano: span.end ? span.end * 1e6 : void 0,
-      droppedAttributesCount: 0,
-      droppedEventsCount: 0,
-      droppedLinksCount: 0,
-      attributes: convert_object_to_kv(span_ctx),
-      status: status || { code: SpanStatusCode_UNSET },
-      events: span.events.map((i) => ({
-        name: i.name,
-        attributes: convert_object_to_kv(i.attributes),
-        droppedAttributesCount: 0,
-        timeUnixNano: i.timestamp * 1e6
-      }))
-    });
-  }
-  return request({
-    resourceSpans: [
-      {
-        resource: {
-          attributes: convert_object_to_kv(context),
-          droppedAttributesCount: 0
-        },
-        instrumentationLibrarySpans: [
-          {
-            instrumentationLibrary: {
-              name: rian_name,
-              version: rian_version
-            },
-            spans: otel_spans
-          }
-        ]
-      }
-    ]
-  });
-};
-export {
-  exporter
-};
+import{name as e,version as t}from"rian/package.json";var r=e=>{let t=typeof e,n={};return"string"===t?n.stringValue=e:"number"===t?Number.isInteger(e)?n.intValue=e:n.doubleValue=e:"boolean"===t?n.boolValue=e:Array.isArray(e)?n.arrayValue={values:e.map((e=>r(e)))}:e&&(n.kvlistValue={values:a(e)}),n},a=e=>{let t=[];for(let a of Object.keys(e))t.push({key:a,value:r(e[a])});return t},n=e=>{switch(e){default:case"INTERNAL":return 1;case"SERVER":return 2;case"CLIENT":return 3;case"PRODUCER":return 4;case"CONSUMER":return 5}},s=r=>(s,i)=>{let u=[];for(let e of s){let t,{kind:r,error:s,...i}=e.context;s&&(t={code:2},"message"in s&&(t.message=s.message)),u.push({traceId:e.id.trace_id,spanId:e.id.parent_id,parentSpanId:e.parent?.parent_id,name:e.name,kind:n(r||"INTERNAL"),startTimeUnixNano:1e6*e.start,endTimeUnixNano:e.end?1e6*e.end:void 0,droppedAttributesCount:0,droppedEventsCount:0,droppedLinksCount:0,attributes:a(i),status:t||{code:0},events:e.events.map((e=>({name:e.name,attributes:a(e.attributes),droppedAttributesCount:0,timeUnixNano:1e6*e.timestamp})))})}return r({resourceSpans:[{resource:{attributes:a(i),droppedAttributesCount:0},instrumentationLibrarySpans:[{instrumentationLibrary:{name:e,version:t},spans:u}]}]})};export{s as exporter};

package/exporter.zipkin/index.js

@@ -1,43 +1 @@
-// src/exporter.zipkin.ts
-const { flattie } = require('flattie');
-var exporter = (request) => (spans, context) => {
-  const zipkin = [];
-  for (let span of spans) {
-    const { kind, error, ...span_ctx } = span.context;
-    if (error) {
-      if ("message" in error) {
-        span_ctx.error = {
-          name: error.name,
-          message: error.message,
-          stack: error.stack
-        };
-      } else {
-        span_ctx.error = true;
-      }
-    }
-    zipkin.push({
-      id: span.id.parent_id,
-      traceId: span.id.trace_id,
-      parentId: span.parent ? span.parent.parent_id : void 0,
-      name: span.name,
-      kind: kind === "INTERNAL" ? void 0 : kind,
-      timestamp: span.start * 1e3,
-      duration: span.end ? (span.end - span.start) * 1e3 : void 0,
-      localEndpoint: context.localEndpoint || {
-        serviceName: span_ctx["service.name"]
-      },
-      tags: flattie({
-        ...context,
-        ...span_ctx
-      }, ".", true),
-      annotations: span.events.map((i) => ({
-        value: `${i.name} :: ${JSON.stringify(i.attributes)}`,
-        timestamp: i.timestamp * 1e3
-      }))
-    });
-  }
-  return request(zipkin);
-};
-
-
-exports.exporter = exporter;
+const { flattie:e } = require('flattie');var t=t=>(a,n)=>{let r=[];for(let t of a){let{kind:a,error:i,...s}=t.context;i&&(s.error=!("message"in i)||{name:i.name,message:i.message,stack:i.stack}),r.push({id:t.id.parent_id,traceId:t.id.trace_id,parentId:t.parent?t.parent.parent_id:void 0,name:t.name,kind:"INTERNAL"===a?void 0:a,timestamp:1e3*t.start,duration:t.end?1e3*(t.end-t.start):void 0,localEndpoint:n.localEndpoint||{serviceName:s["service.name"]},tags:e({...n,...s},".",!0),annotations:t.events.map((e=>({value:`${e.name} :: ${JSON.stringify(e.attributes)}`,timestamp:1e3*e.timestamp})))})}return t(r)};exports.exporter=t;

package/exporter.zipkin/index.mjs

@@ -1,43 +1 @@
-// src/exporter.zipkin.ts
-import { flattie } from "flattie";
-var exporter = (request) => (spans, context) => {
-  const zipkin = [];
-  for (let span of spans) {
-    const { kind, error, ...span_ctx } = span.context;
-    if (error) {
-      if ("message" in error) {
-        span_ctx.error = {
-          name: error.name,
-          message: error.message,
-          stack: error.stack
-        };
-      } else {
-        span_ctx.error = true;
-      }
-    }
-    zipkin.push({
-      id: span.id.parent_id,
-      traceId: span.id.trace_id,
-      parentId: span.parent ? span.parent.parent_id : void 0,
-      name: span.name,
-      kind: kind === "INTERNAL" ? void 0 : kind,
-      timestamp: span.start * 1e3,
-      duration: span.end ? (span.end - span.start) * 1e3 : void 0,
-      localEndpoint: context.localEndpoint || {
-        serviceName: span_ctx["service.name"]
-      },
-      tags: flattie({
-        ...context,
-        ...span_ctx
-      }, ".", true),
-      annotations: span.events.map((i) => ({
-        value: `${i.name} :: ${JSON.stringify(i.attributes)}`,
-        timestamp: i.timestamp * 1e3
-      }))
-    });
-  }
-  return request(zipkin);
-};
-export {
-  exporter
-};
+import{flattie as e}from"flattie";var t=t=>(a,n)=>{let r=[];for(let t of a){let{kind:a,error:i,...s}=t.context;i&&(s.error=!("message"in i)||{name:i.name,message:i.message,stack:i.stack}),r.push({id:t.id.parent_id,traceId:t.id.trace_id,parentId:t.parent?t.parent.parent_id:void 0,name:t.name,kind:"INTERNAL"===a?void 0:a,timestamp:1e3*t.start,duration:t.end?1e3*(t.end-t.start):void 0,localEndpoint:n.localEndpoint||{serviceName:s["service.name"]},tags:e({...n,...s},".",!0),annotations:t.events.map((e=>({value:`${e.name} :: ${JSON.stringify(e.attributes)}`,timestamp:1e3*e.timestamp})))})}return t(r)};export{t as exporter};

package/index.d.ts

@@ -170,7 +170,7 @@ export interface Options {
 	 * If the id is malformed, the {@link create} method will throw an exception. If no root is
 	 * provided then one will be created obeying the {@link Options.sampler|sampling} rules.
 	 */
-	traceparent?: string;
+	traceparent?: string | null;
 }
 
 export const create: (name: string, options: Options) => Tracer;
@@ -181,9 +181,3 @@ export const create: (name: string, options: Options) => Tracer;
 export interface CallableScope extends Scope {
 	(cb: (scope: Omit<Scope, 'end'>) => void): ReturnType<typeof cb>;
 }
-
-/** @internal */
-export const PROMISES: WeakMap<Scope, Promise<any>[]>;
-
-/** @internal */
-export const ADD_PROMISE: (scope: Scope, promise: Promise<any>) => void;

package/index.js

@@ -1,76 +1 @@
-// src/index.ts
-const { name:rian_name, version:rian_version } = require('rian/package.json');
-const tctx = require('tctx');
-const { measureFn } = require('rian/utils');
-var PROMISES = /* @__PURE__ */ new WeakMap();
-var ADD_PROMISE = (scope, promise) => {
-  if (PROMISES.has(scope))
-    PROMISES.get(scope).push(promise);
-  else
-    PROMISES.set(scope, [promise]);
-};
-var defaultSampler = (_name, parentId) => {
-  if (!parentId)
-    return true;
-  return tctx.is_sampled(parentId);
-};
-var sdk_object = {
-  "telemetry.sdk.name": rian_name,
-  "telemetry.sdk.version": rian_version
-};
-var create = (name, options) => {
-  const spans = /* @__PURE__ */ new Set();
-  const sampler = options.sampler || defaultSampler;
-  const sampler_callable = typeof sampler !== "boolean";
-  const span = (name2, parent) => {
-    const should_sample = sampler_callable ? sampler(name2, parent, options.context) : sampler;
-    const id = parent ? parent.child(should_sample) : tctx.make(should_sample);
-    const span_obj = {
-      id,
-      parent,
-      start: Date.now(),
-      name: name2,
-      events: [],
-      context: {}
-    };
-    if (should_sample)
-      spans.add(span_obj);
-    const $ = (cb) => measureFn($, cb);
-    $.traceparent = id;
-    $.fork = (name3) => span(name3, id);
-    $.set_context = (ctx) => {
-      if (typeof ctx === "function")
-        return void (span_obj.context = ctx(span_obj.context));
-      Object.assign(span_obj.context, ctx);
-    };
-    $.add_event = (name3, attributes) => {
-      span_obj.events.push({
-        name: name3,
-        timestamp: Date.now(),
-        attributes: attributes || {}
-      });
-    };
-    $.end = () => {
-      if (span_obj.end == null)
-        span_obj.end = Date.now();
-    };
-    return $;
-  };
-  const root = span(name, typeof options.traceparent === "string" ? tctx.parse(options.traceparent) : void 0);
-  const endRoot = root.end.bind(root);
-  root.end = async () => {
-    endRoot();
-    if (PROMISES.has(root))
-      await Promise.all(PROMISES.get(root));
-    return options.exporter(spans, {
-      ...options.context || {},
-      ...sdk_object
-    });
-  };
-  return root;
-};
-
-
-exports.ADD_PROMISE = ADD_PROMISE;
-exports.PROMISES = PROMISES;
-exports.create = create;
+const { measureFn:e } = require('rian/utils');const t = require('tctx');var n=(e,n)=>!n||t.is_sampled(n),a={"telemetry.sdk.name":"rian","telemetry.sdk.version":"0.2.3"},r=(r,o)=>{let s=new Set,d=new Set,i=o.sampler||n,p="boolean"!=typeof i,m=(n,a)=>{let r=p?i(n,a,o.context):i,c=a?a.child(r):t.make(r),l={id:c,parent:a,start:Date.now(),name:n,events:[],context:{}};r&&s.add(l);let x=t=>e(x,t);return x.traceparent=c,x.fork=e=>m(e,c),x.set_context=e=>{"function"!=typeof e?Object.assign(l.context,e):l.context=e(l.context)},x.add_event=(e,t)=>{l.events.push({name:e,timestamp:Date.now(),attributes:t||{}})},x.end=()=>{null==l.end&&(l.end=Date.now())},x.__add_promise=d.add.bind(d),x},c=m(r,"string"==typeof o.traceparent?t.parse(o.traceparent):void 0),l=c.end.bind(c);return c.end=async()=>(l(),d.size>0&&await Promise.all([...d.values()]),o.exporter(s,{...o.context||{},...a})),c};exports.create=r;

package/index.mjs

@@ -1,76 +1 @@
-// src/index.ts
-import { name as rian_name, version as rian_version } from "rian/package.json";
-import * as tctx from "tctx";
-import { measureFn } from "rian/utils";
-var PROMISES = /* @__PURE__ */ new WeakMap();
-var ADD_PROMISE = (scope, promise) => {
-  if (PROMISES.has(scope))
-    PROMISES.get(scope).push(promise);
-  else
-    PROMISES.set(scope, [promise]);
-};
-var defaultSampler = (_name, parentId) => {
-  if (!parentId)
-    return true;
-  return tctx.is_sampled(parentId);
-};
-var sdk_object = {
-  "telemetry.sdk.name": rian_name,
-  "telemetry.sdk.version": rian_version
-};
-var create = (name, options) => {
-  const spans = /* @__PURE__ */ new Set();
-  const sampler = options.sampler || defaultSampler;
-  const sampler_callable = typeof sampler !== "boolean";
-  const span = (name2, parent) => {
-    const should_sample = sampler_callable ? sampler(name2, parent, options.context) : sampler;
-    const id = parent ? parent.child(should_sample) : tctx.make(should_sample);
-    const span_obj = {
-      id,
-      parent,
-      start: Date.now(),
-      name: name2,
-      events: [],
-      context: {}
-    };
-    if (should_sample)
-      spans.add(span_obj);
-    const $ = (cb) => measureFn($, cb);
-    $.traceparent = id;
-    $.fork = (name3) => span(name3, id);
-    $.set_context = (ctx) => {
-      if (typeof ctx === "function")
-        return void (span_obj.context = ctx(span_obj.context));
-      Object.assign(span_obj.context, ctx);
-    };
-    $.add_event = (name3, attributes) => {
-      span_obj.events.push({
-        name: name3,
-        timestamp: Date.now(),
-        attributes: attributes || {}
-      });
-    };
-    $.end = () => {
-      if (span_obj.end == null)
-        span_obj.end = Date.now();
-    };
-    return $;
-  };
-  const root = span(name, typeof options.traceparent === "string" ? tctx.parse(options.traceparent) : void 0);
-  const endRoot = root.end.bind(root);
-  root.end = async () => {
-    endRoot();
-    if (PROMISES.has(root))
-      await Promise.all(PROMISES.get(root));
-    return options.exporter(spans, {
-      ...options.context || {},
-      ...sdk_object
-    });
-  };
-  return root;
-};
-export {
-  ADD_PROMISE,
-  PROMISES,
-  create
-};
+import{measureFn as e}from"rian/utils";import*as t from"tctx";var n=(e,n)=>!n||t.is_sampled(n),a={"telemetry.sdk.name":"rian","telemetry.sdk.version":"0.2.3"},r=(r,o)=>{let s=new Set,d=new Set,i=o.sampler||n,p="boolean"!=typeof i,m=(n,a)=>{let r=p?i(n,a,o.context):i,c=a?a.child(r):t.make(r),l={id:c,parent:a,start:Date.now(),name:n,events:[],context:{}};r&&s.add(l);let x=t=>e(x,t);return x.traceparent=c,x.fork=e=>m(e,c),x.set_context=e=>{"function"!=typeof e?Object.assign(l.context,e):l.context=e(l.context)},x.add_event=(e,t)=>{l.events.push({name:e,timestamp:Date.now(),attributes:t||{}})},x.end=()=>{null==l.end&&(l.end=Date.now())},x.__add_promise=d.add.bind(d),x},c=m(r,"string"==typeof o.traceparent?t.parse(o.traceparent):void 0),l=c.end.bind(c);return c.end=async()=>(l(),d.size>0&&await Promise.all([...d.values()]),o.exporter(s,{...o.context||{},...a})),c};export{r as create};

package/license

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Marais Rossouw <me@marais.dev>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rian",
-	"version": "0.2.1",
+	"version": "0.2.3",
 	"description": "Effective tracing for the edge and origins",
 	"keywords": [
 		"opentelemetry",
@@ -17,11 +17,7 @@
 	],
 	"repository": "maraisr/rian",
 	"license": "MIT",
-	"author": {
-		"name": "Marais Rossouw",
-		"email": "me@marais.dev",
-		"url": "https://marais.io"
-	},
+	"author": "Marais Rossow <me@marais.dev> (https://marais.io)",
 	"sideEffects": false,
 	"type": "module",
 	"exports": {
@@ -58,13 +54,29 @@
 		"utils/*"
 	],
 	"scripts": {
-		"build": "bundt"
+		"bench": "node -r tsm bench/index.ts",
+		"build": "bundt --minify",
+		"format": "prettier --write \"{*,{src,test}/**/*,examples/*/**,bench/*,.github/**/*}.+(ts|js|json|yml|md)\"",
+		"pretest": "pnpm run build",
+		"test": "uvu -r tsm test \".spec.m?ts$\"",
+		"typecheck": "tsc --noEmit --skipLibCheck"
 	},
 	"dependencies": {
 		"flattie": "^1.1.0",
 		"tctx": "^0.0.10"
 	},
 	"devDependencies": {
-		"bundt": "2.0.0-next.5"
+		"@marais/prettier": "0.0.1",
+		"@marais/tsconfig": "0.0.3",
+		"bundt": "2.0.0-next.5",
+		"nanospy": "0.5.0",
+		"prettier": "2.7.1",
+		"tsm": "2.2.2",
+		"typescript": "4.8.4",
+		"uvu": "0.5.6"
+	},
+	"prettier": "@marais/prettier",
+	"volta": {
+		"node": "17.2.0"
 	}
 }

package/readme.md

@@ -0,0 +1,278 @@
+<div align="right">
+<img src="files/logo-light.svg#gh-light-mode-only" alt="rian light mode logo" width="200px">
+<img src="files/logo-dark.svg#gh-dark-mode-only" alt="rian dark mode logo" width="200px">
+<br />
+<br />
+
+<p><code>npm add rian</code> doesn't overcomplicate tracing</p>
+<span>
+<a href="https://github.com/maraisr/rian/actions/workflows/ci.yml">
+	<img src="https://github.com/maraisr/rian/actions/workflows/ci.yml/badge.svg"/>
+</a>
+<a href="https://npm-stat.com/charts.html?package=rian">
+	<img src="https://badgen.net/npm/dw/rian?labelColor=black&color=black&cache=600" alt="downloads"/>
+</a>
+<a href="https://packagephobia.com/result?p=rian">
+	<img src="https://badgen.net/packagephobia/install/rian?labelColor=black&color=black" alt="size"/>
+</a>
+<a href="https://bundlephobia.com/result?p=rian">
+	<img src="https://badgen.net/bundlephobia/minzip/rian?labelColor=black&color=black" alt="size"/>
+</a>
+</span>
+
+<br />
+<br />
+</div>
+
+## ⚡ Features
+
+- 🤔 **Familiar** — looks very much like OpenTracing.
+
+- ✅ **Simple** — `create` a tracer, and `.end()` a tracer, done.
+
+- 🏎 **Performant** — check the [benchmarks](#-benchmark).
+
+- 🪶 **Lightweight** — a mere 1Kb and next to no [dependencies](https://npm.anvaka.com/#/view/2d/rian/).
+
+## 🚀 Usage
+
+> Visit [/examples](/examples) for more info!
+
+```ts
+import { create } from 'rian';
+import { measure } from 'rian/utils';
+import { exporter } from 'rian/exporter.otel.http';
+
+// ~> Where to send the spans.
+const otel_endpoint = exporter((payload) =>
+  fetch('/traces/otlp', {
+    method: 'POST',
+    body: JSON.stringify(payload),
+  }),
+);
+
+// ~> Create a tracer — typically "per request" or "per operation"
+const tracer = create('GET ~> /data', {
+  exporter: otel_endpoint,
+});
+
+// Let us trace
+
+tracer.set_context({
+  user: request_context.user_id,
+});
+
+// ~> Wrap any method and be timed 🕺🏻
+const data = await measure(tracer.fork('db::read'), get_data);
+
+// ~> Maybe have some in-flow spanning
+const span = tracer.span('process records');
+
+for (let row of data) {
+  span.add_event('doing stuff', { id: row.id });
+  do_stuff(row);
+}
+
+span.end();
+
+// ~> And finally let's export — will also end the root span.
+await tracer.end();
+
+/*
+And we end up with something like this in our reporting tool:
+
+[ GET ~> /data .................................... (1.2ms) ]
+   [ db::read .... (0.5ms) ]
+                           [ process records .... (0.5ms) ]
+ */
+```
+
+## 🔎 API
+
+#### Module: [`rian`](./packages/rian/src/index.ts)
+
+The main and _default_ module responsible for creating and provisioning spans.
+
+> 💡 Note ~> when providing span context values, please stick to
+> [Semantic Conventions](https://github.com/opentracing/specification/blob/master/semantic_conventions.md), but won't be
+> enforced.
+
+#### Module: [`rian/exporter.zipkin`](./packages/rian/src/exporter.zipkin.ts)
+
+Exports the spans created using the zipkin protocol and leaves the shipping up to you.
+
+> 💡 Note ~> with the nature of zipkin, the `localEndpoint` must be set in your span context.
+>
+> <details><summary>Example</summary>
+>
+> ```ts
+> const tracer = create('example', {
+>   context: {
+>     localEndpoint: {
+>       serviceName: 'my-service', // 👈 important part
+>     },
+>   },
+> });
+> ```
+>
+> Both of these are functionally equivalent. `service.name` will be used if no `localEndpoint.serviceName` is set.
+>
+> ```ts
+> const tracer = create('example', {
+>   context: {
+>     'service.name': 'my-service',
+>   },
+> });
+> ```
+>
+> </details>
+
+#### Module: [`rian/exporter.otel.http`](./packages/rian/src/exporter.otel.http.ts)
+
+Implements the OpenTelemetry protocol for use with http transports.
+
+> 💡 Note ~> services require a `service.name` context value.
+>
+> <details><summary>Example</summary>
+>
+> ```ts
+> const tracer = create('example', {
+>   context: {
+>     'service.name': 'my-service', // 👈 important part
+>   },
+> });
+> ```
+>
+> </details>
+
+## 🧑‍🍳 Exporter Recipes
+
+<details><summary>NewRelic</summary>
+
+```ts
+import { create } from 'rian';
+import { exporter } from 'rian/exporter.zipkin';
+
+const newrelic = exporter((payload) =>
+  fetch('https://trace-api.newrelic.com/trace/v1', {
+    method: 'POST',
+    headers: {
+      'api-key': '<your api key>',
+      'content-type': 'application/json',
+      'data-format': 'zipkin',
+      'data-format-version': '2',
+    },
+    body: JSON.stringify(payload),
+  }),
+);
+
+const tracer = create('example', {
+  context: {
+    'service.name': 'my-service', // 👈 important part
+  },
+  exporter: newrelic,
+});
+```
+
+[learn more](https://docs.newrelic.com/docs/distributed-tracing/trace-api/introduction-trace-api/)
+
+</details>
+
+<details><summary>LightStep</summary>
+
+```ts
+import { create } from 'rian';
+import { exporter } from 'rian/exporter.otel.http';
+
+const lightstep = exporter((payload) =>
+  fetch('https://ingest.lightstep.com/traces/otlp/v0.6', {
+    method: 'POST',
+    headers: {
+      'lightstep-access-token': '<your api key>',
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(payload),
+  }),
+);
+
+const tracer = create('example', {
+  context: {
+    'service.name': 'my-service', // 👈 important part
+  },
+  exporter: lightstep,
+});
+```
+
+[learn more](https://opentelemetry.lightstep.com/tracing/)
+
+</details>
+
+## 🤔 Motivation
+
+Firstly, what is `rian`? _trace_ in Irish is `rian`.
+
+In efforts to be better observant citizens, we generally reach for the — NewRelic, LightStep, DataDog's. Which, and in
+no offence to them, is bloated and slow! Where they more often than not do way too much or and relatively speaking, ship
+useless traces. Which ramp up your bill — see... every span you trace, costs.
+
+And here we are, introducing **rian** — a lightweight, fast effective tracer. Inspired by the giants in the industry,
+OpenTracing and OpenTelemetry.
+
+You might have not heard of those before — and that is okay. It means the design goals from OpenTelemetry or OpenTracing
+has been met. They are frameworks built to abstract the telemetry part from vendors. So folk like NewRelic can wrap
+their layers on top of open telemetry — and have libraries instrument theirs without knowing about the vendor. Which
+allows consumers to ship those spans to the vendor of their choosing. OpenTracing has a very similar design goal, so
+please do go checkout their documentation's, to help decide.
+
+Rian does not intend to align or compete with them. rian's intent is to be used to instrument your application and
+**only** your application. Rian is primed in that critical business paths — where you don't care " which handlers
+MongoDB ran", or how many network calls your ORM made. Cardinality will destroy you. Although rian can scale to support
+those as well. But the reality is; there are profiler tools far more capable — "right tool for the job".
+
+Rian is simply a tracer you can use to see what your application is doing, have better insight into why something failed
+and stitch it with your logs. It starts by capturing a [`w3c trace-context`](https://www.w3.org/TR/trace-context/),
+tracing some business steps. "inbound request /data", "getting data", "sending email", or as granular as you'd like. And
+have that forwarded onto all sub-services.
+
+You see, the primary design goal is targeted at edge or service workers — where lean quick tracers is favoured.
+
+Rian is still in active development, but ready for production!
+
+## 💨 Benchmark
+
+> via the [`/bench`](/bench) directory with Node v17.2.0
+
+```
+Validation :: single span
+✔ rian
+✔ opentelemetry
+✔ opentracing
+
+Benchmark :: single span
+  rian                   x 137,181 ops/sec ±2.82% (82 runs sampled)
+  opentelemetry          x 114,197 ops/sec ±11.37% (75 runs sampled)
+  opentracing            x  33,363 ops/sec ±1.27% (89 runs sampled)
+
+Validation :: child span
+✔ rian
+✔ opentelemetry
+✔ opentracing
+
+Benchmark :: child span
+  rian                   x 75,567 ops/sec ±7.95% (77 runs sampled)
+  opentelemetry          x 65,618 ops/sec ±8.45% (82 runs sampled)
+  opentracing            x 15,452 ops/sec ±15.35% (77 runs sampled)
+
+```
+
+> And please... I know these results are anything but the full story. But it's a number and point on comparison.
+
+## License
+
+MIT © [Marais Rossouw](https://marais.io)
+
+##### Disclaimer
+
+<sup>- NewRelic is a registered trademark of https://newrelic.com/ and not affiliated with this project.</sup><br />
+<sup>- DataDog is a registered trademark of https://www.datadoghq.com/ and not affiliated with this project.</sup><br />
+<sup>- LightStep is a registered trademark of https://lightstep.com/ and not affiliated with this project.</sup>

package/utils/index.js

@@ -1,30 +1 @@
-// src/utils.ts
-const { ADD_PROMISE, PROMISES } = require('rian');
-var measureFn = (scope, fn, ...args) => {
-  try {
-    var r = fn(...args, scope), is_promise = r instanceof Promise;
-    if (is_promise && !PROMISES.has(scope))
-      ADD_PROMISE(scope, r.catch((e) => void scope.set_context({
-        error: e
-      })).finally(() => scope.end()));
-    return r;
-  } catch (e) {
-    if (e instanceof Error)
-      scope.set_context({
-        error: e
-      });
-    throw e;
-  } finally {
-    if (is_promise !== true)
-      scope.end();
-  }
-};
-var measure = (scope, name, fn, ...args) => measureFn(scope.fork(name), fn, ...args);
-var wrap = (scope, name, fn) => function() {
-  return measureFn(scope.fork(name), fn, ...arguments);
-};
-
-
-exports.measure = measure;
-exports.measureFn = measureFn;
-exports.wrap = wrap;
+var r=(r,t,...e)=>{try{var n=t(...e,r),o=n instanceof Promise;return o&&r.__add_promise(n.catch((t=>{r.set_context({error:t})})).finally((()=>r.end()))),n}catch(t){throw t instanceof Error&&r.set_context({error:t}),t}finally{!0!==o&&r.end()}},t=(t,e,n,...o)=>r(t.fork(e),n,...o),e=(t,e,n)=>function(){return r(t.fork(e),n,...arguments)};exports.measure=t;exports.measureFn=r;exports.wrap=e;

package/utils/index.mjs

@@ -1,30 +1 @@
-// src/utils.ts
-import { ADD_PROMISE, PROMISES } from "rian";
-var measureFn = (scope, fn, ...args) => {
-  try {
-    var r = fn(...args, scope), is_promise = r instanceof Promise;
-    if (is_promise && !PROMISES.has(scope))
-      ADD_PROMISE(scope, r.catch((e) => void scope.set_context({
-        error: e
-      })).finally(() => scope.end()));
-    return r;
-  } catch (e) {
-    if (e instanceof Error)
-      scope.set_context({
-        error: e
-      });
-    throw e;
-  } finally {
-    if (is_promise !== true)
-      scope.end();
-  }
-};
-var measure = (scope, name, fn, ...args) => measureFn(scope.fork(name), fn, ...args);
-var wrap = (scope, name, fn) => function() {
-  return measureFn(scope.fork(name), fn, ...arguments);
-};
-export {
-  measure,
-  measureFn,
-  wrap
-};
+var r=(r,t,...e)=>{try{var n=t(...e,r),o=n instanceof Promise;return o&&r.__add_promise(n.catch((t=>{r.set_context({error:t})})).finally((()=>r.end()))),n}catch(t){throw t instanceof Error&&r.set_context({error:t}),t}finally{!0!==o&&r.end()}},t=(t,e,n,...o)=>r(t.fork(e),n,...o),e=(t,e,n)=>function(){return r(t.fork(e),n,...arguments)};export{t as measure,r as measureFn,e as wrap};