@allstak/angular 0.1.0

package/fesm2022/allstak-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"allstak-angular.mjs","sources":["../../src/version.ts","../../src/init.ts","../../src/error-handler.ts","../../src/http-interceptor.ts","../../src/trace-service.ts","../../src/trace-directive.ts","../../src/trace-decorators.ts","../../src/providers.ts","../../src/module.ts","../../public-api.ts","../../allstak-angular.ts"],"sourcesContent":["// AUTO-GENERATED by scripts/gen-version.mjs — do not edit by hand.\nexport const SDK_NAME = 'allstak-angular';\nexport const SDK_VERSION = \"0.1.0\";\n","import { AllStak } from '@allstak/js';\nimport type { AllStakConfig } from '@allstak/js';\nimport { SDK_NAME, SDK_VERSION } from './version';\n\n/**\n * The core client instance returned by `AllStak.init`. `@allstak/js` does\n * not export the `AllStakClient` class by name, so we derive the type from\n * the value. This keeps the emitted declaration referential (no inlining of\n * the core class's private members, which would trip TS4094).\n */\nexport type AllStakClientInstance = ReturnType<typeof AllStak.init>;\n\n/**\n * Initialize the AllStak SDK for an Angular application.\n *\n * This is a thin shim over `AllStak.init` from `@allstak/js` that stamps the\n * wrapper identity (`sdkName: 'allstak-angular'`, `sdkVersion`) so the backend\n * can tell Angular traffic apart from plain JS traffic. Everything else —\n * buffering, sampling, session health, offline queue, PII scrubbing — is\n * delegated to the underlying core client.\n *\n * Call this once at app boot in `main.ts`, BEFORE `bootstrapApplication(...)`\n * (standalone) or `platformBrowserDynamic().bootstrapModule(...)` (NgModule),\n * so the global `ErrorHandler` and router instrumentation see a live client:\n *\n *   import { init } from '@allstak/angular';\n *\n *   init({\n *     apiKey: environment.allstakApiKey,\n *     environment: environment.production ? 'production' : 'development',\n *   });\n *\n *   bootstrapApplication(AppComponent, appConfig);\n */\nexport function init(config: AllStakConfig): AllStakClientInstance {\n  return AllStak.init({\n    ...config,\n    sdkName: config.sdkName ?? SDK_NAME,\n    sdkVersion: config.sdkVersion ?? SDK_VERSION,\n  });\n}\n","import { ErrorHandler, Injectable } from '@angular/core';\nimport { AllStak } from '@allstak/js';\n\n/**\n * Options accepted by {@link createErrorHandler} / {@link AllStakErrorHandler}.\n *\n * Mirrors the shape host apps expect from a framework error-handler factory:\n * a logging toggle and an `extractor` escape hatch so the host can customise\n * how a thrown value is unwrapped before we hand it to `captureException`.\n */\nexport interface ErrorHandlerOptions {\n  /**\n   * Also `console.error` the original error after capturing it. Default:\n   * `true` — preserving Angular's default behaviour of surfacing errors to\n   * the console so local development is not silenced.\n   */\n  logErrors?: boolean;\n\n  /**\n   * Customise how the thrown value is reduced to the `Error` we capture.\n   * Receives the raw value Angular handed to `handleError` plus the SDK's\n   * `defaultExtractor`, so a host can fall back to default behaviour for\n   * cases it does not care about.\n   *\n   *   createErrorHandler({\n   *     extractor: (error, defaultExtractor) =>\n   *       error?.customCause ?? defaultExtractor(error),\n   *   });\n   */\n  extractor?: (error: unknown, defaultExtractor: (error: unknown) => unknown) => unknown;\n}\n\nconst DEFAULT_OPTIONS: Required<Pick<ErrorHandlerOptions, 'logErrors'>> = {\n  logErrors: true,\n};\n\n/**\n * Unwrap the common Angular/zone.js error envelopes so we capture the real\n * underlying error rather than the wrapper:\n *\n *   - Angular wraps errors thrown during change detection as\n *     `{ ngOriginalError }` / `{ originalError }`.\n *   - `HttpErrorResponse` carries the server payload on `.error`.\n *   - DOM `ErrorEvent` carries the real error on `.error`.\n *   - Rejected promises may surface as `{ rejection }`.\n */\nfunction defaultExtractor(error: unknown): unknown {\n  if (error && typeof error === 'object') {\n    const candidate = error as Record<string, unknown>;\n    // PromiseRejectionEvent-style wrapping from zone.js.\n    if ('rejection' in candidate && candidate['rejection'] != null) {\n      return defaultExtractor(candidate['rejection']);\n    }\n    // Angular wraps the thrown value during change detection.\n    if ('ngOriginalError' in candidate && candidate['ngOriginalError'] != null) {\n      return defaultExtractor(candidate['ngOriginalError']);\n    }\n    if ('originalError' in candidate && candidate['originalError'] != null) {\n      return defaultExtractor(candidate['originalError']);\n    }\n    // DOM ErrorEvent / HttpErrorResponse expose the real error on `.error`.\n    if ('error' in candidate && candidate['error'] instanceof Error) {\n      return candidate['error'];\n    }\n  }\n  return error;\n}\n\n/** Coerce any extracted value into an `Error` so `captureException` is happy. */\nfunction toError(value: unknown): Error {\n  if (value instanceof Error) return value;\n  if (typeof value === 'string') return new Error(value);\n  try {\n    return new Error(JSON.stringify(value));\n  } catch {\n    return new Error(String(value));\n  }\n}\n\n/**\n * AllStak's implementation of Angular's `ErrorHandler`. Captures every error\n * routed through Angular's global error handling — uncaught render/lifecycle\n * errors, change-detection errors, and (when zone.js is present) unhandled\n * promise rejections.\n *\n * Wired manually as `{ provide: ErrorHandler, useValue: createErrorHandler() }`\n * or via {@link provideAllStakErrorHandler}.\n */\n@Injectable()\nexport class AllStakErrorHandler implements ErrorHandler {\n  private readonly options: ErrorHandlerOptions;\n\n  constructor(options: ErrorHandlerOptions = {}) {\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n  }\n\n  handleError(error: unknown): void {\n    const extracted = this.options.extractor\n      ? this.options.extractor(error, defaultExtractor)\n      : defaultExtractor(error);\n\n    const err = toError(extracted);\n\n    try {\n      AllStak.captureException(err, { framework: 'angular' });\n    } catch {\n      // Never let our handler break the host's error path.\n    }\n\n    if (this.options.logErrors !== false) {\n      // Preserve Angular's default of surfacing the original (pre-unwrap)\n      // value so stack traces and zone context stay intact in the console.\n      // eslint-disable-next-line no-console\n      console.error(error);\n    }\n  }\n}\n\n/**\n * Factory returning an Angular `ErrorHandler` that forwards to\n * `AllStak.captureException`.\n *\n * Standalone (`app.config.ts`):\n *\n *   import { ErrorHandler } from '@angular/core';\n *   import { createErrorHandler } from '@allstak/angular';\n *\n *   export const appConfig = {\n *     providers: [{ provide: ErrorHandler, useValue: createErrorHandler() }],\n *   };\n *\n * NgModule (`AppModule`):\n *\n *   @NgModule({\n *     providers: [{ provide: ErrorHandler, useValue: createErrorHandler() }],\n *   })\n *   export class AppModule {}\n */\nexport function createErrorHandler(options?: ErrorHandlerOptions): ErrorHandler {\n  return new AllStakErrorHandler(options);\n}\n","import { Injectable } from '@angular/core';\nimport type {\n  HttpEvent,\n  HttpHandler,\n  HttpInterceptor,\n  HttpHandlerFn,\n  HttpRequest,\n} from '@angular/common/http';\nimport { HttpResponse, HttpErrorResponse } from '@angular/common/http';\nimport { Observable } from 'rxjs';\nimport { AllStak } from '@allstak/js';\nimport type { HttpRequestItem, Span } from '@allstak/js';\n\n/** HTTP verbs the core `HttpRequestItem` accepts. */\ntype HttpMethod = HttpRequestItem['method'];\n\nconst KNOWN_METHODS: ReadonlySet<string> = new Set([\n  'GET',\n  'POST',\n  'PUT',\n  'DELETE',\n  'PATCH',\n  'HEAD',\n  'OPTIONS',\n]);\n\n/** Normalise an Angular request method into the core method union. */\nfunction normalizeMethod(method: string): HttpMethod {\n  const upper = method.toUpperCase();\n  return (KNOWN_METHODS.has(upper) ? upper : 'GET') as HttpMethod;\n}\n\n/** Split an outbound URL into `host` + `path`, tolerating relative URLs. */\nfunction splitUrl(url: string): { host: string; path: string } {\n  try {\n    const base =\n      typeof window !== 'undefined' && window.location\n        ? window.location.origin\n        : 'http://localhost';\n    const parsed = new URL(url, base);\n    return { host: parsed.host, path: parsed.pathname + parsed.search };\n  } catch {\n    return { host: '', path: url };\n  }\n}\n\n/**\n * Open a span + record an outbound request for a single `HttpRequest`, and\n * return the lifecycle hooks the interceptor (class or functional) uses to\n * finish it. Shared so the class-based and functional interceptors stay\n * behaviourally identical.\n */\nfunction instrumentRequest(req: HttpRequest<unknown>): {\n  onResponse: (status: number) => void;\n  onError: (error: unknown) => void;\n} {\n  const startedAt = Date.now();\n  const method = normalizeMethod(req.method);\n  const { host, path } = splitUrl(req.urlWithParams);\n  let span: Span | null = null;\n\n  try {\n    span = AllStak.startSpan('http.client', {\n      op: 'http.client',\n      description: `${req.method} ${req.urlWithParams}`,\n      attributes: {\n        'allstak.origin': 'auto.http.angular',\n        'http.method': req.method,\n        'http.url': req.urlWithParams,\n      },\n    });\n  } catch {\n    // Never block the request on observability errors.\n  }\n\n  const finish = (statusCode: number, status: 'ok' | 'error') => {\n    const durationMs = Date.now() - startedAt;\n    try {\n      span?.setMeasurement('http.duration_ms', durationMs);\n      span?.finish(status);\n    } catch {\n      // ignore — span may already be finished\n    }\n    try {\n      const item: HttpRequestItem = {\n        direction: 'outbound',\n        method,\n        host,\n        path,\n        statusCode,\n        durationMs,\n      };\n      AllStak.captureRequest(item);\n    } catch {\n      // ignore — request recording is best-effort\n    }\n  };\n\n  return {\n    onResponse(statusCode: number) {\n      finish(statusCode, statusCode >= 400 ? 'error' : 'ok');\n    },\n    onError(error: unknown) {\n      const statusCode = error instanceof HttpErrorResponse ? error.status : 0;\n      finish(statusCode, 'error');\n    },\n  };\n}\n\n/**\n * Class-based `HttpInterceptor` that records every outbound HTTP request and\n * opens a `http.client` span around it. Register in the DI-token style used by\n * NgModule apps and standalone apps that opt into `withInterceptorsFromDi()`:\n *\n *   import { HTTP_INTERCEPTORS } from '@angular/common/http';\n *   import { AllStakHttpInterceptor } from '@allstak/angular';\n *\n *   providers: [\n *     { provide: HTTP_INTERCEPTORS, useClass: AllStakHttpInterceptor, multi: true },\n *   ]\n *\n * The interceptor never mutates the request and never swallows errors — it\n * only observes the stream.\n */\n@Injectable()\nexport class AllStakHttpInterceptor implements HttpInterceptor {\n  intercept(\n    req: HttpRequest<unknown>,\n    next: HttpHandler,\n  ): Observable<HttpEvent<unknown>> {\n    const hooks = instrumentRequest(req);\n\n    return new Observable<HttpEvent<unknown>>((subscriber) => {\n      const sub = next.handle(req).subscribe({\n        next: (event) => {\n          if (event instanceof HttpResponse) {\n            hooks.onResponse(event.status);\n          }\n          subscriber.next(event);\n        },\n        error: (error) => {\n          hooks.onError(error);\n          subscriber.error(error);\n        },\n        complete: () => subscriber.complete(),\n      });\n      return () => sub.unsubscribe();\n    });\n  }\n}\n\n/**\n * Functional `HttpInterceptor` for standalone apps using\n * `provideHttpClient(withInterceptors([allStakHttpInterceptor]))`.\n *\n * Behaviourally identical to {@link AllStakHttpInterceptor}.\n */\nexport function allStakHttpInterceptor(\n  req: HttpRequest<unknown>,\n  next: HttpHandlerFn,\n): Observable<HttpEvent<unknown>> {\n  const hooks = instrumentRequest(req);\n\n  return new Observable<HttpEvent<unknown>>((subscriber) => {\n    const sub = next(req).subscribe({\n      next: (event) => {\n        if (event instanceof HttpResponse) {\n          hooks.onResponse(event.status);\n        }\n        subscriber.next(event);\n      },\n      error: (error) => {\n        hooks.onError(error);\n        subscriber.error(error);\n      },\n      complete: () => subscriber.complete(),\n    });\n    return () => sub.unsubscribe();\n  });\n}\n","import { Injectable, OnDestroy, Optional } from '@angular/core';\nimport {\n  Router,\n  NavigationStart,\n  NavigationEnd,\n  NavigationCancel,\n  NavigationError,\n} from '@angular/router';\nimport type { Event as RouterEvent } from '@angular/router';\nimport type { Subscription } from 'rxjs';\nimport { AllStak } from '@allstak/js';\nimport type { Span } from '@allstak/js';\n\n/**\n * Router-aware navigation instrumentation.\n *\n * `TraceService` subscribes to Angular `Router` events and opens a\n * `navigation` span per route change — `NavigationStart` opens it,\n * `NavigationEnd` finishes it `ok`, and `NavigationCancel` / `NavigationError`\n * finish it `error`. A navigation breadcrumb is recorded alongside each span.\n *\n * Because Angular only constructs a service when something injects it, the\n * service must be *force-instantiated* for its Router subscription to run.\n * Use {@link provideAllStakRouterInstrumentation} (standalone) or inject it in\n * your `AppComponent` constructor (NgModule) — see those helpers for wiring.\n *\n * `Router` is `@Optional()` so apps without `@angular/router` (which is an\n * optional peer dependency) can still construct the service without error; it\n * simply becomes a no-op.\n */\n@Injectable({ providedIn: 'root' })\nexport class TraceService implements OnDestroy {\n  private activeNavSpan: Span | null = null;\n  private readonly subscription: Subscription | null = null;\n\n  constructor(@Optional() private readonly router: Router | null) {\n    if (!this.router) return;\n    this.subscription = this.router.events.subscribe((event: RouterEvent) => {\n      this.handleEvent(event);\n    });\n  }\n\n  private handleEvent(event: RouterEvent): void {\n    try {\n      if (event instanceof NavigationStart) {\n        this.onNavigationStart(event.url);\n      } else if (event instanceof NavigationEnd) {\n        this.finishActive('ok');\n      } else if (\n        event instanceof NavigationCancel ||\n        event instanceof NavigationError\n      ) {\n        this.finishActive('error');\n        if (event instanceof NavigationError) {\n          AllStak.captureException(\n            event.error instanceof Error\n              ? event.error\n              : new Error(String(event.error)),\n            { framework: 'angular', source: '@angular/router' },\n          );\n        }\n      }\n    } catch {\n      // ignore — never block navigation on observability errors\n    }\n  }\n\n  private onNavigationStart(url: string): void {\n    // A new navigation supersedes any span still open from a redirect chain.\n    this.finishActive('ok');\n\n    AllStak.addBreadcrumb({\n      type: 'navigation',\n      message: url,\n      level: 'info',\n      data: { url },\n    });\n\n    this.activeNavSpan = AllStak.startSpan('navigation', {\n      op: 'navigation',\n      description: url,\n      attributes: {\n        'allstak.origin': 'auto.navigation.angular',\n        'route.url': url,\n      },\n    });\n  }\n\n  private finishActive(status: 'ok' | 'error'): void {\n    if (!this.activeNavSpan) return;\n    try {\n      this.activeNavSpan.finish(status);\n    } catch {\n      // ignore — span may already be finished\n    } finally {\n      this.activeNavSpan = null;\n    }\n  }\n\n  ngOnDestroy(): void {\n    this.subscription?.unsubscribe();\n    this.finishActive('ok');\n  }\n}\n","import {\n  Directive,\n  Input,\n  OnInit,\n  AfterViewInit,\n} from '@angular/core';\nimport { AllStak } from '@allstak/js';\nimport type { Span } from '@allstak/js';\n\n/**\n * `[trace]` template directive for component render timing.\n *\n *   <app-checkout trace=\"checkout\"></app-checkout>\n *\n * Opens a `ui.angular.init` span when the host component initialises\n * (`ngOnInit`) and finishes it once the component's view has been fully\n * initialised (`ngAfterViewInit`). The span is named after the directive's\n * `trace` value — required, because component class names are not reliable in\n * minified production builds.\n *\n * Standalone components import the directive directly; module-based apps get\n * it via {@link AllStakTraceModule}.\n */\n@Directive({\n  selector: '[trace]',\n  standalone: true,\n})\nexport class TraceDirective implements OnInit, AfterViewInit {\n  /**\n   * Human-readable name for the traced component. Used as the span\n   * description. Required so spans stay meaningful after minification.\n   */\n  @Input('trace') componentName = '';\n\n  private span: Span | null = null;\n\n  ngOnInit(): void {\n    const name = this.componentName || 'unnamed';\n    try {\n      this.span = AllStak.startSpan('ui.angular.init', {\n        op: 'ui.angular.init',\n        description: name,\n        attributes: {\n          'allstak.origin': 'auto.ui.angular',\n          'angular.component': name,\n        },\n      });\n    } catch {\n      // Never let render tracing break a component.\n    }\n  }\n\n  ngAfterViewInit(): void {\n    try {\n      this.span?.finish('ok');\n    } catch {\n      // ignore — span may already be finished\n    } finally {\n      this.span = null;\n    }\n  }\n}\n","import { AllStak } from '@allstak/js';\nimport type { Span } from '@allstak/js';\n\n/**\n * Options for {@link TraceClassDecorator} / {@link TraceMethodDecorator}.\n *\n * `name` is required because Angular component/class names are mangled in\n * minified production builds — the span would otherwise be unidentifiable.\n */\nexport interface TraceDecoratorOptions {\n  name: string;\n}\n\n/**\n * Class decorator that instruments a component's init lifecycle. Wraps\n * `ngOnInit` so a `ui.angular.init` span is opened on init and finished on\n * `ngAfterViewInit` (or immediately after `ngOnInit` if the component has no\n * `ngAfterViewInit`).\n *\n *   @TraceClassDecorator({ name: 'CheckoutComponent' })\n *   @Component({ ... })\n *   export class CheckoutComponent implements OnInit {}\n */\nexport function TraceClassDecorator(options: TraceDecoratorOptions) {\n  return function <T extends { new (...args: any[]): object }>(target: T): T {\n    const proto = target.prototype as Record<string, unknown> & {\n      ngOnInit?: () => void;\n      ngAfterViewInit?: () => void;\n    };\n    const SPAN_KEY = '__allstak_trace_class_span__';\n    const originalOnInit = proto.ngOnInit;\n    const originalAfterViewInit = proto.ngAfterViewInit;\n\n    proto.ngOnInit = function (this: Record<string, unknown>) {\n      try {\n        this[SPAN_KEY] = AllStak.startSpan('ui.angular.init', {\n          op: 'ui.angular.init',\n          description: options.name,\n          attributes: {\n            'allstak.origin': 'auto.ui.angular',\n            'angular.component': options.name,\n          },\n        });\n      } catch {\n        // ignore\n      }\n      originalOnInit?.call(this);\n      // If there is no ngAfterViewInit, close the span right after init.\n      if (!originalAfterViewInit && !proto.ngAfterViewInit) {\n        finishSpan(this[SPAN_KEY]);\n        this[SPAN_KEY] = undefined;\n      }\n    };\n\n    proto.ngAfterViewInit = function (this: Record<string, unknown>) {\n      originalAfterViewInit?.call(this);\n      finishSpan(this[SPAN_KEY]);\n      this[SPAN_KEY] = undefined;\n    };\n\n    return target;\n  };\n}\n\n/** Alias for the alternate naming. */\nexport const TraceClass = TraceClassDecorator;\n\n/**\n * Method decorator emitting a point-in-time `ui.angular.[hook]` span around a\n * single lifecycle method (e.g. `ngOnInit`, `ngOnChanges`, `ngAfterViewInit`).\n *\n *   class Foo {\n *     @TraceMethodDecorator({ name: 'Foo.ngOnInit' })\n *     ngOnInit() {}\n *   }\n */\nexport function TraceMethodDecorator(options: TraceDecoratorOptions) {\n  return function (\n    _target: object,\n    propertyKey: string,\n    descriptor: PropertyDescriptor,\n  ): PropertyDescriptor {\n    const original = descriptor.value as ((...args: unknown[]) => unknown) | undefined;\n    descriptor.value = function (this: unknown, ...args: unknown[]) {\n      let span: Span | null = null;\n      try {\n        span = AllStak.startSpan(`ui.angular.${propertyKey}`, {\n          op: `ui.angular.${propertyKey}`,\n          description: options.name,\n          attributes: {\n            'allstak.origin': 'auto.ui.angular',\n            'angular.hook': propertyKey,\n          },\n        });\n      } catch {\n        // ignore\n      }\n      try {\n        return original?.apply(this, args);\n      } finally {\n        finishSpan(span ?? undefined);\n      }\n    };\n    return descriptor;\n  };\n}\n\n/** Alias for the alternate naming. */\nexport const TraceMethod = TraceMethodDecorator;\n\nfunction finishSpan(span: unknown): void {\n  try {\n    (span as Span | undefined)?.finish('ok');\n  } catch {\n    // ignore — span may already be finished\n  }\n}\n","import {\n  APP_INITIALIZER,\n  ENVIRONMENT_INITIALIZER,\n  ErrorHandler,\n  inject,\n  makeEnvironmentProviders,\n} from '@angular/core';\nimport type { EnvironmentProviders, Provider } from '@angular/core';\nimport type { AllStakConfig } from '@allstak/js';\nimport { init } from './init';\nimport { createErrorHandler } from './error-handler';\nimport type { ErrorHandlerOptions } from './error-handler';\nimport { TraceService } from './trace-service';\n\n/**\n * Bootstrap the AllStak SDK from a standalone app's `appConfig.providers`.\n *\n *   import { provideAllStak } from '@allstak/angular';\n *\n *   export const appConfig: ApplicationConfig = {\n *     providers: [\n *       provideAllStak({ apiKey: environment.allstakApiKey }),\n *     ],\n *   };\n *\n * This calls {@link init} during DI bootstrap. For the global `ErrorHandler`\n * to catch errors thrown *during bootstrap itself*, prefer calling `init(...)`\n * directly in `main.ts` before `bootstrapApplication`; this provider is the\n * convenient alternative for apps that initialise inside the DI graph.\n */\nexport function provideAllStak(config: AllStakConfig): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    {\n      provide: ENVIRONMENT_INITIALIZER,\n      multi: true,\n      useValue: () => {\n        init(config);\n      },\n    },\n  ]);\n}\n\n/**\n * Provide the AllStak `ErrorHandler` (overriding Angular's default) so every\n * error routed through Angular's global error handling is captured.\n *\n *   providers: [provideAllStakErrorHandler()]\n *\n * Equivalent to `{ provide: ErrorHandler, useValue: createErrorHandler() }`.\n */\nexport function provideAllStakErrorHandler(\n  options?: ErrorHandlerOptions,\n): Provider {\n  return { provide: ErrorHandler, useValue: createErrorHandler(options) };\n}\n\n/**\n * Register and force-instantiate {@link TraceService} so its Router\n * subscription runs and a navigation span opens per route change.\n *\n *   providers: [provideRouter(routes), provideAllStakRouterInstrumentation()]\n *\n * `TraceService` is `providedIn: 'root'`, but Angular only constructs a\n * service when something injects it. The `APP_INITIALIZER` below injects it\n * during bootstrap, guaranteeing the subscription is live before the first\n * navigation completes.\n */\nexport function provideAllStakRouterInstrumentation(): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    TraceService,\n    {\n      provide: APP_INITIALIZER,\n      multi: true,\n      useFactory: () => {\n        // Force-instantiate the service; the factory itself is a no-op.\n        inject(TraceService);\n        return () => undefined;\n      },\n    },\n  ]);\n}\n","import {\n  APP_INITIALIZER,\n  ErrorHandler,\n  InjectionToken,\n  NgModule,\n  Optional,\n} from '@angular/core';\nimport type { ModuleWithProviders } from '@angular/core';\nimport type { AllStakConfig } from '@allstak/js';\nimport { init } from './init';\nimport { createErrorHandler } from './error-handler';\nimport { TraceService } from './trace-service';\nimport { TraceDirective } from './trace-directive';\n\n/** DI token carrying the config passed to {@link AllStakModule.forRoot}. */\nexport const ALLSTAK_CONFIG = new InjectionToken<AllStakConfig>('ALLSTAK_CONFIG');\n\n/**\n * NgModule that exposes {@link TraceDirective} for module-based apps (or\n * standalone components that prefer NgModule-style `imports`):\n *\n *   @NgModule({ imports: [AllStakTraceModule] })\n *   export class AppModule {}\n *\n *   <app-checkout trace=\"checkout\"></app-checkout>\n *\n * `TraceDirective` is a standalone directive, so it is imported (not declared)\n * and re-exported.\n */\n@NgModule({\n  imports: [TraceDirective],\n  exports: [TraceDirective],\n})\nexport class AllStakTraceModule {}\n\n/**\n * Root NgModule for module-based Angular apps.\n *\n *   import { AllStakModule } from '@allstak/angular';\n *\n *   @NgModule({\n *     imports: [\n *       BrowserModule,\n *       AllStakModule.forRoot({ apiKey: environment.allstakApiKey }),\n *     ],\n *   })\n *   export class AppModule {}\n *\n * `forRoot(config)`:\n *   - calls {@link init} during bootstrap (via `APP_INITIALIZER`);\n *   - overrides the global `ErrorHandler` with the AllStak handler;\n *   - force-instantiates {@link TraceService} so router navigation spans open;\n *   - exposes {@link TraceDirective} via {@link AllStakTraceModule}.\n *\n * Call `forRoot` exactly once, in your root module. Feature modules that only\n * need the `[trace]` directive can import {@link AllStakTraceModule} directly.\n */\n@NgModule({\n  imports: [AllStakTraceModule],\n  exports: [AllStakTraceModule],\n})\nexport class AllStakModule {\n  // Inject TraceService here so importing the module force-instantiates it and\n  // its Router subscription runs. `@Optional` keeps router-less apps working.\n  constructor(@Optional() _trace: TraceService | null) {}\n\n  static forRoot(config: AllStakConfig): ModuleWithProviders<AllStakModule> {\n    return {\n      ngModule: AllStakModule,\n      providers: [\n        { provide: ALLSTAK_CONFIG, useValue: config },\n        { provide: ErrorHandler, useValue: createErrorHandler() },\n        TraceService,\n        {\n          provide: APP_INITIALIZER,\n          multi: true,\n          useFactory: appInitializerFactory,\n          deps: [ALLSTAK_CONFIG, TraceService],\n        },\n      ],\n    };\n  }\n}\n\n/**\n * `APP_INITIALIZER` factory: initialises the SDK from the injected config and\n * touches `TraceService` so it is constructed (its constructor wires the\n * Router subscription). Declared as a named function so ng-packagr's partial\n * compiler can statically reference it (no arrow-in-decorator-metadata error).\n */\nexport function appInitializerFactory(\n  config: AllStakConfig,\n  // TraceService is injected via `deps` purely to force its construction.\n  _trace: TraceService,\n): () => void {\n  return () => {\n    init(config);\n  };\n}\n","/**\n * AllStak for Angular.\n *\n * Public surface:\n *   - `init`                              — bootstrap (delegates to @allstak/js with Angular tagging)\n *   - `createErrorHandler` / `AllStakErrorHandler` — Angular `ErrorHandler` forwarding to captureException\n *   - `AllStakHttpInterceptor` / `allStakHttpInterceptor` — records outbound requests + opens spans\n *   - `TraceService`                      — Router-aware navigation span instrumentation\n *   - `TraceDirective` / `AllStakTraceModule` — `[trace]` component render-timing directive\n *   - `TraceClassDecorator` / `TraceMethodDecorator` — lifecycle-span decorators\n *   - `provideAllStak` / `provideAllStakErrorHandler` / `provideAllStakRouterInstrumentation`\n *                                          — standalone provider functions\n *   - `AllStakModule.forRoot(config)`     — NgModule registration for module-based apps\n *   - re-exports                          — every top-level @allstak/js export\n */\n\n// Bootstrap.\nexport { init } from './src/init';\nexport type { AllStakClientInstance } from './src/init';\n\n// Error handling.\nexport {\n  createErrorHandler,\n  AllStakErrorHandler,\n} from './src/error-handler';\nexport type { ErrorHandlerOptions } from './src/error-handler';\n\n// HTTP instrumentation.\nexport {\n  AllStakHttpInterceptor,\n  allStakHttpInterceptor,\n} from './src/http-interceptor';\n\n// Router / navigation instrumentation.\nexport { TraceService } from './src/trace-service';\n\n// Component render-timing directive + module.\nexport { TraceDirective } from './src/trace-directive';\n\n// Lifecycle-span decorators.\nexport {\n  TraceClass,\n  TraceClassDecorator,\n  TraceMethod,\n  TraceMethodDecorator,\n} from './src/trace-decorators';\nexport type { TraceDecoratorOptions } from './src/trace-decorators';\n\n// Standalone provider functions.\nexport {\n  provideAllStak,\n  provideAllStakErrorHandler,\n  provideAllStakRouterInstrumentation,\n} from './src/providers';\n\n// NgModule registration for module-based apps.\nexport {\n  AllStakModule,\n  AllStakTraceModule,\n  ALLSTAK_CONFIG,\n  appInitializerFactory,\n} from './src/module';\n\n// Wrapper identity.\nexport { SDK_NAME, SDK_VERSION } from './src/version';\n\n// ---------------------------------------------------------------------------\n// Mirror the @allstak/js public surface so consumers can pull the entire\n// observability API from a single namespaced import:\n//   import * as AllStakAngular from '@allstak/angular';\n// ---------------------------------------------------------------------------\nexport {\n  AllStak,\n  Scope,\n  Session,\n  SessionTracker,\n  Span,\n  WebVitalsModule,\n  isWebVitalsSupported,\n  defineIntegration,\n  dedupeIntegration,\n  consoleIntegration,\n  httpClientIntegration,\n  databaseIntegration,\n  eventFiltersIntegration,\n  inboundFiltersIntegration,\n} from '@allstak/js';\n\nexport type {\n  AllStakConfig,\n  AllStakIntegration,\n  Breadcrumb,\n  ErrorEvent,\n  ErrorEventProcessor,\n  LogEvent,\n  LogLevel,\n  HttpRequestItem,\n  HeartbeatOptions,\n  SpanData,\n  SpanOptions,\n  SpanProcessor,\n  TracesSampler,\n  SamplingContext,\n  WebVitalsContext,\n  DbQueryItem,\n  SessionStatus,\n} from '@allstak/js';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":["i1.TraceService"],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@allstak/angular" />
+export * from './public-api';

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@allstak/angular",
+  "version": "0.1.0",
+  "description": "Official AllStak SDK for Angular — error tracking, structured logs, distributed tracing, and observability for Angular applications.",
+  "keywords": [
+    "angular",
+    "observability",
+    "error-tracking",
+    "logging",
+    "monitoring",
+    "tracing",
+    "allstak"
+  ],
+  "homepage": "https://allstak.sa",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AllStak/allstak-angular.git"
+  },
+  "bugs": "https://github.com/AllStak/allstak-angular/issues",
+  "license": "MIT",
+  "author": "AllStak <sdk@allstak.sa>",
+  "sideEffects": false,
+  "peerDependencies": {
+    "@angular/common": ">=14.0.0 <19.0.0",
+    "@angular/core": ">=14.0.0 <19.0.0",
+    "@angular/router": ">=14.0.0 <19.0.0",
+    "rxjs": "^6.5.5 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@angular/router": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@allstak/js": "^0.3.0",
+    "tslib": "^2.3.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "module": "fesm2022/allstak-angular.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/allstak-angular.mjs",
+      "esm": "./esm2022/allstak-angular.mjs",
+      "default": "./fesm2022/allstak-angular.mjs"
+    }
+  }
+}

package/public-api.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AllStak for Angular.
+ *
+ * Public surface:
+ *   - `init`                              — bootstrap (delegates to @allstak/js with Angular tagging)
+ *   - `createErrorHandler` / `AllStakErrorHandler` — Angular `ErrorHandler` forwarding to captureException
+ *   - `AllStakHttpInterceptor` / `allStakHttpInterceptor` — records outbound requests + opens spans
+ *   - `TraceService`                      — Router-aware navigation span instrumentation
+ *   - `TraceDirective` / `AllStakTraceModule` — `[trace]` component render-timing directive
+ *   - `TraceClassDecorator` / `TraceMethodDecorator` — lifecycle-span decorators
+ *   - `provideAllStak` / `provideAllStakErrorHandler` / `provideAllStakRouterInstrumentation`
+ *                                          — standalone provider functions
+ *   - `AllStakModule.forRoot(config)`     — NgModule registration for module-based apps
+ *   - re-exports                          — every top-level @allstak/js export
+ */
+export { init } from './src/init';
+export type { AllStakClientInstance } from './src/init';
+export { createErrorHandler, AllStakErrorHandler, } from './src/error-handler';
+export type { ErrorHandlerOptions } from './src/error-handler';
+export { AllStakHttpInterceptor, allStakHttpInterceptor, } from './src/http-interceptor';
+export { TraceService } from './src/trace-service';
+export { TraceDirective } from './src/trace-directive';
+export { TraceClass, TraceClassDecorator, TraceMethod, TraceMethodDecorator, } from './src/trace-decorators';
+export type { TraceDecoratorOptions } from './src/trace-decorators';
+export { provideAllStak, provideAllStakErrorHandler, provideAllStakRouterInstrumentation, } from './src/providers';
+export { AllStakModule, AllStakTraceModule, ALLSTAK_CONFIG, appInitializerFactory, } from './src/module';
+export { SDK_NAME, SDK_VERSION } from './src/version';
+export { AllStak, Scope, Session, SessionTracker, Span, WebVitalsModule, isWebVitalsSupported, defineIntegration, dedupeIntegration, consoleIntegration, httpClientIntegration, databaseIntegration, eventFiltersIntegration, inboundFiltersIntegration, } from '@allstak/js';
+export type { AllStakConfig, AllStakIntegration, Breadcrumb, ErrorEvent, ErrorEventProcessor, LogEvent, LogLevel, HttpRequestItem, HeartbeatOptions, SpanData, SpanOptions, SpanProcessor, TracesSampler, SamplingContext, WebVitalsContext, DbQueryItem, SessionStatus, } from '@allstak/js';

package/src/error-handler.d.ts

@@ -0,0 +1,66 @@
+import { ErrorHandler } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Options accepted by {@link createErrorHandler} / {@link AllStakErrorHandler}.
+ *
+ * Mirrors the shape host apps expect from a framework error-handler factory:
+ * a logging toggle and an `extractor` escape hatch so the host can customise
+ * how a thrown value is unwrapped before we hand it to `captureException`.
+ */
+export interface ErrorHandlerOptions {
+    /**
+     * Also `console.error` the original error after capturing it. Default:
+     * `true` — preserving Angular's default behaviour of surfacing errors to
+     * the console so local development is not silenced.
+     */
+    logErrors?: boolean;
+    /**
+     * Customise how the thrown value is reduced to the `Error` we capture.
+     * Receives the raw value Angular handed to `handleError` plus the SDK's
+     * `defaultExtractor`, so a host can fall back to default behaviour for
+     * cases it does not care about.
+     *
+     *   createErrorHandler({
+     *     extractor: (error, defaultExtractor) =>
+     *       error?.customCause ?? defaultExtractor(error),
+     *   });
+     */
+    extractor?: (error: unknown, defaultExtractor: (error: unknown) => unknown) => unknown;
+}
+/**
+ * AllStak's implementation of Angular's `ErrorHandler`. Captures every error
+ * routed through Angular's global error handling — uncaught render/lifecycle
+ * errors, change-detection errors, and (when zone.js is present) unhandled
+ * promise rejections.
+ *
+ * Wired manually as `{ provide: ErrorHandler, useValue: createErrorHandler() }`
+ * or via {@link provideAllStakErrorHandler}.
+ */
+export declare class AllStakErrorHandler implements ErrorHandler {
+    private readonly options;
+    constructor(options?: ErrorHandlerOptions);
+    handleError(error: unknown): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AllStakErrorHandler, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AllStakErrorHandler>;
+}
+/**
+ * Factory returning an Angular `ErrorHandler` that forwards to
+ * `AllStak.captureException`.
+ *
+ * Standalone (`app.config.ts`):
+ *
+ *   import { ErrorHandler } from '@angular/core';
+ *   import { createErrorHandler } from '@allstak/angular';
+ *
+ *   export const appConfig = {
+ *     providers: [{ provide: ErrorHandler, useValue: createErrorHandler() }],
+ *   };
+ *
+ * NgModule (`AppModule`):
+ *
+ *   @NgModule({
+ *     providers: [{ provide: ErrorHandler, useValue: createErrorHandler() }],
+ *   })
+ *   export class AppModule {}
+ */
+export declare function createErrorHandler(options?: ErrorHandlerOptions): ErrorHandler;

package/src/http-interceptor.d.ts

@@ -0,0 +1,30 @@
+import type { HttpEvent, HttpHandler, HttpInterceptor, HttpHandlerFn, HttpRequest } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Class-based `HttpInterceptor` that records every outbound HTTP request and
+ * opens a `http.client` span around it. Register in the DI-token style used by
+ * NgModule apps and standalone apps that opt into `withInterceptorsFromDi()`:
+ *
+ *   import { HTTP_INTERCEPTORS } from '@angular/common/http';
+ *   import { AllStakHttpInterceptor } from '@allstak/angular';
+ *
+ *   providers: [
+ *     { provide: HTTP_INTERCEPTORS, useClass: AllStakHttpInterceptor, multi: true },
+ *   ]
+ *
+ * The interceptor never mutates the request and never swallows errors — it
+ * only observes the stream.
+ */
+export declare class AllStakHttpInterceptor implements HttpInterceptor {
+    intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AllStakHttpInterceptor, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AllStakHttpInterceptor>;
+}
+/**
+ * Functional `HttpInterceptor` for standalone apps using
+ * `provideHttpClient(withInterceptors([allStakHttpInterceptor]))`.
+ *
+ * Behaviourally identical to {@link AllStakHttpInterceptor}.
+ */
+export declare function allStakHttpInterceptor(req: HttpRequest<unknown>, next: HttpHandlerFn): Observable<HttpEvent<unknown>>;

package/src/init.d.ts

@@ -0,0 +1,32 @@
+import { AllStak } from '@allstak/js';
+import type { AllStakConfig } from '@allstak/js';
+/**
+ * The core client instance returned by `AllStak.init`. `@allstak/js` does
+ * not export the `AllStakClient` class by name, so we derive the type from
+ * the value. This keeps the emitted declaration referential (no inlining of
+ * the core class's private members, which would trip TS4094).
+ */
+export type AllStakClientInstance = ReturnType<typeof AllStak.init>;
+/**
+ * Initialize the AllStak SDK for an Angular application.
+ *
+ * This is a thin shim over `AllStak.init` from `@allstak/js` that stamps the
+ * wrapper identity (`sdkName: 'allstak-angular'`, `sdkVersion`) so the backend
+ * can tell Angular traffic apart from plain JS traffic. Everything else —
+ * buffering, sampling, session health, offline queue, PII scrubbing — is
+ * delegated to the underlying core client.
+ *
+ * Call this once at app boot in `main.ts`, BEFORE `bootstrapApplication(...)`
+ * (standalone) or `platformBrowserDynamic().bootstrapModule(...)` (NgModule),
+ * so the global `ErrorHandler` and router instrumentation see a live client:
+ *
+ *   import { init } from '@allstak/angular';
+ *
+ *   init({
+ *     apiKey: environment.allstakApiKey,
+ *     environment: environment.production ? 'production' : 'development',
+ *   });
+ *
+ *   bootstrapApplication(AppComponent, appConfig);
+ */
+export declare function init(config: AllStakConfig): AllStakClientInstance;

package/src/module.d.ts

@@ -0,0 +1,61 @@
+import { InjectionToken } from '@angular/core';
+import type { ModuleWithProviders } from '@angular/core';
+import type { AllStakConfig } from '@allstak/js';
+import { TraceService } from './trace-service';
+import * as i0 from "@angular/core";
+import * as i1 from "./trace-directive";
+/** DI token carrying the config passed to {@link AllStakModule.forRoot}. */
+export declare const ALLSTAK_CONFIG: InjectionToken<AllStakConfig>;
+/**
+ * NgModule that exposes {@link TraceDirective} for module-based apps (or
+ * standalone components that prefer NgModule-style `imports`):
+ *
+ *   @NgModule({ imports: [AllStakTraceModule] })
+ *   export class AppModule {}
+ *
+ *   <app-checkout trace="checkout"></app-checkout>
+ *
+ * `TraceDirective` is a standalone directive, so it is imported (not declared)
+ * and re-exported.
+ */
+export declare class AllStakTraceModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AllStakTraceModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AllStakTraceModule, never, [typeof i1.TraceDirective], [typeof i1.TraceDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AllStakTraceModule>;
+}
+/**
+ * Root NgModule for module-based Angular apps.
+ *
+ *   import { AllStakModule } from '@allstak/angular';
+ *
+ *   @NgModule({
+ *     imports: [
+ *       BrowserModule,
+ *       AllStakModule.forRoot({ apiKey: environment.allstakApiKey }),
+ *     ],
+ *   })
+ *   export class AppModule {}
+ *
+ * `forRoot(config)`:
+ *   - calls {@link init} during bootstrap (via `APP_INITIALIZER`);
+ *   - overrides the global `ErrorHandler` with the AllStak handler;
+ *   - force-instantiates {@link TraceService} so router navigation spans open;
+ *   - exposes {@link TraceDirective} via {@link AllStakTraceModule}.
+ *
+ * Call `forRoot` exactly once, in your root module. Feature modules that only
+ * need the `[trace]` directive can import {@link AllStakTraceModule} directly.
+ */
+export declare class AllStakModule {
+    constructor(_trace: TraceService | null);
+    static forRoot(config: AllStakConfig): ModuleWithProviders<AllStakModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AllStakModule, [{ optional: true; }]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AllStakModule, never, [typeof AllStakTraceModule], [typeof AllStakTraceModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AllStakModule>;
+}
+/**
+ * `APP_INITIALIZER` factory: initialises the SDK from the injected config and
+ * touches `TraceService` so it is constructed (its constructor wires the
+ * Router subscription). Declared as a named function so ng-packagr's partial
+ * compiler can statically reference it (no arrow-in-decorator-metadata error).
+ */
+export declare function appInitializerFactory(config: AllStakConfig, _trace: TraceService): () => void;

package/src/providers.d.ts

@@ -0,0 +1,41 @@
+import type { EnvironmentProviders, Provider } from '@angular/core';
+import type { AllStakConfig } from '@allstak/js';
+import type { ErrorHandlerOptions } from './error-handler';
+/**
+ * Bootstrap the AllStak SDK from a standalone app's `appConfig.providers`.
+ *
+ *   import { provideAllStak } from '@allstak/angular';
+ *
+ *   export const appConfig: ApplicationConfig = {
+ *     providers: [
+ *       provideAllStak({ apiKey: environment.allstakApiKey }),
+ *     ],
+ *   };
+ *
+ * This calls {@link init} during DI bootstrap. For the global `ErrorHandler`
+ * to catch errors thrown *during bootstrap itself*, prefer calling `init(...)`
+ * directly in `main.ts` before `bootstrapApplication`; this provider is the
+ * convenient alternative for apps that initialise inside the DI graph.
+ */
+export declare function provideAllStak(config: AllStakConfig): EnvironmentProviders;
+/**
+ * Provide the AllStak `ErrorHandler` (overriding Angular's default) so every
+ * error routed through Angular's global error handling is captured.
+ *
+ *   providers: [provideAllStakErrorHandler()]
+ *
+ * Equivalent to `{ provide: ErrorHandler, useValue: createErrorHandler() }`.
+ */
+export declare function provideAllStakErrorHandler(options?: ErrorHandlerOptions): Provider;
+/**
+ * Register and force-instantiate {@link TraceService} so its Router
+ * subscription runs and a navigation span opens per route change.
+ *
+ *   providers: [provideRouter(routes), provideAllStakRouterInstrumentation()]
+ *
+ * `TraceService` is `providedIn: 'root'`, but Angular only constructs a
+ * service when something injects it. The `APP_INITIALIZER` below injects it
+ * during bootstrap, guaranteeing the subscription is live before the first
+ * navigation completes.
+ */
+export declare function provideAllStakRouterInstrumentation(): EnvironmentProviders;

package/src/trace-decorators.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Options for {@link TraceClassDecorator} / {@link TraceMethodDecorator}.
+ *
+ * `name` is required because Angular component/class names are mangled in
+ * minified production builds — the span would otherwise be unidentifiable.
+ */
+export interface TraceDecoratorOptions {
+    name: string;
+}
+/**
+ * Class decorator that instruments a component's init lifecycle. Wraps
+ * `ngOnInit` so a `ui.angular.init` span is opened on init and finished on
+ * `ngAfterViewInit` (or immediately after `ngOnInit` if the component has no
+ * `ngAfterViewInit`).
+ *
+ *   @TraceClassDecorator({ name: 'CheckoutComponent' })
+ *   @Component({ ... })
+ *   export class CheckoutComponent implements OnInit {}
+ */
+export declare function TraceClassDecorator(options: TraceDecoratorOptions): <T extends {
+    new (...args: any[]): object;
+}>(target: T) => T;
+/** Alias for the alternate naming. */
+export declare const TraceClass: typeof TraceClassDecorator;
+/**
+ * Method decorator emitting a point-in-time `ui.angular.[hook]` span around a
+ * single lifecycle method (e.g. `ngOnInit`, `ngOnChanges`, `ngAfterViewInit`).
+ *
+ *   class Foo {
+ *     @TraceMethodDecorator({ name: 'Foo.ngOnInit' })
+ *     ngOnInit() {}
+ *   }
+ */
+export declare function TraceMethodDecorator(options: TraceDecoratorOptions): (_target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/** Alias for the alternate naming. */
+export declare const TraceMethod: typeof TraceMethodDecorator;

package/src/trace-directive.d.ts

@@ -0,0 +1,28 @@
+import { OnInit, AfterViewInit } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * `[trace]` template directive for component render timing.
+ *
+ *   <app-checkout trace="checkout"></app-checkout>
+ *
+ * Opens a `ui.angular.init` span when the host component initialises
+ * (`ngOnInit`) and finishes it once the component's view has been fully
+ * initialised (`ngAfterViewInit`). The span is named after the directive's
+ * `trace` value — required, because component class names are not reliable in
+ * minified production builds.
+ *
+ * Standalone components import the directive directly; module-based apps get
+ * it via {@link AllStakTraceModule}.
+ */
+export declare class TraceDirective implements OnInit, AfterViewInit {
+    /**
+     * Human-readable name for the traced component. Used as the span
+     * description. Required so spans stay meaningful after minification.
+     */
+    componentName: string;
+    private span;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TraceDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<TraceDirective, "[trace]", never, { "componentName": { "alias": "trace"; "required": false; }; }, {}, never, never, true, never>;
+}

package/src/trace-service.d.ts

@@ -0,0 +1,32 @@
+import { OnDestroy } from '@angular/core';
+import { Router } from '@angular/router';
+import * as i0 from "@angular/core";
+/**
+ * Router-aware navigation instrumentation.
+ *
+ * `TraceService` subscribes to Angular `Router` events and opens a
+ * `navigation` span per route change — `NavigationStart` opens it,
+ * `NavigationEnd` finishes it `ok`, and `NavigationCancel` / `NavigationError`
+ * finish it `error`. A navigation breadcrumb is recorded alongside each span.
+ *
+ * Because Angular only constructs a service when something injects it, the
+ * service must be *force-instantiated* for its Router subscription to run.
+ * Use {@link provideAllStakRouterInstrumentation} (standalone) or inject it in
+ * your `AppComponent` constructor (NgModule) — see those helpers for wiring.
+ *
+ * `Router` is `@Optional()` so apps without `@angular/router` (which is an
+ * optional peer dependency) can still construct the service without error; it
+ * simply becomes a no-op.
+ */
+export declare class TraceService implements OnDestroy {
+    private readonly router;
+    private activeNavSpan;
+    private readonly subscription;
+    constructor(router: Router | null);
+    private handleEvent;
+    private onNavigationStart;
+    private finishActive;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TraceService, [{ optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TraceService>;
+}

package/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const SDK_NAME = "allstak-angular";
+export declare const SDK_VERSION = "0.1.0";