@lib-acr/angular 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Application Control Room
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,91 @@
-# Temporary Holding Version
+# @lib-acr/angular
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Angular SDK: provideACR() (one client, an ErrorHandler that reports uncaught errors, start and stop with the app), ACRService, an HttpClient interceptor that times requests, and router page tracking from `@lib-acr/angular/router`.
+
+## Install
+
+```bash
+npm install @lib-acr/angular
+```
+
+## Quick start
+
+```ts
+// app.config.ts
+import { provideHttpClient, withInterceptors } from '@angular/common/http';
+import { provideRouter } from '@angular/router';
+import { provideACR, acrHttpInterceptor } from '@lib-acr/angular';
+import { provideACRRouterTracking } from '@lib-acr/angular/router';
+
+export const appConfig = {
+  providers: [
+    provideACR({ apiKey: environment.acrApiKey, endpoint: environment.acrEndpoint, appVersion: '1.0.0' }),
+    provideRouter(routes),
+    provideACRRouterTracking(),
+    provideHttpClient(withInterceptors([acrHttpInterceptor])),
+  ],
+};
+```
+
+## Notes
+
+Keep the publishable key in your environment files. Do not put secret keys in browser bundles. If you also use the fetch backend, set `trackFetch: false` so requests are not counted twice.
+
+- `ACRService` offers `trackEvent`, `log`, `captureError`, `identify`, `trackPageView`, `flush`, `optOut`, `optIn` and
+  `reset()` (on logout: clears the user id, new anonymous id, new session).
+- All `@lib-acr/browser` options apply, including `minLogLevel` (default `warn`) and `activePingMinutes` (default 5,
+  `0` turns the live-visitor ping off).
+- HTTP failures reported by `acrHttpInterceptor` are not reported again by the ErrorHandler.
+- The entry point does not re-export `AcrClient`, `HttpTransport` or `resolveConfig` from `@lib-acr/core`.
+
+## Remote control
+
+`ui` in `provideACR()` controls the built-in maintenance screen, announcement banner and update prompt (default: all
+on). Set parts to `false` and use the signals to render your own:
+
+```ts
+export class Shell {
+  readonly controls = injectACRControls(); // Signal<ControlState>: maintenance, announcement, release, flags, revision
+  private readonly acr = inject(ACRService);
+  dismiss(id: string) { this.acr.dismissAnnouncement(id); }
+}
+```
+
+Block routes while maintenance applies to the current user (from `@lib-acr/angular/router`):
+
+```ts
+{ path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuard] }
+{ path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuardWith({ redirectTo: '/maintenance' })] }
+```
+
+The guard uses the last snapshot, so navigations that happen before the first snapshot are allowed.
+
+## Feature flags
+
+```ts
+export class CheckoutPage {
+  readonly newCheckout = injectFlag('new-checkout', false); // or inject(ACRService).flagSignal(...)
+}
+```
+
+```html
+@if (newCheckout()) { <acr-new-checkout /> } @else { <acr-old-checkout /> }
+```
+
+`ACRService` also has `flag(key, fallback)` for a one-off read, `flag$(key, fallback)` as an observable and `flags()`.
+There is no `*acrFlag` structural directive. This package is compiled with plain `tsc` and has no Angular compiler
+step, so a decorated directive would need the JIT compiler at runtime and would break AOT builds. Use the built-in
+`@if` with the flag signal instead.
+
+## Wire protocol
+
+Every SDK sends the same protocol: `POST {endpoint}/ingest/{events|logs|errors|heartbeat}` with the `X-ACR-Api-Key`
+header (and `X-ACR-Secret-Key` for server keys). The credential determines the app and environment. The body is
+`{ schemaVersion: 1, sdk, items[1..500] }`.
+Each item has a client `id`, which lets the server drop duplicates when a batch is retried.
+
+Retries use exponential backoff with jitter for network errors, 429 and 5xx responses. Other 4xx responses are not retried.
+Telemetry is buffered in a bounded in-memory queue. When it is full, the oldest items are dropped and counted in `stats()`.
+SDK code never throws into the host application.
+
+Metrics (`increment`, `gauge`, `histogram`) and traces are not yet available.

package/dist/cjs/error-handler.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACRErrorHandler = void 0;
+const browser_1 = require("@lib-acr/browser");
+/**
+ * Angular ErrorHandler that reports uncaught errors to ACR and keeps logging them to the console. Register it with
+ * provideACR(); it replaces the default handler. HTTP failures already reported by acrHttpInterceptor are not sent
+ * again when the app leaves them unhandled.
+ */
+class ACRErrorHandler {
+    constructor(client) {
+        this.client = client;
+    }
+    handleError(error) {
+        if (!(0, browser_1.wasCaptured)(error)) {
+            this.client.captureError(error, { handled: false, source: 'frontend', attributes: { kind: 'angular' } });
+        }
+        console.error(error);
+    }
+}
+exports.ACRErrorHandler = ACRErrorHandler;
+//# sourceMappingURL=error-handler.js.map

package/dist/cjs/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/error-handler.ts"],"names":[],"mappings":";;;AAAA,8CAAgE;AAEhE;;;;GAIG;AACH,MAAa,eAAe;IAC1B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,WAAW,CAAC,KAAc;QACxB,IAAI,CAAC,IAAA,qBAAW,EAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF;AATD,0CASC"}

package/dist/cjs/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_INFO = exports.ACR_CONFIG = exports.ACR_CLIENT = exports.acrHttpInterceptor = exports.ACRErrorHandler = exports.ACRService = exports.injectACRControls = exports.injectFlag = exports.provideACR = void 0;
+var providers_js_1 = require("./providers.js");
+Object.defineProperty(exports, "provideACR", { enumerable: true, get: function () { return providers_js_1.provideACR; } });
+Object.defineProperty(exports, "injectFlag", { enumerable: true, get: function () { return providers_js_1.injectFlag; } });
+Object.defineProperty(exports, "injectACRControls", { enumerable: true, get: function () { return providers_js_1.injectACRControls; } });
+var service_js_1 = require("./service.js");
+Object.defineProperty(exports, "ACRService", { enumerable: true, get: function () { return service_js_1.ACRService; } });
+var error_handler_js_1 = require("./error-handler.js");
+Object.defineProperty(exports, "ACRErrorHandler", { enumerable: true, get: function () { return error_handler_js_1.ACRErrorHandler; } });
+var interceptor_js_1 = require("./interceptor.js");
+Object.defineProperty(exports, "acrHttpInterceptor", { enumerable: true, get: function () { return interceptor_js_1.acrHttpInterceptor; } });
+var tokens_js_1 = require("./tokens.js");
+Object.defineProperty(exports, "ACR_CLIENT", { enumerable: true, get: function () { return tokens_js_1.ACR_CLIENT; } });
+Object.defineProperty(exports, "ACR_CONFIG", { enumerable: true, get: function () { return tokens_js_1.ACR_CONFIG; } });
+__exportStar(require("@lib-acr/browser"), exports);
+var sdk_info_js_1 = require("./sdk-info.js");
+Object.defineProperty(exports, "SDK_INFO", { enumerable: true, get: function () { return sdk_info_js_1.SDK_INFO; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+CAA2E;AAAlE,0GAAA,UAAU,OAAA;AAAE,0GAAA,UAAU,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAClD,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,mDAAsD;AAA7C,oHAAA,kBAAkB,OAAA;AAC3B,yCAAqD;AAA5C,uGAAA,UAAU,OAAA;AAAE,uGAAA,UAAU,OAAA;AAE/B,mDAAiC;AACjC,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA"}

package/dist/cjs/interceptor.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acrHttpInterceptor = void 0;
+const http_1 = require("@angular/common/http");
+const core_1 = require("@angular/core");
+const browser_1 = require("@lib-acr/browser");
+const rxjs_1 = require("rxjs");
+const tokens_js_1 = require("./tokens.js");
+/**
+ * Times every HttpClient request: one `api_request` event with host, normalized path, status and duration. Server
+ * (5xx) and network failures are also reported as errors. The ACR endpoint itself is never recorded.
+ *
+ * Register it with `provideHttpClient(withInterceptors([acrHttpInterceptor]))`. If your app also uses the fetch
+ * backend, set `trackFetch: false` in provideACR() so requests are not counted twice.
+ */
+const acrHttpInterceptor = (req, next) => {
+    const client = (0, core_1.inject)(tokens_js_1.ACR_CLIENT);
+    const config = (0, core_1.inject)(tokens_js_1.ACR_CONFIG);
+    const endpoint = config.endpoint.replace(/\/+$/, '');
+    if (config.trackHttp === false || req.url.startsWith(endpoint))
+        return next(req);
+    const described = describe(req.url);
+    const started = performance.now();
+    const elapsed = () => Math.round((performance.now() - started) * 100) / 100;
+    return next(req).pipe((0, rxjs_1.tap)({
+        next: (event) => {
+            if (event instanceof http_1.HttpResponse) {
+                client.trackEvent('api_request', {
+                    method: req.method,
+                    host: described.host,
+                    path: described.path,
+                    status: event.status,
+                    ok: true,
+                    durationMs: elapsed(),
+                });
+            }
+        },
+        error: (err) => {
+            const status = err instanceof http_1.HttpErrorResponse ? err.status : 0;
+            client.trackEvent('api_request', {
+                method: req.method,
+                host: described.host,
+                path: described.path,
+                status,
+                ok: false,
+                durationMs: elapsed(),
+            });
+            if (status === 0 || status >= 500) {
+                client.captureError(err, {
+                    handled: false,
+                    source: 'frontend',
+                    attributes: { kind: status === 0 ? 'network' : 'server', method: req.method, host: described.host, path: described.path, status },
+                });
+                (0, browser_1.markCaptured)(err);
+            }
+        },
+    }));
+};
+exports.acrHttpInterceptor = acrHttpInterceptor;
+function describe(url) {
+    try {
+        const parsed = new URL(url, globalThis.location?.href ?? 'http://localhost/');
+        return { host: parsed.host, path: (0, browser_1.normalizePath)(parsed.pathname) };
+    }
+    catch {
+        return { host: 'unknown', path: '/' };
+    }
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/cjs/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/interceptor.ts"],"names":[],"mappings":";;;AAAA,+CAAqG;AACrG,wCAAuC;AACvC,8CAA+D;AAC/D,+BAAuC;AACvC,2CAAqD;AAErD;;;;;;GAMG;AACI,MAAM,kBAAkB,GAAsB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IACjE,MAAM,MAAM,GAAG,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAEjF,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAE5E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CACnB,IAAA,UAAG,EAAC;QACF,IAAI,EAAE,CAAC,KAAyB,EAAE,EAAE;YAClC,IAAI,KAAK,YAAY,mBAAY,EAAE,CAAC;gBAClC,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE;oBAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,EAAE,EAAE,IAAI;oBACR,UAAU,EAAE,OAAO,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,KAAK,EAAE,CAAC,GAAY,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,GAAG,YAAY,wBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE;gBAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM;gBACN,EAAE,EAAE,KAAK;gBACT,UAAU,EAAE,OAAO,EAAE;aACtB,CAAC,CAAC;YACH,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAClC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE;oBACvB,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,UAAU;oBAClB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE;iBAClI,CAAC,CAAC;gBACH,IAAA,sBAAY,EAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC,CAC+B,CAAC;AACtC,CAAC,CAAC;AA7CW,QAAA,kBAAkB,sBA6C7B;AAEF,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,IAAI,mBAAmB,CAAC,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/cjs/providers.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provideACR = provideACR;
+exports.injectFlag = injectFlag;
+exports.injectACRControls = injectACRControls;
+const core_1 = require("@angular/core");
+const browser_1 = require("@lib-acr/browser");
+const error_handler_js_1 = require("./error-handler.js");
+const service_js_1 = require("./service.js");
+const tokens_js_1 = require("./tokens.js");
+const sdk_info_js_1 = require("./sdk-info.js");
+/**
+ * Registers ACR for the application: a single BrowserACR, ACRService, an ErrorHandler that reports uncaught errors,
+ * and automatic start and stop tied to the application's lifetime. Add provideACRRouterTracking() from
+ * `@lib-acr/angular/router` to record page views.
+ *
+ * @example
+ * export const appConfig = { providers: [provideACR({ apiKey: environment.acrApiKey, endpoint: environment.acrEndpoint })] };
+ */
+function provideACR(options) {
+    return (0, core_1.makeEnvironmentProviders)([
+        { provide: tokens_js_1.ACR_CONFIG, useValue: options },
+        { provide: tokens_js_1.ACR_CLIENT, useFactory: () => new browser_1.BrowserACR((0, core_1.inject)(tokens_js_1.ACR_CONFIG), sdk_info_js_1.SDK_INFO) },
+        { provide: service_js_1.ACRService, useFactory: () => new service_js_1.ACRService((0, core_1.inject)(tokens_js_1.ACR_CLIENT), (0, core_1.inject)(core_1.DestroyRef)) },
+        { provide: core_1.ErrorHandler, useFactory: () => new error_handler_js_1.ACRErrorHandler((0, core_1.inject)(tokens_js_1.ACR_CLIENT)) },
+        (0, core_1.provideEnvironmentInitializer)(() => {
+            const client = (0, core_1.inject)(tokens_js_1.ACR_CLIENT);
+            client.start();
+            (0, core_1.inject)(core_1.DestroyRef).onDestroy(() => {
+                client.stop();
+                void client.flush();
+            });
+        }),
+    ]);
+}
+/**
+ * A feature flag as a signal. Call it in an injection context (a component field initialiser or constructor). Angular
+ * templates use it with built-in control flow, which replaces a `*acrFlag` directive:
+ *
+ * @example
+ * readonly newCheckout = injectFlag('new-checkout', false);
+ * // @if (newCheckout()) { <new-checkout /> } @else { <old-checkout /> }
+ */
+function injectFlag(key, fallback) {
+    return (0, core_1.inject)(service_js_1.ACRService).flagSignal(key, fallback);
+}
+/** The remote-control state as a signal. Call it in an injection context. */
+function injectACRControls() {
+    return (0, core_1.inject)(service_js_1.ACRService).controls;
+}
+//# sourceMappingURL=providers.js.map

package/dist/cjs/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/providers.ts"],"names":[],"mappings":";;AAuBA,gCAeC;AAUD,gCAEC;AAGD,8CAEC;AAvDD,wCAQuB;AACvB,8CAAiE;AACjE,yDAAqD;AACrD,6CAA0C;AAC1C,2CAA6E;AAC7E,+CAAyC;AAEzC;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,OAA0B;IACnD,OAAO,IAAA,+BAAwB,EAAC;QAC9B,EAAE,OAAO,EAAE,sBAAU,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC1C,EAAE,OAAO,EAAE,sBAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAU,CAAC,IAAA,aAAM,EAAC,sBAAU,CAAC,EAAE,sBAAQ,CAAC,EAAE;QACvF,EAAE,OAAO,EAAE,uBAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAU,CAAC,IAAA,aAAM,EAAC,sBAAU,CAAC,EAAE,IAAA,aAAM,EAAC,iBAAU,CAAC,CAAC,EAAE;QACjG,EAAE,OAAO,EAAE,mBAAY,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,kCAAe,CAAC,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC,EAAE;QACpF,IAAA,oCAA6B,EAAC,GAAG,EAAE;YACjC,MAAM,MAAM,GAAG,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAA,aAAM,EAAC,iBAAU,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;gBAChC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAI,GAAW,EAAE,QAAW;IACpD,OAAO,IAAA,aAAM,EAAC,uBAAU,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,6EAA6E;AAC7E,SAAgB,iBAAiB;IAC/B,OAAO,IAAA,aAAM,EAAC,uBAAU,CAAC,CAAC,QAAQ,CAAC;AACrC,CAAC"}

package/dist/cjs/router.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acrMaintenanceGuard = void 0;
+exports.provideACRRouterTracking = provideACRRouterTracking;
+exports.acrMaintenanceGuardWith = acrMaintenanceGuardWith;
+const core_1 = require("@angular/core");
+const router_1 = require("@angular/router");
+const rxjs_1 = require("rxjs");
+const tokens_js_1 = require("./tokens.js");
+/**
+ * Records a page view for every completed navigation. Exported from `@lib-acr/angular/router` so apps without
+ * @angular/router never load it. Add it next to provideACR() and provideRouter().
+ */
+function provideACRRouterTracking() {
+    return (0, core_1.makeEnvironmentProviders)([
+        (0, core_1.provideEnvironmentInitializer)(() => {
+            const client = (0, core_1.inject)(tokens_js_1.ACR_CLIENT);
+            const router = (0, core_1.inject)(router_1.Router);
+            const sub = router.events
+                .pipe((0, rxjs_1.filter)((event) => event instanceof router_1.NavigationEnd))
+                .subscribe((event) => client.trackPageView(event.urlAfterRedirects));
+            (0, core_1.inject)(core_1.DestroyRef).onDestroy(() => sub.unsubscribe());
+        }),
+    ]);
+}
+/**
+ * Route guard that blocks navigation while maintenance applies to the current visitor (users in `allowUserIds` pass).
+ * The decision uses the last snapshot, so navigations before the first snapshot pass; the built-in maintenance screen
+ * covers the page as soon as it arrives.
+ *
+ * @example
+ * { path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuard] }
+ * { path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuardWith({ redirectTo: '/maintenance' })] }
+ */
+const acrMaintenanceGuard = () => !(0, core_1.inject)(tokens_js_1.ACR_CLIENT).getControlState().maintenance.active;
+exports.acrMaintenanceGuard = acrMaintenanceGuard;
+/** acrMaintenanceGuard with a redirect instead of `false`. */
+function acrMaintenanceGuardWith(options = {}) {
+    return () => {
+        if (!(0, core_1.inject)(tokens_js_1.ACR_CLIENT).getControlState().maintenance.active)
+            return true;
+        const target = options.redirectTo;
+        if (target === undefined)
+            return false;
+        return typeof target === 'string' ? (0, core_1.inject)(router_1.Router).parseUrl(target) : target;
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/cjs/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":";;;AASA,4DAWC;AAmBD,0DAOC;AA9CD,wCAAkI;AAClI,4CAAqF;AACrF,+BAA8B;AAC9B,2CAAyC;AAEzC;;;GAGG;AACH,SAAgB,wBAAwB;IACtC,OAAO,IAAA,+BAAwB,EAAC;QAC9B,IAAA,oCAA6B,EAAC,GAAG,EAAE;YACjC,MAAM,MAAM,GAAG,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,IAAA,aAAM,EAAC,eAAM,CAAC,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM;iBACtB,IAAI,CAAC,IAAA,aAAM,EAAC,CAAC,KAAK,EAA0B,EAAE,CAAC,KAAK,YAAY,sBAAa,CAAC,CAAC;iBAC/E,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvE,IAAA,aAAM,EAAC,iBAAU,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAOD;;;;;;;;GAQG;AACI,MAAM,mBAAmB,GAAkB,GAAG,EAAE,CAAC,CAAC,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;AAApG,QAAA,mBAAmB,uBAAiF;AAEjH,8DAA8D;AAC9D,SAAgB,uBAAuB,CAAC,UAAsC,EAAE;IAC9E,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,IAAA,aAAM,EAAC,sBAAU,CAAC,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,aAAM,EAAC,eAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/sdk-info.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_INFO = void 0;
+// Generated by scripts/sync-sdk-info.mjs from package.json. Do not edit by hand.
+exports.SDK_INFO = { name: '@lib-acr/angular', version: '0.0.1' };
+//# sourceMappingURL=sdk-info.js.map

package/dist/cjs/sdk-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-info.js","sourceRoot":"","sources":["../../src/sdk-info.ts"],"names":[],"mappings":";;;AAAA,iFAAiF;AACpE,QAAA,QAAQ,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC"}

package/dist/cjs/service.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACRService = void 0;
+const core_1 = require("@angular/core");
+const rxjs_1 = require("rxjs");
+/**
+ * Injectable facade over the client. Inject it with `inject(ACRService)` or as a constructor parameter. It is a plain
+ * class, so the library ships without decorators and works with AOT builds.
+ */
+class ACRService {
+    constructor(client, destroyRef) {
+        this.client = client;
+        this.state = (0, core_1.signal)(client.getControlState());
+        this.controls = this.state.asReadonly();
+        const off = client.onControlChange((state) => this.state.set(state));
+        destroyRef?.onDestroy(off);
+    }
+    /**
+     * Current value of a feature flag for this visitor. Returns `fallback` before the first snapshot and when the flag
+     * is missing, disabled or served with another type. Use flagSignal() in templates so the view updates.
+     */
+    flag(key, fallback) {
+        return this.client.flag(key, fallback);
+    }
+    /**
+     * A flag as a signal, for templates and computed():
+     *
+     * @example
+     * readonly newCheckout = inject(ACRService).flagSignal('new-checkout', false);
+     * // template: @if (newCheckout()) { <new-checkout /> } @else { <old-checkout /> }
+     */
+    flagSignal(key, fallback) {
+        return (0, core_1.computed)(() => {
+            this.state();
+            return this.client.flag(key, fallback);
+        });
+    }
+    /** A flag as an observable that emits the current value, then every change. */
+    flag$(key, fallback) {
+        return new rxjs_1.Observable((subscriber) => {
+            subscriber.next(this.client.flag(key, fallback));
+            return this.client.onControlChange(() => subscriber.next(this.client.flag(key, fallback)));
+        }).pipe((0, rxjs_1.distinctUntilChanged)());
+    }
+    /** Every flag evaluated for this visitor. */
+    flags() {
+        return this.client.flags();
+    }
+    /** Hides the announcement for this visitor (remembered per id). */
+    dismissAnnouncement(id) {
+        this.client.dismissAnnouncement(id);
+    }
+    /** Fetches the control snapshot now. */
+    refreshControl() {
+        return this.client.refreshControl();
+    }
+    trackEvent(name, attributes) {
+        this.client.trackEvent(name, attributes);
+    }
+    log(level, message, attributes) {
+        this.client.log(level, message, attributes);
+    }
+    captureError(error, options) {
+        this.client.captureError(error, options);
+    }
+    identify(userId) {
+        this.client.identify(userId);
+    }
+    trackPageView(path) {
+        this.client.trackPageView(path);
+    }
+    /**
+     * Forgets the current visitor, for example on logout: clears the user id, replaces the anonymous id and starts a new
+     * session.
+     */
+    reset() {
+        this.client.reset();
+    }
+    /** Stops collection, discards unsent telemetry and remembers the choice on this browser. */
+    optOut() {
+        this.client.optOut();
+    }
+    /** Resumes collection after optOut(). */
+    optIn() {
+        this.client.optIn();
+    }
+    flush() {
+        return this.client.flush();
+    }
+    /** The underlying client, for web vitals and other browser-level APIs. */
+    get raw() {
+        return this.client;
+    }
+}
+exports.ACRService = ACRService;
+//# sourceMappingURL=service.js.map

package/dist/cjs/service.js.map

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

package/dist/cjs/tokens.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACR_CLIENT = exports.ACR_CONFIG = void 0;
+const core_1 = require("@angular/core");
+exports.ACR_CONFIG = new core_1.InjectionToken('ACR_CONFIG');
+exports.ACR_CLIENT = new core_1.InjectionToken('ACR_CLIENT');
+//# sourceMappingURL=tokens.js.map

package/dist/cjs/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/tokens.ts"],"names":[],"mappings":";;;AAAA,wCAA+C;AASlC,QAAA,UAAU,GAAG,IAAI,qBAAc,CAAoB,YAAY,CAAC,CAAC;AACjE,QAAA,UAAU,GAAG,IAAI,qBAAc,CAAa,YAAY,CAAC,CAAC"}

package/dist/esm/error-handler.js

@@ -0,0 +1,18 @@
+import { wasCaptured } from '@lib-acr/browser';
+/**
+ * Angular ErrorHandler that reports uncaught errors to ACR and keeps logging them to the console. Register it with
+ * provideACR(); it replaces the default handler. HTTP failures already reported by acrHttpInterceptor are not sent
+ * again when the app leaves them unhandled.
+ */
+export class ACRErrorHandler {
+    constructor(client) {
+        this.client = client;
+    }
+    handleError(error) {
+        if (!wasCaptured(error)) {
+            this.client.captureError(error, { handled: false, source: 'frontend', attributes: { kind: 'angular' } });
+        }
+        console.error(error);
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/esm/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,kBAAkB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAC1B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,WAAW,CAAC,KAAc;QACxB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+export { provideACR, injectFlag, injectACRControls } from './providers.js';
+export { ACRService } from './service.js';
+export { ACRErrorHandler } from './error-handler.js';
+export { acrHttpInterceptor } from './interceptor.js';
+export { ACR_CLIENT, ACR_CONFIG } from './tokens.js';
+export * from '@lib-acr/browser';
+export { SDK_INFO } from './sdk-info.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/interceptor.js

@@ -0,0 +1,65 @@
+import { HttpErrorResponse, HttpResponse } from '@angular/common/http';
+import { inject } from '@angular/core';
+import { markCaptured, normalizePath } from '@lib-acr/browser';
+import { tap } from 'rxjs';
+import { ACR_CLIENT, ACR_CONFIG } from './tokens.js';
+/**
+ * Times every HttpClient request: one `api_request` event with host, normalized path, status and duration. Server
+ * (5xx) and network failures are also reported as errors. The ACR endpoint itself is never recorded.
+ *
+ * Register it with `provideHttpClient(withInterceptors([acrHttpInterceptor]))`. If your app also uses the fetch
+ * backend, set `trackFetch: false` in provideACR() so requests are not counted twice.
+ */
+export const acrHttpInterceptor = (req, next) => {
+    const client = inject(ACR_CLIENT);
+    const config = inject(ACR_CONFIG);
+    const endpoint = config.endpoint.replace(/\/+$/, '');
+    if (config.trackHttp === false || req.url.startsWith(endpoint))
+        return next(req);
+    const described = describe(req.url);
+    const started = performance.now();
+    const elapsed = () => Math.round((performance.now() - started) * 100) / 100;
+    return next(req).pipe(tap({
+        next: (event) => {
+            if (event instanceof HttpResponse) {
+                client.trackEvent('api_request', {
+                    method: req.method,
+                    host: described.host,
+                    path: described.path,
+                    status: event.status,
+                    ok: true,
+                    durationMs: elapsed(),
+                });
+            }
+        },
+        error: (err) => {
+            const status = err instanceof HttpErrorResponse ? err.status : 0;
+            client.trackEvent('api_request', {
+                method: req.method,
+                host: described.host,
+                path: described.path,
+                status,
+                ok: false,
+                durationMs: elapsed(),
+            });
+            if (status === 0 || status >= 500) {
+                client.captureError(err, {
+                    handled: false,
+                    source: 'frontend',
+                    attributes: { kind: status === 0 ? 'network' : 'server', method: req.method, host: described.host, path: described.path, status },
+                });
+                markCaptured(err);
+            }
+        },
+    }));
+};
+function describe(url) {
+    try {
+        const parsed = new URL(url, globalThis.location?.href ?? 'http://localhost/');
+        return { host: parsed.host, path: normalizePath(parsed.pathname) };
+    }
+    catch {
+        return { host: 'unknown', path: '/' };
+    }
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/esm/interceptor.js.map

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

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/providers.js

@@ -0,0 +1,46 @@
+import { DestroyRef, ErrorHandler, inject, makeEnvironmentProviders, provideEnvironmentInitializer, } from '@angular/core';
+import { BrowserACR } from '@lib-acr/browser';
+import { ACRErrorHandler } from './error-handler.js';
+import { ACRService } from './service.js';
+import { ACR_CLIENT, ACR_CONFIG } from './tokens.js';
+import { SDK_INFO } from './sdk-info.js';
+/**
+ * Registers ACR for the application: a single BrowserACR, ACRService, an ErrorHandler that reports uncaught errors,
+ * and automatic start and stop tied to the application's lifetime. Add provideACRRouterTracking() from
+ * `@lib-acr/angular/router` to record page views.
+ *
+ * @example
+ * export const appConfig = { providers: [provideACR({ apiKey: environment.acrApiKey, endpoint: environment.acrEndpoint })] };
+ */
+export function provideACR(options) {
+    return makeEnvironmentProviders([
+        { provide: ACR_CONFIG, useValue: options },
+        { provide: ACR_CLIENT, useFactory: () => new BrowserACR(inject(ACR_CONFIG), SDK_INFO) },
+        { provide: ACRService, useFactory: () => new ACRService(inject(ACR_CLIENT), inject(DestroyRef)) },
+        { provide: ErrorHandler, useFactory: () => new ACRErrorHandler(inject(ACR_CLIENT)) },
+        provideEnvironmentInitializer(() => {
+            const client = inject(ACR_CLIENT);
+            client.start();
+            inject(DestroyRef).onDestroy(() => {
+                client.stop();
+                void client.flush();
+            });
+        }),
+    ]);
+}
+/**
+ * A feature flag as a signal. Call it in an injection context (a component field initialiser or constructor). Angular
+ * templates use it with built-in control flow, which replaces a `*acrFlag` directive:
+ *
+ * @example
+ * readonly newCheckout = injectFlag('new-checkout', false);
+ * // @if (newCheckout()) { <new-checkout /> } @else { <old-checkout /> }
+ */
+export function injectFlag(key, fallback) {
+    return inject(ACRService).flagSignal(key, fallback);
+}
+/** The remote-control state as a signal. Call it in an injection context. */
+export function injectACRControls() {
+    return inject(ACRService).controls;
+}
+//# sourceMappingURL=providers.js.map

package/dist/esm/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,YAAY,EACZ,MAAM,EACN,wBAAwB,EACxB,6BAA6B,GAE9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,OAAO,wBAAwB,CAAC;QAC9B,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC1C,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,EAAE;QACvF,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE;QACjG,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE;QACpF,6BAA6B,CAAC,GAAG,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;gBAChC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAI,GAAW,EAAE,QAAW;IACpD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC;AACrC,CAAC"}

package/dist/esm/router.js

@@ -0,0 +1,42 @@
+import { DestroyRef, inject, makeEnvironmentProviders, provideEnvironmentInitializer } from '@angular/core';
+import { NavigationEnd, Router } from '@angular/router';
+import { filter } from 'rxjs';
+import { ACR_CLIENT } from './tokens.js';
+/**
+ * Records a page view for every completed navigation. Exported from `@lib-acr/angular/router` so apps without
+ * @angular/router never load it. Add it next to provideACR() and provideRouter().
+ */
+export function provideACRRouterTracking() {
+    return makeEnvironmentProviders([
+        provideEnvironmentInitializer(() => {
+            const client = inject(ACR_CLIENT);
+            const router = inject(Router);
+            const sub = router.events
+                .pipe(filter((event) => event instanceof NavigationEnd))
+                .subscribe((event) => client.trackPageView(event.urlAfterRedirects));
+            inject(DestroyRef).onDestroy(() => sub.unsubscribe());
+        }),
+    ]);
+}
+/**
+ * Route guard that blocks navigation while maintenance applies to the current visitor (users in `allowUserIds` pass).
+ * The decision uses the last snapshot, so navigations before the first snapshot pass; the built-in maintenance screen
+ * covers the page as soon as it arrives.
+ *
+ * @example
+ * { path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuard] }
+ * { path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuardWith({ redirectTo: '/maintenance' })] }
+ */
+export const acrMaintenanceGuard = () => !inject(ACR_CLIENT).getControlState().maintenance.active;
+/** acrMaintenanceGuard with a redirect instead of `false`. */
+export function acrMaintenanceGuardWith(options = {}) {
+    return () => {
+        if (!inject(ACR_CLIENT).getControlState().maintenance.active)
+            return true;
+        const target = options.redirectTo;
+        if (target === undefined)
+            return false;
+        return typeof target === 'string' ? inject(Router).parseUrl(target) : target;
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/esm/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwB,MAAM,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAClI,OAAO,EAAE,aAAa,EAAE,MAAM,EAA+B,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,wBAAwB,CAAC;QAC9B,6BAA6B,CAAC,GAAG,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM;iBACtB,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAA0B,EAAE,CAAC,KAAK,YAAY,aAAa,CAAC,CAAC;iBAC/E,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAOD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;AAEjH,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB,CAAC,UAAsC,EAAE;IAC9E,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/sdk-info.js

@@ -0,0 +1,3 @@
+// Generated by scripts/sync-sdk-info.mjs from package.json. Do not edit by hand.
+export const SDK_INFO = { name: '@lib-acr/angular', version: '0.0.1' };
+//# sourceMappingURL=sdk-info.js.map

package/dist/esm/sdk-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-info.js","sourceRoot":"","sources":["../../src/sdk-info.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC"}

package/dist/esm/service.js

@@ -0,0 +1,92 @@
+import { computed, signal } from '@angular/core';
+import { Observable, distinctUntilChanged } from 'rxjs';
+/**
+ * Injectable facade over the client. Inject it with `inject(ACRService)` or as a constructor parameter. It is a plain
+ * class, so the library ships without decorators and works with AOT builds.
+ */
+export class ACRService {
+    constructor(client, destroyRef) {
+        this.client = client;
+        this.state = signal(client.getControlState());
+        this.controls = this.state.asReadonly();
+        const off = client.onControlChange((state) => this.state.set(state));
+        destroyRef?.onDestroy(off);
+    }
+    /**
+     * Current value of a feature flag for this visitor. Returns `fallback` before the first snapshot and when the flag
+     * is missing, disabled or served with another type. Use flagSignal() in templates so the view updates.
+     */
+    flag(key, fallback) {
+        return this.client.flag(key, fallback);
+    }
+    /**
+     * A flag as a signal, for templates and computed():
+     *
+     * @example
+     * readonly newCheckout = inject(ACRService).flagSignal('new-checkout', false);
+     * // template: @if (newCheckout()) { <new-checkout /> } @else { <old-checkout /> }
+     */
+    flagSignal(key, fallback) {
+        return computed(() => {
+            this.state();
+            return this.client.flag(key, fallback);
+        });
+    }
+    /** A flag as an observable that emits the current value, then every change. */
+    flag$(key, fallback) {
+        return new Observable((subscriber) => {
+            subscriber.next(this.client.flag(key, fallback));
+            return this.client.onControlChange(() => subscriber.next(this.client.flag(key, fallback)));
+        }).pipe(distinctUntilChanged());
+    }
+    /** Every flag evaluated for this visitor. */
+    flags() {
+        return this.client.flags();
+    }
+    /** Hides the announcement for this visitor (remembered per id). */
+    dismissAnnouncement(id) {
+        this.client.dismissAnnouncement(id);
+    }
+    /** Fetches the control snapshot now. */
+    refreshControl() {
+        return this.client.refreshControl();
+    }
+    trackEvent(name, attributes) {
+        this.client.trackEvent(name, attributes);
+    }
+    log(level, message, attributes) {
+        this.client.log(level, message, attributes);
+    }
+    captureError(error, options) {
+        this.client.captureError(error, options);
+    }
+    identify(userId) {
+        this.client.identify(userId);
+    }
+    trackPageView(path) {
+        this.client.trackPageView(path);
+    }
+    /**
+     * Forgets the current visitor, for example on logout: clears the user id, replaces the anonymous id and starts a new
+     * session.
+     */
+    reset() {
+        this.client.reset();
+    }
+    /** Stops collection, discards unsent telemetry and remembers the choice on this browser. */
+    optOut() {
+        this.client.optOut();
+    }
+    /** Resumes collection after optOut(). */
+    optIn() {
+        this.client.optIn();
+    }
+    flush() {
+        return this.client.flush();
+    }
+    /** The underlying client, for web vitals and other browser-level APIs. */
+    get raw() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/esm/service.js.map

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

package/dist/esm/tokens.js

@@ -0,0 +1,4 @@
+import { InjectionToken } from '@angular/core';
+export const ACR_CONFIG = new InjectionToken('ACR_CONFIG');
+export const ACR_CLIENT = new InjectionToken('ACR_CLIENT');
+//# sourceMappingURL=tokens.js.map

package/dist/esm/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAS/C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,cAAc,CAAoB,YAAY,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,cAAc,CAAa,YAAY,CAAC,CAAC"}

package/dist/types/error-handler.d.ts

@@ -0,0 +1,11 @@
+import { type BrowserACR } from '@lib-acr/browser';
+/**
+ * Angular ErrorHandler that reports uncaught errors to ACR and keeps logging them to the console. Register it with
+ * provideACR(); it replaces the default handler. HTTP failures already reported by acrHttpInterceptor are not sent
+ * again when the app leaves them unhandled.
+ */
+export declare class ACRErrorHandler {
+    private readonly client;
+    constructor(client: BrowserACR);
+    handleError(error: unknown): void;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export { provideACR, injectFlag, injectACRControls } from './providers.js';
+export { ACRService } from './service.js';
+export { ACRErrorHandler } from './error-handler.js';
+export { acrHttpInterceptor } from './interceptor.js';
+export { ACR_CLIENT, ACR_CONFIG } from './tokens.js';
+export type { AngularAcrOptions } from './tokens.js';
+export * from '@lib-acr/browser';
+export { SDK_INFO } from './sdk-info.js';

package/dist/types/interceptor.d.ts

@@ -0,0 +1,9 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+/**
+ * Times every HttpClient request: one `api_request` event with host, normalized path, status and duration. Server
+ * (5xx) and network failures are also reported as errors. The ACR endpoint itself is never recorded.
+ *
+ * Register it with `provideHttpClient(withInterceptors([acrHttpInterceptor]))`. If your app also uses the fetch
+ * backend, set `trackFetch: false` in provideACR() so requests are not counted twice.
+ */
+export declare const acrHttpInterceptor: HttpInterceptorFn;

package/dist/types/providers.d.ts

@@ -0,0 +1,23 @@
+import { EnvironmentProviders, type Signal } from '@angular/core';
+import { type ControlState } from '@lib-acr/browser';
+import { type AngularAcrOptions } from './tokens.js';
+/**
+ * Registers ACR for the application: a single BrowserACR, ACRService, an ErrorHandler that reports uncaught errors,
+ * and automatic start and stop tied to the application's lifetime. Add provideACRRouterTracking() from
+ * `@lib-acr/angular/router` to record page views.
+ *
+ * @example
+ * export const appConfig = { providers: [provideACR({ apiKey: environment.acrApiKey, endpoint: environment.acrEndpoint })] };
+ */
+export declare function provideACR(options: AngularAcrOptions): EnvironmentProviders;
+/**
+ * A feature flag as a signal. Call it in an injection context (a component field initialiser or constructor). Angular
+ * templates use it with built-in control flow, which replaces a `*acrFlag` directive:
+ *
+ * @example
+ * readonly newCheckout = injectFlag('new-checkout', false);
+ * // @if (newCheckout()) { <new-checkout /> } @else { <old-checkout /> }
+ */
+export declare function injectFlag<T>(key: string, fallback: T): Signal<T>;
+/** The remote-control state as a signal. Call it in an injection context. */
+export declare function injectACRControls(): Signal<ControlState>;

package/dist/types/router.d.ts

@@ -0,0 +1,23 @@
+import { EnvironmentProviders } from '@angular/core';
+import { UrlTree, type CanActivateFn } from '@angular/router';
+/**
+ * Records a page view for every completed navigation. Exported from `@lib-acr/angular/router` so apps without
+ * @angular/router never load it. Add it next to provideACR() and provideRouter().
+ */
+export declare function provideACRRouterTracking(): EnvironmentProviders;
+export interface ACRMaintenanceGuardOptions {
+    /** Where to send visitors while maintenance applies to them, for example '/maintenance'. Without it the guard returns false. */
+    redirectTo?: string | UrlTree;
+}
+/**
+ * Route guard that blocks navigation while maintenance applies to the current visitor (users in `allowUserIds` pass).
+ * The decision uses the last snapshot, so navigations before the first snapshot pass; the built-in maintenance screen
+ * covers the page as soon as it arrives.
+ *
+ * @example
+ * { path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuard] }
+ * { path: 'checkout', component: CheckoutPage, canActivate: [acrMaintenanceGuardWith({ redirectTo: '/maintenance' })] }
+ */
+export declare const acrMaintenanceGuard: CanActivateFn;
+/** acrMaintenanceGuard with a redirect instead of `false`. */
+export declare function acrMaintenanceGuardWith(options?: ACRMaintenanceGuardOptions): CanActivateFn;

package/dist/types/sdk-info.d.ts

@@ -0,0 +1,4 @@
+export declare const SDK_INFO: {
+    readonly name: "@lib-acr/angular";
+    readonly version: "0.0.1";
+};

package/dist/types/service.d.ts

@@ -0,0 +1,56 @@
+import { type DestroyRef, type Signal } from '@angular/core';
+import { Observable } from 'rxjs';
+import type { Attributes, ControlState, ErrorOptions, LogLevel } from '@lib-acr/core';
+import type { BrowserACR } from '@lib-acr/browser';
+/**
+ * Injectable facade over the client. Inject it with `inject(ACRService)` or as a constructor parameter. It is a plain
+ * class, so the library ships without decorators and works with AOT builds.
+ */
+export declare class ACRService {
+    private readonly client;
+    private readonly state;
+    /**
+     * Remote-control state (maintenance, announcement, release, flags, revision) as a signal. Updated when the snapshot
+     * or the identified user changes.
+     */
+    readonly controls: Signal<ControlState>;
+    constructor(client: BrowserACR, destroyRef?: DestroyRef);
+    /**
+     * Current value of a feature flag for this visitor. Returns `fallback` before the first snapshot and when the flag
+     * is missing, disabled or served with another type. Use flagSignal() in templates so the view updates.
+     */
+    flag<T>(key: string, fallback: T): T;
+    /**
+     * A flag as a signal, for templates and computed():
+     *
+     * @example
+     * readonly newCheckout = inject(ACRService).flagSignal('new-checkout', false);
+     * // template: @if (newCheckout()) { <new-checkout /> } @else { <old-checkout /> }
+     */
+    flagSignal<T>(key: string, fallback: T): Signal<T>;
+    /** A flag as an observable that emits the current value, then every change. */
+    flag$<T>(key: string, fallback: T): Observable<T>;
+    /** Every flag evaluated for this visitor. */
+    flags(): Record<string, unknown>;
+    /** Hides the announcement for this visitor (remembered per id). */
+    dismissAnnouncement(id: string): void;
+    /** Fetches the control snapshot now. */
+    refreshControl(): Promise<void>;
+    trackEvent(name: string, attributes?: Attributes): void;
+    log(level: LogLevel, message: string, attributes?: Attributes): void;
+    captureError(error: unknown, options?: ErrorOptions): void;
+    identify(userId: string | null): void;
+    trackPageView(path?: string): void;
+    /**
+     * Forgets the current visitor, for example on logout: clears the user id, replaces the anonymous id and starts a new
+     * session.
+     */
+    reset(): void;
+    /** Stops collection, discards unsent telemetry and remembers the choice on this browser. */
+    optOut(): void;
+    /** Resumes collection after optOut(). */
+    optIn(): void;
+    flush(): Promise<void>;
+    /** The underlying client, for web vitals and other browser-level APIs. */
+    get raw(): BrowserACR;
+}

package/dist/types/tokens.d.ts

@@ -0,0 +1,9 @@
+import { InjectionToken } from '@angular/core';
+import type { BrowserACR, BrowserAcrOptions } from '@lib-acr/browser';
+/** Options given to provideACR(). Injected by the other providers. */
+export interface AngularAcrOptions extends BrowserAcrOptions {
+    /** Time HttpClient requests through acrHttpInterceptor. Default true. */
+    trackHttp?: boolean;
+}
+export declare const ACR_CONFIG: InjectionToken<AngularAcrOptions>;
+export declare const ACR_CLIENT: InjectionToken<BrowserACR>;

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@lib-acr/angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "ACR SDK for Angular: provideACR(), an ErrorHandler, an HttpClient interceptor and router page tracking.",
+  "license": "MIT",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./router": {
+      "types": "./dist/types/router.d.ts",
+      "import": "./dist/esm/router.js",
+      "require": "./dist/cjs/router.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.17"
+  },
+  "dependencies": {
+    "@lib-acr/browser": "0.0.1",
+    "@lib-acr/core": "0.0.1"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=19.0.0 <22",
+    "@angular/core": ">=19.0.0 <22",
+    "@angular/router": ">=19.0.0 <22",
+    "rxjs": "^7.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@angular/router": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/common": "^20.3.0",
+    "@angular/core": "^20.3.0",
+    "@angular/platform-browser": "^20.3.0",
+    "@angular/router": "^20.3.0",
+    "rxjs": "^7.8.2",
+    "zone.js": "~0.15.0",
+    "@angular/compiler": "^20.3.0"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/application-control-room/application.git",
+    "directory": "packages/angular"
+  },
+  "homepage": "https://github.com/application-control-room/application/tree/main/packages/angular#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}