@theplaintheory/angular 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
-
-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.
+# @theplaintheory/angular
+
+Angular bindings for [Plain Theory](https://www.theplaintheory.in) consent: a signals service, `providePlainConsent()` and the `*plainConsentAllowed` directive, with types. Angular 17.1 and later, standalone, SSR-safe.
+
+```bash
+npm install @theplaintheory/angular
+```
+
+## Set up
+
+```ts
+// main.ts
+import { bootstrapApplication } from "@angular/platform-browser";
+import { providePlainConsent } from "@theplaintheory/angular";
+import { App } from "./app/app";
+
+bootstrapApplication(App, { providers: [providePlainConsent({ siteKey: "pk_YOUR_SITE_KEY" })] });
+```
+
+For trackers written into your HTML, also put the script tag first in `<head>` in `index.html` (from the dashboard's **Install** page); the provider detects it and doesn't add a second copy. During server rendering nothing is loaded and the state stays `null`.
+
+## Use it
+
+```ts
+import { Component, inject } from "@angular/core";
+import { PlainConsentAllowedDirective, PlainConsentService } from "@theplaintheory/angular";
+
+@Component({
+  selector: "app-video",
+  imports: [PlainConsentAllowedDirective],
+  template: `
+    <iframe *plainConsentAllowed="'marketing'; else blocked" src="https://www.youtube.com/embed/…" title="Video"></iframe>
+    <ng-template #blocked><p>Allow marketing cookies to watch this video.</p></ng-template>
+    <button type="button" (click)="consent.open()">Privacy choices</button>
+  `,
+})
+export class VideoComponent {
+  readonly consent = inject(PlainConsentService);
+  readonly analytics = this.consent.allowed("analytics"); // Signal<boolean>
+}
+```
+
+`PlainConsentService`: `state` and `ready` signals, `allowed(category)` returning a signal, and `acceptAll`, `rejectAll`, `set`, `open`, `revoke`, `setLanguage`, `init`. Everything from [`@theplaintheory/consent`](https://www.npmjs.com/package/@theplaintheory/consent) is re-exported.
+
+MIT · [Docs](https://www.theplaintheory.in/docs#frameworks)

package/fesm2022/theplaintheory-angular.mjs

@@ -0,0 +1,117 @@
+import * as i0 from '@angular/core';
+import { inject, PLATFORM_ID, signal, computed, Injectable, TemplateRef, ViewContainerRef, input, effect, Directive, makeEnvironmentProviders, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
+import { consentActions, consentStore, loadPlainConsent, isAllowed } from '@theplaintheory/consent';
+export { getConsent, isAllowed, loadPlainConsent, loadScriptWhenAllowed, onConsentChange, whenAllowed } from '@theplaintheory/consent';
+
+/**
+ * Plain Theory consent as Angular signals. SSR-safe: on the server the state stays null and nothing
+ * is loaded. Load the script with `providePlainConsent({ siteKey })` in your app config, or call
+ * `init()` yourself.
+ *
+ *   private readonly consent = inject(PlainConsentService);
+ *   readonly analytics = this.consent.allowed("analytics");
+ */
+class PlainConsentService {
+    constructor() {
+        this.browser = isPlatformBrowser(inject(PLATFORM_ID));
+        this._state = signal(null, ...(ngDevMode ? [{ debugName: "_state" }] : /* istanbul ignore next */ []));
+        this.off = () => undefined;
+        /** null on the server and until the script is ready */
+        this.state = this._state.asReadonly();
+        this.ready = computed(() => this._state() !== null, ...(ngDevMode ? [{ debugName: "ready" }] : /* istanbul ignore next */ []));
+        this.acceptAll = consentActions.acceptAll;
+        this.rejectAll = consentActions.rejectAll;
+        this.set = consentActions.set;
+        /** open the preferences panel (wire it to a "Privacy choices" link in your footer) */
+        this.open = consentActions.open;
+        /** forget the choice and ask again */
+        this.revoke = consentActions.revoke;
+        /** show the notice in one of the site's languages; "" for the default */
+        this.setLanguage = consentActions.setLanguage;
+        if (!this.browser)
+            return;
+        this._state.set(consentStore.getSnapshot());
+        this.off = consentStore.subscribe(() => this._state.set(consentStore.getSnapshot()));
+    }
+    /** Load plain-consent.js once. No-op on the server. */
+    init(options) {
+        if (!this.browser)
+            return Promise.resolve();
+        return loadPlainConsent(options).then(() => undefined, (e) => console.warn(e));
+    }
+    /** A signal that is true while `category` is allowed (`essential` is always true). */
+    allowed(category) {
+        return computed(() => isAllowed(category, this._state()));
+    }
+    ngOnDestroy() {
+        this.off();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: PlainConsentService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: PlainConsentService, providedIn: "root" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: PlainConsentService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: "root" }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Render a template only while a consent category is allowed, with an optional `else` template:
+ * Angular's ConsentGate.
+ *
+ *   <iframe *plainConsentAllowed="'marketing'; else blocked" src="https://www.youtube.com/embed/…"></iframe>
+ *   <ng-template #blocked><p>Allow marketing cookies to watch this video.</p></ng-template>
+ */
+class PlainConsentAllowedDirective {
+    constructor() {
+        this.template = inject((TemplateRef));
+        this.container = inject(ViewContainerRef);
+        this.consent = inject(PlainConsentService);
+        this.category = input.required({ ...(ngDevMode ? { debugName: "category" } : /* istanbul ignore next */ {}), alias: "plainConsentAllowed" });
+        this.elseTemplate = input(null, { ...(ngDevMode ? { debugName: "elseTemplate" } : /* istanbul ignore next */ {}), alias: "plainConsentAllowedElse" });
+        this.shown = null;
+        effect(() => {
+            const next = isAllowed(this.category(), this.consent.state()) ? this.template : this.elseTemplate();
+            if (next === this.shown)
+                return;
+            this.container.clear();
+            if (next)
+                this.container.createEmbeddedView(next);
+            this.shown = next;
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: PlainConsentAllowedDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.25", type: PlainConsentAllowedDirective, isStandalone: true, selector: "[plainConsentAllowed]", inputs: { category: { classPropertyName: "category", publicName: "plainConsentAllowed", isSignal: true, isRequired: true, transformFunction: null }, elseTemplate: { classPropertyName: "elseTemplate", publicName: "plainConsentAllowedElse", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: PlainConsentAllowedDirective, decorators: [{
+            type: Directive,
+            args: [{ selector: "[plainConsentAllowed]", standalone: true }]
+        }], ctorParameters: () => [], propDecorators: { category: [{ type: i0.Input, args: [{ isSignal: true, alias: "plainConsentAllowed", required: true }] }], elseTemplate: [{ type: i0.Input, args: [{ isSignal: true, alias: "plainConsentAllowedElse", required: false }] }] } });
+
+/**
+ * Load plain-consent.js when the app starts (browser only; nothing happens during server rendering).
+ *
+ *   bootstrapApplication(App, { providers: [providePlainConsent({ siteKey: "pk_YOUR_SITE_KEY" })] });
+ */
+function providePlainConsent(options) {
+    return makeEnvironmentProviders([
+        {
+            provide: ENVIRONMENT_INITIALIZER,
+            multi: true,
+            useValue: () => {
+                void inject(PlainConsentService).init(options);
+            },
+        },
+    ]);
+}
+
+/*
+ * @theplaintheory/angular: Plain Theory consent for Angular 17.1+ (signals, standalone, SSR-safe).
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { PlainConsentAllowedDirective, PlainConsentService, providePlainConsent };
+//# sourceMappingURL=theplaintheory-angular.mjs.map

package/fesm2022/theplaintheory-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theplaintheory-angular.mjs","sources":["../../src/plain-consent.service.ts","../../src/consent-allowed.directive.ts","../../src/provide.ts","../../src/public-api.ts","../../src/theplaintheory-angular.ts"],"sourcesContent":["import { computed, inject, Injectable, PLATFORM_ID, signal, type OnDestroy, type Signal } from \"@angular/core\";\r\nimport { isPlatformBrowser } from \"@angular/common\";\r\nimport { consentActions, consentStore, isAllowed, loadPlainConsent, type Category, type ConsentState, type LoadOptions } from \"@theplaintheory/consent\";\r\n\r\n/**\r\n * Plain Theory consent as Angular signals. SSR-safe: on the server the state stays null and nothing\r\n * is loaded. Load the script with `providePlainConsent({ siteKey })` in your app config, or call\r\n * `init()` yourself.\r\n *\r\n *   private readonly consent = inject(PlainConsentService);\r\n *   readonly analytics = this.consent.allowed(\"analytics\");\r\n */\r\n@Injectable({ providedIn: \"root\" })\r\nexport class PlainConsentService implements OnDestroy {\r\n  private readonly browser = isPlatformBrowser(inject(PLATFORM_ID));\r\n  private readonly _state = signal<ConsentState | null>(null);\r\n  private off: () => void = () => undefined;\r\n\r\n  /** null on the server and until the script is ready */\r\n  readonly state: Signal<ConsentState | null> = this._state.asReadonly();\r\n  readonly ready = computed(() => this._state() !== null);\r\n\r\n  readonly acceptAll = consentActions.acceptAll;\r\n  readonly rejectAll = consentActions.rejectAll;\r\n  readonly set = consentActions.set;\r\n  /** open the preferences panel (wire it to a \"Privacy choices\" link in your footer) */\r\n  readonly open = consentActions.open;\r\n  /** forget the choice and ask again */\r\n  readonly revoke = consentActions.revoke;\r\n  /** show the notice in one of the site's languages; \"\" for the default */\r\n  readonly setLanguage = consentActions.setLanguage;\r\n\r\n  constructor() {\r\n    if (!this.browser) return;\r\n    this._state.set(consentStore.getSnapshot());\r\n    this.off = consentStore.subscribe(() => this._state.set(consentStore.getSnapshot()));\r\n  }\r\n\r\n  /** Load plain-consent.js once. No-op on the server. */\r\n  init(options: LoadOptions): Promise<void> {\r\n    if (!this.browser) return Promise.resolve();\r\n    return loadPlainConsent(options).then(\r\n      () => undefined,\r\n      (e: unknown) => console.warn(e),\r\n    );\r\n  }\r\n\r\n  /** A signal that is true while `category` is allowed (`essential` is always true). */\r\n  allowed(category: Category): Signal<boolean> {\r\n    return computed(() => isAllowed(category, this._state()));\r\n  }\r\n\r\n  ngOnDestroy() {\r\n    this.off();\r\n  }\r\n}\r\n","import { Directive, effect, inject, input, TemplateRef, ViewContainerRef } from \"@angular/core\";\r\nimport { isAllowed, type Category } from \"@theplaintheory/consent\";\r\nimport { PlainConsentService } from \"./plain-consent.service\";\r\n\r\n/**\r\n * Render a template only while a consent category is allowed, with an optional `else` template:\r\n * Angular's ConsentGate.\r\n *\r\n *   <iframe *plainConsentAllowed=\"'marketing'; else blocked\" src=\"https://www.youtube.com/embed/…\"></iframe>\r\n *   <ng-template #blocked><p>Allow marketing cookies to watch this video.</p></ng-template>\r\n */\r\n@Directive({ selector: \"[plainConsentAllowed]\", standalone: true })\r\nexport class PlainConsentAllowedDirective {\r\n  private readonly template = inject(TemplateRef<unknown>);\r\n  private readonly container = inject(ViewContainerRef);\r\n  private readonly consent = inject(PlainConsentService);\r\n\r\n  readonly category = input.required<Category>({ alias: \"plainConsentAllowed\" });\r\n  readonly elseTemplate = input<TemplateRef<unknown> | null>(null, { alias: \"plainConsentAllowedElse\" });\r\n\r\n  private shown: TemplateRef<unknown> | null = null;\r\n\r\n  constructor() {\r\n    effect(() => {\r\n      const next = isAllowed(this.category(), this.consent.state()) ? this.template : this.elseTemplate();\r\n      if (next === this.shown) return;\r\n      this.container.clear();\r\n      if (next) this.container.createEmbeddedView(next);\r\n      this.shown = next;\r\n    });\r\n  }\r\n}\r\n","import { ENVIRONMENT_INITIALIZER, inject, makeEnvironmentProviders, type EnvironmentProviders } from \"@angular/core\";\r\nimport type { LoadOptions } from \"@theplaintheory/consent\";\r\nimport { PlainConsentService } from \"./plain-consent.service\";\r\n\r\n/**\r\n * Load plain-consent.js when the app starts (browser only; nothing happens during server rendering).\r\n *\r\n *   bootstrapApplication(App, { providers: [providePlainConsent({ siteKey: \"pk_YOUR_SITE_KEY\" })] });\r\n */\r\nexport function providePlainConsent(options: LoadOptions): EnvironmentProviders {\r\n  return makeEnvironmentProviders([\r\n    {\r\n      provide: ENVIRONMENT_INITIALIZER,\r\n      multi: true,\r\n      useValue: () => {\r\n        void inject(PlainConsentService).init(options);\r\n      },\r\n    },\r\n  ]);\r\n}\r\n","/*\r\n * @theplaintheory/angular: Plain Theory consent for Angular 17.1+ (signals, standalone, SSR-safe).\r\n */\r\nexport { PlainConsentService } from \"./plain-consent.service\";\r\nexport { PlainConsentAllowedDirective } from \"./consent-allowed.directive\";\r\nexport { providePlainConsent } from \"./provide\";\r\nexport type { Categories, Category, ConsentState, Framework, LoadOptions, PlainConsentApi } from \"@theplaintheory/consent\";\r\nexport { getConsent, isAllowed, loadPlainConsent, loadScriptWhenAllowed, onConsentChange, whenAllowed } from \"@theplaintheory/consent\";\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@theplaintheory/angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Angular 17.1+ bindings for Plain Theory consent: a signals service, providePlainConsent() and the *plainConsentAllowed directive. SSR-safe.",
+  "license": "MIT",
+  "sideEffects": false,
+  "dependencies": {
+    "@theplaintheory/consent": "^1.0.0",
+    "tslib": "^2.6.0"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=17.1.0",
+    "@angular/core": ">=17.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gagankarthik/theplaintheory.git",
+    "directory": "packages/angular"
+  },
+  "homepage": "https://www.theplaintheory.in/docs#frameworks",
+  "keywords": [
+    "consent",
+    "cmp",
+    "cookie banner",
+    "gdpr",
+    "ccpa",
+    "dpdpa",
+    "angular",
+    "signals"
+  ],
+  "module": "fesm2022/theplaintheory-angular.mjs",
+  "typings": "types/theplaintheory-angular.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/theplaintheory-angular.d.ts",
+      "default": "./fesm2022/theplaintheory-angular.mjs"
+    }
+  },
+  "type": "module"
 }

package/types/theplaintheory-angular.d.ts

@@ -0,0 +1,67 @@
+import * as i0 from '@angular/core';
+import { OnDestroy, Signal, TemplateRef, EnvironmentProviders } from '@angular/core';
+import { ConsentState, Category, LoadOptions } from '@theplaintheory/consent';
+export { Categories, Category, ConsentState, Framework, LoadOptions, PlainConsentApi, getConsent, isAllowed, loadPlainConsent, loadScriptWhenAllowed, onConsentChange, whenAllowed } from '@theplaintheory/consent';
+
+/**
+ * Plain Theory consent as Angular signals. SSR-safe: on the server the state stays null and nothing
+ * is loaded. Load the script with `providePlainConsent({ siteKey })` in your app config, or call
+ * `init()` yourself.
+ *
+ *   private readonly consent = inject(PlainConsentService);
+ *   readonly analytics = this.consent.allowed("analytics");
+ */
+declare class PlainConsentService implements OnDestroy {
+    private readonly browser;
+    private readonly _state;
+    private off;
+    /** null on the server and until the script is ready */
+    readonly state: Signal<ConsentState | null>;
+    readonly ready: Signal<boolean>;
+    readonly acceptAll: () => void;
+    readonly rejectAll: () => void;
+    readonly set: (partial: Partial<Record<Category, boolean>>) => void;
+    /** open the preferences panel (wire it to a "Privacy choices" link in your footer) */
+    readonly open: () => void;
+    /** forget the choice and ask again */
+    readonly revoke: () => void;
+    /** show the notice in one of the site's languages; "" for the default */
+    readonly setLanguage: (code: string) => void;
+    constructor();
+    /** Load plain-consent.js once. No-op on the server. */
+    init(options: LoadOptions): Promise<void>;
+    /** A signal that is true while `category` is allowed (`essential` is always true). */
+    allowed(category: Category): Signal<boolean>;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PlainConsentService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PlainConsentService>;
+}
+
+/**
+ * Render a template only while a consent category is allowed, with an optional `else` template:
+ * Angular's ConsentGate.
+ *
+ *   <iframe *plainConsentAllowed="'marketing'; else blocked" src="https://www.youtube.com/embed/…"></iframe>
+ *   <ng-template #blocked><p>Allow marketing cookies to watch this video.</p></ng-template>
+ */
+declare class PlainConsentAllowedDirective {
+    private readonly template;
+    private readonly container;
+    private readonly consent;
+    readonly category: i0.InputSignal<Category>;
+    readonly elseTemplate: i0.InputSignal<TemplateRef<unknown> | null>;
+    private shown;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<PlainConsentAllowedDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PlainConsentAllowedDirective, "[plainConsentAllowed]", never, { "category": { "alias": "plainConsentAllowed"; "required": true; "isSignal": true; }; "elseTemplate": { "alias": "plainConsentAllowedElse"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Load plain-consent.js when the app starts (browser only; nothing happens during server rendering).
+ *
+ *   bootstrapApplication(App, { providers: [providePlainConsent({ siteKey: "pk_YOUR_SITE_KEY" })] });
+ */
+declare function providePlainConsent(options: LoadOptions): EnvironmentProviders;
+
+export { PlainConsentAllowedDirective, PlainConsentService, providePlainConsent };
+//# sourceMappingURL=theplaintheory-angular.d.ts.map

package/types/theplaintheory-angular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theplaintheory-angular.d.ts","sources":["../../src/plain-consent.service.ts","../../src/consent-allowed.directive.ts","../../src/provide.ts"],"mappings":";;;;;AAIA;;;;;;;AAOG;AACH,cACa,mBAAoB,YAAW,SAAS;AACnD;AACA;;;oBAIgB,MAAM,CAAC,YAAY;oBACrB,MAAA;;;4BAIF,OAAA,CAAA,MAAA,CAAA,QAAA;;;;;;;;;kBAeE,WAAW,GAAG,OAAO;;sBASjB,QAAQ,GAAG,MAAM;;yCAnCxB,mBAAmB;6CAAnB,mBAAmB;AA0C/B;;ACnDD;;;;;;AAMG;AACH,cACa,4BAA4B;AACvC;AACA;AACA;uBAEiBA,EAAA,CAAA,WAAA,CAAA,QAAA;2BACIA,EAAA,CAAA,WAAA,CAAA,WAAA;;;yCANV,4BAA4B;2CAA5B,4BAA4B;AAmBxC;;AC3BD;;;;AAIG;AACH,iBAAgB,mBAAmB,UAAU,WAAW,GAAG,oBAAoB;;","names":["_angular_core"]}