@qlever-llc/trellis 0.7.0 → 0.8.0-rc.3

package/esm/npm/src/telemetry/core.js

@@ -0,0 +1,14 @@
+import { context, SpanKind, SpanStatusCode, trace, } from "@opentelemetry/api";
+export function getTracer(scope = "@qlever-llc/trellis/tracing") {
+    return trace.getTracer(scope);
+}
+export function getActiveSpan() {
+    return trace.getActiveSpan();
+}
+export function withSpan(span, fn) {
+    return context.with(trace.setSpan(context.active(), span), fn);
+}
+export async function withSpanAsync(span, fn) {
+    return context.with(trace.setSpan(context.active(), span), fn);
+}
+export { context, SpanKind, SpanStatusCode, trace };

package/esm/npm/src/telemetry/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/env.ts"],"names":[],"mappings":"AAYA,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUtD"}

package/esm/npm/src/telemetry/env.js

@@ -0,0 +1,10 @@
+import * as dntShim from "../_dnt.shims.js";
+// Shared telemetry code needs environment access without assuming Deno or Node.
+export function getEnv(key) {
+    const deno = dntShim.dntGlobalThis;
+    if (deno.Deno?.env?.get) {
+        return deno.Deno.env.get(key);
+    }
+    const processGlobal = dntShim.dntGlobalThis;
+    return processGlobal.process?.env?.[key];
+}

package/esm/npm/src/telemetry/mod.d.ts

@@ -0,0 +1,10 @@
+export type { HeaderCarrier } from "./carrier.js";
+export { createMapCarrier, extractTraceContext, injectTraceContext, } from "./carrier.js";
+export type { Context, Span } from "./core.js";
+export { context, getActiveSpan, getTracer, SpanKind, SpanStatusCode, trace, withSpan, withSpanAsync, } from "./core.js";
+export { getEnv } from "./env.js";
+export type { NatsHeadersLike } from "./nats.js";
+export { createNatsHeaderCarrier } from "./nats.js";
+export { configureErrorTraceId } from "./result.js";
+export { getTrellisTracer, startClientSpan, startServerSpan, } from "./trellis.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/npm/src/telemetry/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/mod.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,aAAa,EACb,SAAS,EACT,QAAQ,EACR,cAAc,EACd,KAAK,EACL,QAAQ,EACR,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/esm/npm/src/telemetry/mod.js

@@ -0,0 +1,6 @@
+export { createMapCarrier, extractTraceContext, injectTraceContext, } from "./carrier.js";
+export { context, getActiveSpan, getTracer, SpanKind, SpanStatusCode, trace, withSpan, withSpanAsync, } from "./core.js";
+export { getEnv } from "./env.js";
+export { createNatsHeaderCarrier } from "./nats.js";
+export { configureErrorTraceId } from "./result.js";
+export { getTrellisTracer, startClientSpan, startServerSpan, } from "./trellis.js";

package/esm/npm/src/telemetry/nats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/nats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,aAAa,CAKf"}

package/esm/npm/src/telemetry/nats.js

@@ -0,0 +1,6 @@
+export function createNatsHeaderCarrier(headers) {
+    return {
+        get: (key) => headers.get(key),
+        set: (key, value) => headers.set(key, value),
+    };
+}

package/esm/npm/src/telemetry/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/result.ts"],"names":[],"mappings":"AAKA,wBAAgB,qBAAqB,IAAI,IAAI,CAc5C"}

package/esm/npm/src/telemetry/result.js

@@ -0,0 +1,18 @@
+import { trace } from "@opentelemetry/api";
+import { BaseError } from "@qlever-llc/result";
+let traceIdGetterConfigured = false;
+export function configureErrorTraceId() {
+    if (traceIdGetterConfigured)
+        return;
+    traceIdGetterConfigured = true;
+    BaseError.traceIdGetter = () => {
+        const span = trace.getActiveSpan();
+        if (!span)
+            return undefined;
+        const spanContext = span.spanContext();
+        if (spanContext.traceId === "00000000000000000000000000000000") {
+            return undefined;
+        }
+        return spanContext.traceId;
+    };
+}

package/esm/npm/src/telemetry/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAMxD,wBAAgB,gBAAgB,wCAE/B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASrE;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,OAAO,GACtB,IAAI,CAaN"}

package/esm/npm/src/telemetry/trace.js

@@ -0,0 +1,26 @@
+import { SpanKind } from "@opentelemetry/api";
+import { getTracer } from "./core.js";
+const TRELLIS_INSTRUMENTATION_SCOPE = "@qlever-llc/trellis";
+export function getTrellisTracer() {
+    return getTracer(TRELLIS_INSTRUMENTATION_SCOPE);
+}
+export function startClientSpan(method, subject) {
+    return getTrellisTracer().startSpan(`rpc.client.${method}`, {
+        kind: SpanKind.CLIENT,
+        attributes: {
+            "rpc.system": "nats",
+            "rpc.method": method,
+            "messaging.destination": subject,
+        },
+    });
+}
+export function startServerSpan(method, subject, parentContext) {
+    return getTrellisTracer().startSpan(`rpc.server.${method}`, {
+        kind: SpanKind.SERVER,
+        attributes: {
+            "rpc.system": "nats",
+            "rpc.method": method,
+            "messaging.destination": subject,
+        },
+    }, parentContext);
+}

package/esm/npm/src/telemetry/trellis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trellis.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/trellis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/esm/npm/src/telemetry/trellis.js

@@ -0,0 +1 @@
+export { getTrellisTracer, startClientSpan, startServerSpan } from "./trace.js";

package/esm/npm/src/tracing.d.ts

@@ -0,0 +1,5 @@
+import "./_dnt.polyfills.js";
+export type { HeaderCarrier, NatsHeadersLike } from "./telemetry/mod.js";
+export { configureErrorTraceId, context, createMapCarrier, createNatsHeaderCarrier, extractTraceContext, getActiveSpan, getTrellisTracer as getTracer, injectTraceContext, SpanKind, SpanStatusCode, startClientSpan, startServerSpan, trace, withSpan, withSpanAsync, } from "./telemetry/mod.js";
+export declare function initTracing(serviceName: string): void;
+//# sourceMappingURL=tracing.d.ts.map

package/esm/npm/src/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/tracing.ts"],"names":[],"mappings":"AAEA,OAAO,qBAAqB,CAAC;AAE7B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EACL,qBAAqB,EACrB,OAAO,EACP,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,IAAI,SAAS,EAC7B,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAKrD"}

package/esm/npm/src/tracing.js

@@ -0,0 +1,8 @@
+// Keep this subpath for Trellis-specific tracing convenience without exposing
+// telemetry from the root `@qlever-llc/trellis` package surface.
+import "./_dnt.polyfills.js";
+export { configureErrorTraceId, context, createMapCarrier, createNatsHeaderCarrier, extractTraceContext, getActiveSpan, getTrellisTracer as getTracer, injectTraceContext, SpanKind, SpanStatusCode, startClientSpan, startServerSpan, trace, withSpan, withSpanAsync, } from "./telemetry/mod.js";
+export function initTracing(serviceName) {
+    const load = new Function("specifier", "return import(specifier);");
+    void load("./telemetry/init.js").then((mod) => mod.initTracing(serviceName));
+}

package/esm/npm/src/transfer.d.ts

@@ -0,0 +1,115 @@
+import { AsyncResult, type Result as ResultType } from "@qlever-llc/result";
+import { type MsgHdrs, type NatsConnection } from "@nats-io/nats-core";
+import Type, { type Static } from "typebox";
+import { TransferError } from "./errors/TransferError.js";
+export declare const FileInfoSchema: Type.TObject<{
+    key: Type.TString;
+    size: Type.TInteger;
+    updatedAt: Type.TString;
+    digest: Type.TOptional<Type.TString>;
+    contentType: Type.TOptional<Type.TString>;
+    metadata: Type.TRecord<"^.*$", Type.TString>;
+}>;
+export type FileInfo = Static<typeof FileInfoSchema>;
+export declare const SendTransferGrantSchema: Type.TObject<{
+    direction: Type.TLiteral<"send">;
+    maxBytes: Type.TOptional<Type.TInteger>;
+    contentType: Type.TOptional<Type.TString>;
+    metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+    type: Type.TLiteral<"TransferGrant">;
+    service: Type.TString;
+    sessionKey: Type.TString;
+    transferId: Type.TString;
+    subject: Type.TString;
+    expiresAt: Type.TString;
+    chunkBytes: Type.TInteger;
+}>;
+export declare const ReceiveTransferGrantSchema: Type.TObject<{
+    direction: Type.TLiteral<"receive">;
+    info: Type.TObject<{
+        key: Type.TString;
+        size: Type.TInteger;
+        updatedAt: Type.TString;
+        digest: Type.TOptional<Type.TString>;
+        contentType: Type.TOptional<Type.TString>;
+        metadata: Type.TRecord<"^.*$", Type.TString>;
+    }>;
+    type: Type.TLiteral<"TransferGrant">;
+    service: Type.TString;
+    sessionKey: Type.TString;
+    transferId: Type.TString;
+    subject: Type.TString;
+    expiresAt: Type.TString;
+    chunkBytes: Type.TInteger;
+}>;
+export declare const TransferGrantSchema: Type.TUnion<[Type.TObject<{
+    direction: Type.TLiteral<"send">;
+    maxBytes: Type.TOptional<Type.TInteger>;
+    contentType: Type.TOptional<Type.TString>;
+    metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+    type: Type.TLiteral<"TransferGrant">;
+    service: Type.TString;
+    sessionKey: Type.TString;
+    transferId: Type.TString;
+    subject: Type.TString;
+    expiresAt: Type.TString;
+    chunkBytes: Type.TInteger;
+}>, Type.TObject<{
+    direction: Type.TLiteral<"receive">;
+    info: Type.TObject<{
+        key: Type.TString;
+        size: Type.TInteger;
+        updatedAt: Type.TString;
+        digest: Type.TOptional<Type.TString>;
+        contentType: Type.TOptional<Type.TString>;
+        metadata: Type.TRecord<"^.*$", Type.TString>;
+    }>;
+    type: Type.TLiteral<"TransferGrant">;
+    service: Type.TString;
+    sessionKey: Type.TString;
+    transferId: Type.TString;
+    subject: Type.TString;
+    expiresAt: Type.TString;
+    chunkBytes: Type.TInteger;
+}>]>;
+export type SendTransferGrant = Static<typeof SendTransferGrantSchema>;
+export type ReceiveTransferGrant = Static<typeof ReceiveTransferGrantSchema>;
+export type TransferGrant = Static<typeof TransferGrantSchema>;
+export type TransferBody = Uint8Array | ArrayBuffer | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+type TrellisTransferAuth = {
+    sessionKey: string;
+    sign(data: Uint8Array): Promise<Uint8Array> | Uint8Array;
+};
+declare class BaseTransferHandle {
+    #private;
+    protected constructor(nc: NatsConnection, auth: TrellisTransferAuth, timeoutMs: number);
+    protected get nc(): NatsConnection;
+    protected get auth(): TrellisTransferAuth;
+    protected get timeoutMs(): number;
+    protected validateGrant(grant: TransferGrant, operation: string): ResultType<void, TransferError>;
+    protected buildHeaders(subject: string, payload: Uint8Array, seq?: number, eof?: boolean): Promise<MsgHdrs>;
+}
+export declare class SendTransferHandle extends BaseTransferHandle {
+    #private;
+    constructor(nc: NatsConnection, auth: TrellisTransferAuth, timeoutMs: number, grant: SendTransferGrant);
+    send(body: TransferBody): AsyncResult<FileInfo, TransferError>;
+}
+export declare class ReceiveTransferHandle extends BaseTransferHandle {
+    #private;
+    constructor(nc: NatsConnection, auth: TrellisTransferAuth, timeoutMs: number, grant: ReceiveTransferGrant);
+    stream(): AsyncResult<ReadableStream<Uint8Array>, TransferError>;
+    bytes(): AsyncResult<Uint8Array, TransferError>;
+}
+export type TransferHandle = SendTransferHandle | ReceiveTransferHandle;
+export declare function createTransferHandle(nc: NatsConnection, auth: TrellisTransferAuth, timeoutMs: number, grant: SendTransferGrant): SendTransferHandle;
+export declare function createTransferHandle(nc: NatsConnection, auth: TrellisTransferAuth, timeoutMs: number, grant: ReceiveTransferGrant): ReceiveTransferHandle;
+export declare function createTransferHandle(nc: NatsConnection, auth: TrellisTransferAuth, timeoutMs: number, grant: TransferGrant): TransferHandle;
+export declare function verifyTransferMessage(args: {
+    expectedSessionKey: string;
+    subject: string;
+    payload: Uint8Array;
+    proof?: string | null;
+    sessionKey?: string | null;
+}): Promise<boolean>;
+export {};
+//# sourceMappingURL=transfer.d.ts.map

package/esm/npm/src/transfer.d.ts.map

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