@dxos/context 0.8.4-main.fffef41 → 0.8.4-staging.ac66bdf99f

package/dist/types/src/context.d.ts

@@ -2,7 +2,7 @@ import { inspect } from 'node:util';
 import { type CallMetadata } from '@dxos/log';
 export type ContextErrorHandler = (error: Error, ctx: Context) => void;
 export type DisposeCallback = () => any | Promise<any>;
-export type CreateContextParams = {
+export type CreateContextProps = {
     name?: string;
     parent?: Context;
     attributes?: Record<string, any>;
@@ -15,9 +15,10 @@ export declare class Context {
     #private;
     static default(): Context;
     maxSafeDisposeCallbacks: number;
-    constructor(params?: CreateContextParams, callMeta?: Partial<CallMetadata>);
+    constructor(params?: CreateContextProps, callMeta?: Partial<CallMetadata>);
     get disposed(): boolean;
     get disposeCallbacksLength(): number;
+    get signal(): AbortSignal;
     /**
      * Schedules a callback to run when the context is disposed.
      * May be async, in this case the disposer might choose to wait for all resource to released.
@@ -43,7 +44,7 @@ export declare class Context {
      * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.
      */
     raise(error: Error): void;
-    derive({ onError, attributes }?: CreateContextParams): Context;
+    derive({ onError, attributes }?: CreateContextProps): Context;
     getAttribute(key: string): any;
     [Symbol.toStringTag]: string;
     [inspect.custom]: () => string;

package/dist/types/src/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,WAAW,CAAC;AAKnD,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AA6BF;;GAEG;AACH,qBACa,OAAO;;IAClB,MAAM,CAAC,OAAO,IAAI,OAAO;IAclB,uBAAuB,SAA8B;gBAEhD,MAAM,GAAE,mBAAwB,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAuB9E,IAAI,QAAQ,YAEX;IAED,IAAI,sBAAsB,WAEzB;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAgChD;;;;;;;OAOG;IACG,OAAO,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAqDrD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAezB,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAE,mBAAwB,GAAG,OAAO;IAsBlE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAW9B,CAAC,MAAM,CAAC,WAAW,CAAC,SAAa;IACjC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAyB;IAEzC,QAAQ,IAAI,MAAM;IAIZ,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,WAAW,CAAC;AAKnD,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AA6BF;;GAEG;AACH,qBACa,OAAO;;IAClB,MAAM,CAAC,OAAO,IAAI,OAAO;IAgBlB,uBAAuB,SAA8B;gBAEhD,MAAM,GAAE,kBAAuB,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAuB7E,IAAI,QAAQ,YAEX;IAED,IAAI,sBAAsB,WAEzB;IAED,IAAI,MAAM,IAAI,WAAW,CAQxB;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAgChD;;;;;;;OAOG;IACG,OAAO,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAqDrD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAezB,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAE,kBAAuB,GAAG,OAAO;IAuBjE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAW9B,CAAC,MAAM,CAAC,WAAW,CAAC,SAAa;IACjC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAyB;IAEzC,QAAQ,IAAI,MAAM;IAIZ,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/types/src/index.d.ts

@@ -2,4 +2,5 @@ export * from './context';
 export * from './context-disposed-error';
 export * from './promise-utils';
 export * from './resource';
+export * from './trace-context';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/types/src/resource.d.ts

@@ -1,3 +1,4 @@
+import '@hazae41/symbol-dispose-polyfill';
 import { Context } from './context';
 export declare enum LifecycleState {
     CLOSED = "CLOSED",

package/dist/types/src/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/resource.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CAC9B;AAKD;;GAEG;AACH,8BAAsB,QAAS,YAAW,SAAS;;IAkBjD;;;;;;OAMG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C,IAAI,MAAM,YAET;IAED,SAAS,KAAK,eAAe,mBAE5B;IAED,SAAS,KAAK,IAAI,YAEjB;IAED;;OAEG;cACa,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD;;OAEG;cACa,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD;;;OAGG;cACa,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD;;;;OAIG;IACG,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS5D;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxC;;;OAGG;IACG,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CA+CrC;AAED,eAAO,MAAM,aAAa,GAAU,CAAC,SAAS,SAAS,EAAE,KAAK,OAAO,EAAE,UAAU,CAAC,KAAG,OAAO,CAAC,CAAC,CAI7F,CAAC"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/resource.ts"],"names":[],"mappings":"AAIA,OAAO,kCAAkC,CAAC;AAI1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CAC9B;AAKD;;GAEG;AACH,8BAAsB,QAAS,YAAW,SAAS;;IAmBjD;;;;;;OAMG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C,IAAI,MAAM,YAET;IAED,SAAS,KAAK,eAAe,mBAE5B;IAED,SAAS,KAAK,IAAI,YAEjB;IAED;;OAEG;cACa,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD;;OAEG;cACa,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD;;;OAGG;cACa,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD;;;;OAIG;IACG,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS5D;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxC;;;OAGG;IACG,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAiDrC;AAED,eAAO,MAAM,aAAa,GAAU,CAAC,SAAS,SAAS,EAAE,KAAK,OAAO,EAAE,UAAU,CAAC,KAAG,OAAO,CAAC,CAAC,CAI7F,CAAC"}

package/dist/types/src/trace-context.d.ts

@@ -0,0 +1,54 @@
+import { Context } from './context';
+/**
+ * Context attribute key for trace context data.
+ * Stores {@link TraceContextData} (W3C traceparent/tracestate strings).
+ */
+export declare const TRACE_SPAN_ATTRIBUTE = "dxos.trace-span";
+/**
+ * W3C Trace Context wire format for propagating trace identity.
+ * Stored on DXOS {@link Context} attributes and carried across RPC boundaries.
+ *
+ * Because these are plain strings (not live runtime objects), they remain valid
+ * after the originating span ends — enabling long-lived contexts (`this._ctx`)
+ * to serve as parents for later child spans without a retention cache.
+ *
+ * @see https://www.w3.org/TR/trace-context/
+ */
+export type TraceContextData = {
+    /**
+     * W3C `traceparent` header value.
+     * Format: `{version}-{traceId}-{spanId}-{traceFlags}` (e.g., `00-abc...def-012...789-01`).
+     */
+    traceparent: string;
+    /** Optional W3C `tracestate` header value carrying vendor-specific trace data. */
+    tracestate?: string;
+};
+/**
+ * Codec for propagating trace identity across RPC boundaries.
+ *
+ * Hardcoded in `RpcPeer` — every outgoing request calls {@link encode} to
+ * extract W3C trace context from the DXOS `Context`, and every incoming
+ * request calls {@link decode} to reconstruct a DXOS `Context` carrying the
+ * caller's trace context.
+ *
+ * This works because `TRACE_SPAN_ATTRIBUTE` stores serializable
+ * {@link TraceContextData} strings, not opaque runtime objects.
+ */
+export declare class ContextRpcCodec {
+    /**
+     * Read the W3C trace context from a DXOS `Context` for an outgoing RPC.
+     *
+     * @returns `TraceContextData` to attach to the wire message, or `undefined`
+     *          if the context has no active trace.
+     */
+    static encode(ctx: Context): TraceContextData | undefined;
+    /**
+     * Reconstruct a DXOS `Context` from W3C trace context received in an
+     * incoming RPC request.
+     *
+     * @returns A `Context` carrying the trace context, or `Context.default()`
+     *          if the data is missing/invalid.
+     */
+    static decode(traceContext: TraceContextData): Context;
+}
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/types/src/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../../../src/trace-context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS;IAQzD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO;CAMvD"}