@mastra/auth-studio 1.3.4 → 1.3.5-alpha.1

package/README.md

@@ -0,0 +1,39 @@
+# @mastra/auth-studio
+
+`@mastra/auth-studio` provides authentication, organizations, and role-based access control for Studio deployments backed by the Mastra shared API. Use it when a self-hosted Studio should use Mastra's hosted identity and organization services.
+
+## Installation
+
+```bash
+npm install @mastra/auth-studio
+```
+
+## Usage
+
+Configure the shared API URL and organization for your Studio deployment.
+
+```typescript
+import { MastraAuthStudio } from '@mastra/auth-studio';
+import { Mastra } from '@mastra/core/mastra';
+
+export const mastra = new Mastra({
+  server: {
+    auth: new MastraAuthStudio({
+      sharedApiUrl: process.env.MASTRA_SHARED_API_URL,
+      organizationId: process.env.MASTRA_ORGANIZATION_ID,
+    }),
+  },
+});
+```
+
+## Documentation
+
+- [Studio authentication](https://mastra.ai/docs/studio/auth)
+
+## Changelog
+
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/auth/studio/CHANGELOG.md) for version history and release notes.
+
+## Support
+
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/_types/@internal_auth/dist/_types/@internal_core/dist/base/index.d.ts

@@ -1,4 +1,4 @@
-import { i as IMastraLogger, u as RegisteredLogger } from "../index-S1lgaKO7.js";
+import { i as IMastraLogger, u as RegisteredLogger } from "../index-Biaf3BmX.js";
 //#region src/base/MastraBase.d.ts
 declare class MastraBase {
   #private;

package/dist/_types/@internal_auth/dist/_types/@internal_core/dist/index-Biaf3BmX.d.ts

@@ -0,0 +1,319 @@
+import { Transform } from "stream";
+//#region src/logger/adapter.d.ts
+/**
+ * OpenTelemetry-compatible trace correlation fields, injected at the top
+ * level of a logger's native record.
+ *
+ * Field names are part of the platform contract (snake_case, W3C formats):
+ * external consumers (e.g. the Studio logs view reading Railway stdout)
+ * parse structured log lines and look for exactly these keys.
+ */
+interface TraceFields {
+  /** 32-char lowercase hex W3C trace id */
+  trace_id: string;
+  /**
+   * 16-char lowercase hex W3C span id.
+   *
+   * Optional, and omitted rather than emitted empty: the active span may be
+   * one observability never exports (an internal span, or one dropped by
+   * `excludeSpanTypes`), leaving no span id a consumer could look up. The
+   * trace is still addressable in that case, so the line keeps `trace_id` and
+   * drops only this field. Consumers must treat `span_id` as possibly absent.
+   */
+  span_id?: string;
+}
+/**
+ * Destination for log records derived from the logger's native record,
+ * exported to Mastra observability. Structurally compatible with
+ * `LoggerContext` from `@mastra/core/observability`.
+ */
+interface AdapterLogSink {
+  debug(message: string, data?: Record<string, unknown>): void;
+  info(message: string, data?: Record<string, unknown>): void;
+  warn(message: string, data?: Record<string, unknown>): void;
+  error(message: string, data?: Record<string, unknown>): void;
+}
+interface LoggerAdapterOptions {
+  /** Inject trace_id/span_id into the logger's native records. */
+  correlation: boolean;
+  /** Export records derived from the native record to Mastra observability. */
+  export: boolean;
+}
+/**
+ * Context handed to an adaptable logger by Mastra when observability is
+ * wired up. All members are safe to call on every log call (synchronous,
+ * never throw).
+ */
+interface LoggerAdapterContext {
+  /**
+   * Resolve correlation fields for the currently active span, or undefined
+   * when no span is active (in which case no trace fields are added).
+   */
+  resolveTraceFields: () => TraceFields | undefined;
+  /**
+   * Resolve the observability log sink at call time. Returns the
+   * span-correlated sink when a span is active, the global sink otherwise,
+   * and undefined when export is disabled or observability is not
+   * initialized. Records must still be written to the native destination
+   * regardless.
+   */
+  getLogSink: () => AdapterLogSink | undefined;
+  options: LoggerAdapterOptions;
+}
+/**
+ * Capability marker a logger implements to opt into native trace
+ * correlation and observability export. When a configured logger implements
+ * this, Mastra attaches observability directly instead of wrapping the
+ * logger in the deprecated `DualLogger`.
+ */
+interface AdaptableLogger extends IMastraLogger {
+  __attachObservability(ctx: LoggerAdapterContext): void;
+  /**
+   * Stable identity for the attachment target. Loggers whose adapter context
+   * lives in state shared across a root/child family (e.g. PinoLogger's
+   * mixin ref cell) return that shared object, so attaching any family
+   * member is recognized as re-attaching the whole family. Defaults to the
+   * logger instance itself when absent.
+   */
+  __observabilityAttachmentKey?(): object;
+}
+declare function isAdaptableLogger(logger: IMastraLogger): logger is AdaptableLogger;
+/**
+ * Export a tracked exception through the adapter sink, mirroring the
+ * DualLogger dual-write shape (`errorId`/`domain`/`category`/`details`/`cause`
+ * when present on a MastraError-like value). Never throws into the caller.
+ */
+declare function exportTrackedException(ctx: LoggerAdapterContext | undefined, error: Error, metadata?: Record<string, unknown>): void;
+/**
+ * Adapt IMastraLogger's variadic args into the structured `data` payload of
+ * an exported log record. Extracts the first plain object as data,
+ * serializes an Error arg, and collects remaining primitives under `args`
+ * so the derived record preserves all context from the native call.
+ */
+declare function buildLogRecordData(args: unknown[]): Record<string, unknown> | undefined;
+//#endregion
+//#region src/logger/index.d.ts
+declare const RegisteredLogger: {
+  readonly AGENT: 'AGENT';
+  readonly OBSERVABILITY: 'OBSERVABILITY';
+  readonly AUTH: 'AUTH';
+  readonly BROWSER: 'BROWSER';
+  readonly NETWORK: 'NETWORK';
+  readonly WORKFLOW: 'WORKFLOW';
+  readonly LLM: 'LLM';
+  readonly TTS: 'TTS';
+  readonly VOICE: 'VOICE';
+  readonly VECTOR: 'VECTOR';
+  readonly BUNDLER: 'BUNDLER';
+  readonly DEPLOYER: 'DEPLOYER';
+  readonly MEMORY: 'MEMORY';
+  readonly STORAGE: 'STORAGE';
+  readonly EMBEDDINGS: 'EMBEDDINGS';
+  readonly MCP_SERVER: 'MCP_SERVER';
+  readonly SERVER_CACHE: 'SERVER_CACHE';
+  readonly SERVER: 'SERVER';
+  readonly WORKSPACE: 'WORKSPACE';
+  readonly CHANNEL: 'CHANNEL';
+};
+type RegisteredLogger = (typeof RegisteredLogger)[keyof typeof RegisteredLogger];
+declare const LogLevel: {
+  readonly DEBUG: 'debug';
+  readonly INFO: 'info';
+  readonly WARN: 'warn';
+  readonly ERROR: 'error';
+  readonly NONE: 'silent';
+};
+type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+interface BaseLogMessage {
+  runId?: string;
+  msg: string;
+  level: LogLevel;
+  time: Date;
+  pid: number;
+  hostname: string;
+  name: string;
+}
+declare abstract class LoggerTransport extends Transform {
+  constructor(opts?: any);
+  listLogsByRunId(_args: {
+    runId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+  listLogs(_args?: {
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    returnPaginationResults?: boolean;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+}
+declare const createCustomTransport: (stream: Transform, listLogs?: LoggerTransport['listLogs'], listLogsByRunId?: LoggerTransport['listLogsByRunId']) => LoggerTransport;
+interface IMastraLogger {
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  trackException(error: Error, metadata?: Record<string, unknown>): void;
+  getTransports(): Map<string, LoggerTransport>;
+  listLogs(_transportId: string, _params?: {
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+  listLogsByRunId(_args: {
+    transportId: string;
+    runId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+}
+declare abstract class MastraLogger implements IMastraLogger {
+  protected name: string;
+  protected level: LogLevel;
+  protected transports: Map<string, LoggerTransport>;
+  constructor(options?: {
+    name?: string;
+    level?: LogLevel;
+    transports?: Record<string, LoggerTransport>;
+  });
+  abstract debug(message: string, ...args: any[]): void;
+  abstract info(message: string, ...args: any[]): void;
+  abstract warn(message: string, ...args: any[]): void;
+  abstract error(message: string, ...args: any[]): void;
+  getTransports(): Map<string, LoggerTransport>;
+  trackException(_error: Error, _metadata?: Record<string, unknown>): void;
+  listLogs(transportId: string, params?: {
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+  listLogsByRunId({ transportId, runId, fromDate, toDate, logLevel, filters, page, perPage }: {
+    transportId: string;
+    runId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+}
+type LogFilterContext = {
+  component?: RegisteredLogger;
+  level: LogLevel;
+  message: string;
+  args: unknown[];
+};
+type LogFilter = (ctx: LogFilterContext) => boolean;
+interface ConsoleLoggerOptions {
+  name?: string;
+  level?: LogLevel;
+  component?: RegisteredLogger;
+  filter?: LogFilter;
+}
+declare class ConsoleLogger extends MastraLogger {
+  #private;
+  protected component?: RegisteredLogger;
+  protected filter?: LogFilter;
+  constructor(options?: ConsoleLoggerOptions);
+  /**
+   * Adapter hook (see `AdaptableLogger`): enables native trace correlation
+   * (trace_id/span_id appended to console output) and observability export
+   * derived from the same record. Called by Mastra during setup.
+   */
+  __attachObservability(ctx: LoggerAdapterContext): void;
+  child(componentOrBindings: RegisteredLogger | Record<string, unknown>): ConsoleLogger;
+  private shouldLog;
+  private prefix;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  trackException(error: Error, metadata?: Record<string, unknown>): void;
+  listLogs(_transportId: string, _params?: {
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: never[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+  listLogsByRunId(_args: {
+    transportId: string;
+    runId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, any>;
+    page?: number;
+    perPage?: number;
+  }): Promise<{
+    logs: never[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+  }>;
+}
+//#endregion
+export { buildLogRecordData as _, LogFilter as a, LoggerTransport as c, createCustomTransport as d, AdaptableLogger as f, TraceFields as g, LoggerAdapterOptions as h, IMastraLogger as i, MastraLogger as l, LoggerAdapterContext as m, ConsoleLogger as n, LogFilterContext as o, AdapterLogSink as p, ConsoleLoggerOptions as r, LogLevel as s, BaseLogMessage as t, RegisteredLogger as u, exportTrackedException as v, isAdaptableLogger as y };
+//# sourceMappingURL=index-Biaf3BmX.d.ts.map