SDK Angular

Pachetul @tracio/angular încapsulează nucleul @tracio/sdk și expune primitive Angular idiomatice: un provider pe care îl adăugați în configurația aplicației și un serviciu bazat pe signal-uri pe care îl injectați oriunde.

Instalare

bash

npm install @tracio/angular @tracio/sdk

@angular/core (17, 18 sau 19) este o peer dependency și se presupune că este deja instalat în aplicația dumneavoastră.

Configurare

Adăugați provideTracio(config) în ApplicationConfig.providers.

TypeScript

// app.config.ts
import { provideTracio } from "@tracio/angular"
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: "5ca175fc…" })],
}

Serviciu

Injectați TracioService pentru a citi starea de identificare prin signal-uri readonly:

Membru	Tip	Descriere
`visitorId()`	`Signal<string \| null>`	Identificatorul stabil al vizitatorului.
`result()`	`Signal<TracioResult \| null>`	Rezultatul complet al identificării.
`error()`	`Signal<TracioError \| null>`	Ultima eroare, dacă există.
`isLoading()`	`Signal<boolean>`	Dacă o preluare este în curs.
`getVisitorData()`	metodă	(Re)preluarea datelor vizitatorului imperativ.

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}

Apelați getVisitorData() pentru a amâna sau a redeclanșa identificarea — de exemplu doar după ce utilizatorul își dă consimțământul.

Exemplu complet

TypeScript

// app.config.ts
import { provideTracio } from "@tracio/angular"
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: "5ca175fc…" })],
}

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}

Pașii următori

Referință SDK JavaScript — API-ul de bază @tracio/sdk pe care se construiește serviciul
Gestionarea erorilor — coduri de eroare și strategii de reîncercare
Prezentare generală SDK-uri — fiecare pachet de framework dintr-o privire

Serviciu

Injectați TracioService pentru a citi starea de identificare prin signal-uri readonly:

Membru

Tip

Descriere

visitorId()

Signal<string | null>

Identificatorul stabil al vizitatorului.

result()

Signal<TracioResult | null>

Rezultatul complet al identificării.

error()

Signal<TracioError | null>

Ultima eroare, dacă există.

isLoading()

Signal<boolean>

Dacă o preluare este în curs.

getVisitorData()

metodă

(Re)preluarea datelor vizitatorului imperativ.

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}

Apelați getVisitorData() pentru a amâna sau a redeclanșa identificarea — de exemplu doar după ce utilizatorul își dă consimțământul.

Exemplu complet

TypeScript

// app.config.ts
import { provideTracio } from "@tracio/angular"
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: "5ca175fc…" })],
}

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}