@beignet/core 0.0.3 → 0.0.4

package/src/tracing/index.ts

@@ -0,0 +1,176 @@
+/**
+ * @beignet/core/tracing
+ *
+ * W3C trace context primitives used to correlate Beignet activity across
+ * requests, use cases, providers, and instrumentation sinks.
+ *
+ * This module is dependency-free so client bundles that import app context
+ * types stay clean.
+ */
+
+const TRACEPARENT_PATTERN = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+
+/**
+ * Trace context used to correlate related activity.
+ */
+export interface TraceContext {
+  /**
+   * W3C trace ID.
+   */
+  traceId: string;
+  /**
+   * Current span ID.
+   */
+  spanId: string;
+  /**
+   * Parent span ID when available.
+   */
+  parentSpanId?: string;
+  /**
+   * W3C traceparent header value.
+   */
+  traceparent: string;
+}
+
+/**
+ * Parsed W3C traceparent header.
+ */
+export interface ParsedTraceparent {
+  /**
+   * W3C trace ID.
+   */
+  traceId: string;
+  /**
+   * Span ID from the traceparent header.
+   */
+  spanId: string;
+  /**
+   * Trace flags from the traceparent header.
+   */
+  traceFlags: string;
+  /**
+   * Normalized traceparent header value.
+   */
+  traceparent: string;
+}
+
+/**
+ * Input accepted when creating trace context.
+ */
+export interface TraceContextInput {
+  traceId?: string;
+  spanId?: string;
+  parentSpanId?: string;
+  traceparent?: string;
+}
+
+function createHexId(length: number): string {
+  const bytes = new Uint8Array(length / 2);
+  if (typeof crypto !== "undefined" && "getRandomValues" in crypto) {
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join(
+      "",
+    );
+  }
+
+  let value = "";
+  while (value.length < length) {
+    value += Math.floor(Math.random() * 16).toString(16);
+  }
+  return value.slice(0, length);
+}
+
+function isNonZeroHex(value: string): boolean {
+  return !/^0+$/.test(value);
+}
+
+/**
+ * Create a non-zero W3C trace ID.
+ */
+export function createTraceId(): string {
+  let traceId = createHexId(32);
+  while (!isNonZeroHex(traceId)) {
+    traceId = createHexId(32);
+  }
+  return traceId;
+}
+
+/**
+ * Create a non-zero W3C span ID.
+ */
+export function createSpanId(): string {
+  let spanId = createHexId(16);
+  while (!isNonZeroHex(spanId)) {
+    spanId = createHexId(16);
+  }
+  return spanId;
+}
+
+/**
+ * Create a W3C traceparent header value.
+ */
+export function createTraceparent(args: {
+  traceId: string;
+  spanId: string;
+  traceFlags?: string;
+}): string {
+  return `00-${args.traceId}-${args.spanId}-${args.traceFlags ?? "01"}`;
+}
+
+/**
+ * Parse and validate a W3C traceparent header value.
+ */
+export function parseTraceparent(
+  value: string | null | undefined,
+): ParsedTraceparent | undefined {
+  if (!value) return undefined;
+  const normalized = value.trim().toLowerCase();
+  const match = TRACEPARENT_PATTERN.exec(normalized);
+  if (!match) return undefined;
+
+  const [, traceId, spanId, traceFlags] = match;
+  if (!isNonZeroHex(traceId) || !isNonZeroHex(spanId)) return undefined;
+
+  return {
+    traceId,
+    spanId,
+    traceFlags,
+    traceparent: normalized,
+  };
+}
+
+/**
+ * Create trace context from explicit IDs or an existing traceparent.
+ */
+export function createTraceContext(
+  input: TraceContextInput = {},
+): TraceContext {
+  const parsed = parseTraceparent(input.traceparent);
+  const traceId = input.traceId ?? parsed?.traceId ?? createTraceId();
+  const parentSpanId = input.parentSpanId ?? parsed?.spanId;
+  const spanId = input.spanId ?? createSpanId();
+
+  return {
+    traceId,
+    spanId,
+    ...(parentSpanId ? { parentSpanId } : {}),
+    traceparent: createTraceparent({
+      traceId,
+      spanId,
+      traceFlags: parsed?.traceFlags,
+    }),
+  };
+}
+
+/**
+ * Create child trace context from a parent context.
+ */
+export function createChildTraceContext(
+  parent: TraceContextInput,
+): TraceContext {
+  return createTraceContext({
+    traceId: parent.traceId,
+    parentSpanId: parent.spanId,
+    traceparent: parent.traceparent,
+  });
+}

package/src/uploads/client.ts

@@ -11,7 +11,7 @@ import type {
   UploadFromRegistry,
   UploadManifestEntry,
   UploadRegistry,
-} from "./index";
+} from "./index.js";
 
 /**
  * Upload registry shape accepted by the typed browser client.

package/src/uploads/index.ts

@@ -1,7 +1,11 @@
 import type { StandardSchemaV1 } from "@standard-schema/spec";
-import type { StorageMetadata, StorageObject, StoragePort } from "../ports";
-import type { ProviderInstrumentationTarget } from "../providers";
-import { createProviderInstrumentation } from "../providers";
+import type {
+  StorageMetadata,
+  StorageObject,
+  StoragePort,
+} from "../ports/index.js";
+import type { ProviderInstrumentationTarget } from "../providers/index.js";
+import { createProviderInstrumentation } from "../providers/index.js";
 
 /**
  * Any Standard Schema compatible validator.

package/dist/ports/mailer.d.ts

@@ -1,6 +0,0 @@
-/**
- * Re-export app-facing mail port types for apps that centralize outbound
- * dependencies through @beignet/core/ports.
- */
-export type { MailAddress, MailAddressList, MailerPort, MemoryMailDelivery, MemoryMailerPort, NormalizedMailMessage, SendMailOptions, SendMailResult, } from "../mail";
-//# sourceMappingURL=mailer.d.ts.map

package/dist/ports/mailer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mailer.d.ts","sourceRoot":"","sources":["../../src/ports/mailer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/ports/mailer.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=mailer.js.map

package/dist/ports/mailer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mailer.js","sourceRoot":"","sources":["../../src/ports/mailer.ts"],"names":[],"mappings":""}

package/dist/ports/schedules.d.ts

@@ -1,9 +0,0 @@
-/**
- * Re-export app-facing schedule runner port types for apps that centralize outbound
- * dependencies through @beignet/core/ports.
- *
- * Scheduled task definitions live in @beignet/core/schedules; this subpath
- * keeps the port shape available next to the rest of the app-facing ports.
- */
-export type { InferSchedulePayload, InlineScheduleRunner, ScheduleDef, SchedulePayloadDef, ScheduleRunnerPort, StandardSchema as ScheduleStandardSchema, } from "../schedules";
-//# sourceMappingURL=schedules.d.ts.map

package/dist/ports/schedules.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/ports/schedules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,IAAI,sBAAsB,GACzC,MAAM,cAAc,CAAC"}

package/dist/ports/schedules.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=schedules.js.map

package/dist/ports/schedules.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../src/ports/schedules.ts"],"names":[],"mappings":""}