@meadow-studio/platform 0.0.0-stage → 0.1.0

package/dist/notifications.js

@@ -0,0 +1,320 @@
+import { signal } from '@angular/core';
+import { Capacitor, registerPlugin } from '@capacitor/core';
+/** Safe local-notification lifecycle for app-owned reminders, content, and navigation. */
+export class MeadowNotificationService {
+    config;
+    transport;
+    permissionState = signal('unavailable', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "permissionState" }] : /* istanbul ignore next */ []));
+    statusState = signal('idle', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "statusState" }] : /* istanbul ignore next */ []));
+    actionState = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "actionState" }] : /* istanbul ignore next */ []));
+    initializeRequest;
+    listenerRegistered = false;
+    permission = this.permissionState.asReadonly();
+    status = this.statusState.asReadonly();
+    lastAction = this.actionState.asReadonly();
+    constructor(config, transport = NOOP_NOTIFICATION_TRANSPORT) {
+        this.config = config;
+        this.transport = transport;
+        if (!this.isSupported())
+            this.statusState.set('unavailable');
+        else
+            this.permissionState.set('prompt');
+    }
+    isSupported() {
+        return this.config?.enabled === true && this.transport.isAvailable();
+    }
+    async initialize() {
+        if (!this.isSupported())
+            return false;
+        this.initializeRequest ??= this.initializeInternal().catch(() => {
+            this.initializeRequest = undefined;
+            this.statusState.set('error');
+            return false;
+        });
+        return this.initializeRequest;
+    }
+    /** Refresh permission state without displaying an operating-system prompt. */
+    async refreshPermission() {
+        if (!this.isSupported())
+            return 'unavailable';
+        this.statusState.set('checking');
+        try {
+            const permission = await this.transport.checkPermission();
+            this.permissionState.set(permission);
+            this.statusState.set(permission === 'granted' ? 'ready' : 'idle');
+            return permission;
+        }
+        catch {
+            this.statusState.set('error');
+            return this.permissionState();
+        }
+    }
+    /** Show the native permission prompt. Call only from an app-owned user action. */
+    async requestPermission() {
+        if (!this.isSupported())
+            return 'unavailable';
+        this.statusState.set('checking');
+        try {
+            const permission = await this.transport.requestPermission();
+            this.permissionState.set(permission);
+            this.statusState.set(permission === 'granted' ? 'ready' : 'idle');
+            return permission;
+        }
+        catch {
+            this.statusState.set('error');
+            return this.permissionState();
+        }
+    }
+    schedule(notification) {
+        return this.deliver(notification, false);
+    }
+    replace(notification) {
+        return this.deliver(notification, true);
+    }
+    async cancel(ids) {
+        if (!this.isSupported())
+            return false;
+        const normalized = Array.isArray(ids) ? ids : [ids];
+        if (!normalized.length || normalized.some((id) => !validId(id)))
+            return false;
+        try {
+            await this.transport.cancel(normalized);
+            return true;
+        }
+        catch {
+            this.statusState.set('error');
+            return false;
+        }
+    }
+    async pending() {
+        if (!this.isSupported())
+            return [];
+        try {
+            return Object.freeze((await this.transport.pending()).map((notification) => Object.freeze({
+                ...notification,
+                data: Object.freeze({ ...notification.data }),
+            })));
+        }
+        catch {
+            this.statusState.set('error');
+            return [];
+        }
+    }
+    clearLastAction() {
+        this.actionState.set(null);
+    }
+    async initializeInternal() {
+        if (!this.listenerRegistered) {
+            await this.transport.addActionListener((action) => {
+                this.actionState.set(Object.freeze({ ...action, data: Object.freeze({ ...action.data }) }));
+            });
+            this.listenerRegistered = true;
+        }
+        await this.refreshPermission();
+        return this.statusState() !== 'error';
+    }
+    async deliver(value, replace) {
+        if (!this.isSupported())
+            return { status: 'unavailable' };
+        const notifications = Array.isArray(value) ? value : [value];
+        if (!notifications.length || notifications.some((item) => !validNotification(item))) {
+            return { status: 'failed', category: 'invalid' };
+        }
+        const ids = notifications.map(({ id }) => id);
+        if (new Set(ids).size !== ids.length)
+            return { status: 'failed', category: 'invalid' };
+        const permission = await this.refreshPermission();
+        if (this.statusState() === 'error')
+            return { status: 'failed', category: 'provider' };
+        if (permission === 'unavailable')
+            return { status: 'unavailable' };
+        if (permission !== 'granted')
+            return { status: 'permission_required', permission };
+        try {
+            const channels = new Map();
+            for (const notification of notifications) {
+                if (notification.channel)
+                    channels.set(notification.channel.id, notification.channel);
+            }
+            for (const channel of channels.values())
+                await this.transport.createChannel(channel);
+            if (replace)
+                await this.transport.cancel(ids);
+            await this.transport.schedule(notifications.map(toTransportNotification));
+            this.statusState.set('ready');
+            return { status: 'scheduled', ids: Object.freeze([...ids]) };
+        }
+        catch (error) {
+            this.statusState.set('error');
+            return { status: 'failed', category: notificationErrorCategory(error) };
+        }
+    }
+}
+export const NOOP_NOTIFICATION_TRANSPORT = Object.freeze({
+    isAvailable: () => false,
+    checkPermission: async () => 'denied',
+    requestPermission: async () => 'denied',
+    createChannel: async () => undefined,
+    schedule: async () => undefined,
+    cancel: async () => undefined,
+    pending: async () => [],
+    addActionListener: async () => undefined,
+});
+const NativeLocalNotifications = registerPlugin('LocalNotifications');
+export const CAPACITOR_LOCAL_NOTIFICATION_TRANSPORT = Object.freeze({
+    isAvailable: () => Capacitor.isNativePlatform() && ['ios', 'android'].includes(Capacitor.getPlatform()),
+    checkPermission: async () => nativePermission((await NativeLocalNotifications.checkPermissions()).display),
+    requestPermission: async () => nativePermission((await NativeLocalNotifications.requestPermissions()).display),
+    createChannel: async (channel) => {
+        if (Capacitor.getPlatform() !== 'android')
+            return;
+        await NativeLocalNotifications.createChannel({
+            id: channel.id,
+            name: channel.name,
+            ...(channel.description ? { description: channel.description } : {}),
+            ...(channel.importance ? { importance: channelImportance(channel.importance) } : {}),
+            ...(channel.visibility ? { visibility: channelVisibility(channel.visibility) } : {}),
+            ...(channel.vibration === undefined ? {} : { vibration: channel.vibration }),
+        });
+    },
+    schedule: async (notifications) => {
+        await NativeLocalNotifications.schedule({
+            notifications: notifications.map((notification) => ({
+                id: notification.id,
+                title: notification.title,
+                body: notification.body,
+                schedule: notification.schedule,
+                isExactNotification: false,
+                ...(notification.data ? { extra: notification.data } : {}),
+                ...(notification.channelId ? { channelId: notification.channelId } : {}),
+                ...(notification.autoCancel === undefined
+                    ? {}
+                    : { autoCancel: notification.autoCancel }),
+                ...(notification.foreground === undefined
+                    ? {}
+                    : { foreground: notification.foreground }),
+            })),
+        });
+    },
+    cancel: (ids) => NativeLocalNotifications.cancel({ notifications: ids.map((id) => ({ id })) }),
+    pending: async () => (await NativeLocalNotifications.getPending()).notifications.map((notification) => ({
+        id: notification.id,
+        title: notification.title,
+        body: notification.body,
+        data: safeData(notification.extra),
+    })),
+    addActionListener: async (listener) => {
+        await NativeLocalNotifications.addListener('localNotificationActionPerformed', (action) => {
+            listener({
+                id: action.notification.id,
+                actionId: action.actionId,
+                ...(action.inputValue === undefined ? {} : { inputValue: action.inputValue }),
+                data: safeData(action.notification.extra),
+            });
+        });
+    },
+});
+function toTransportNotification(notification) {
+    return Object.freeze({
+        id: notification.id,
+        title: notification.title.trim(),
+        body: notification.body.trim(),
+        schedule: notification.schedule,
+        ...(notification.data ? { data: Object.freeze({ ...notification.data }) } : {}),
+        ...(notification.channel ? { channelId: notification.channel.id } : {}),
+        ...(notification.autoCancel === undefined ? {} : { autoCancel: notification.autoCancel }),
+        ...(notification.foreground === undefined ? {} : { foreground: notification.foreground }),
+    });
+}
+function validNotification(notification) {
+    if (!notification || !validId(notification.id))
+        return false;
+    if (typeof notification.title !== 'string' ||
+        !notification.title.trim() ||
+        typeof notification.body !== 'string' ||
+        !notification.body.trim())
+        return false;
+    if (!validSchedule(notification.schedule))
+        return false;
+    if (notification.channel &&
+        (typeof notification.channel.id !== 'string' ||
+            !notification.channel.id.trim() ||
+            typeof notification.channel.name !== 'string' ||
+            !notification.channel.name.trim())) {
+        return false;
+    }
+    if (notification.autoCancel !== undefined && typeof notification.autoCancel !== 'boolean')
+        return false;
+    if (notification.foreground !== undefined && typeof notification.foreground !== 'boolean')
+        return false;
+    return notification.data ? Object.values(notification.data).every(validDataValue) : true;
+}
+function validSchedule(schedule) {
+    if (!schedule || typeof schedule !== 'object')
+        return false;
+    if ('at' in schedule)
+        return schedule.at instanceof Date && !Number.isNaN(schedule.at.getTime());
+    if (!('on' in schedule) || !schedule.on || typeof schedule.on !== 'object')
+        return false;
+    const entries = Object.entries(schedule.on);
+    return (schedule.repeats === true &&
+        entries.length > 0 &&
+        entries.every(([field, value]) => Number.isInteger(value) && calendarValueInRange(field, value)));
+}
+function calendarValueInRange(field, value) {
+    const ranges = {
+        year: [1, 9999],
+        month: [1, 12],
+        day: [1, 31],
+        weekday: [1, 7],
+        hour: [0, 23],
+        minute: [0, 59],
+        second: [0, 59],
+    };
+    const range = ranges[field];
+    return Boolean(range && value >= range[0] && value <= range[1]);
+}
+function validId(id) {
+    return Number.isInteger(id) && id >= -2_147_483_648 && id <= 2_147_483_647;
+}
+function validDataValue(value) {
+    return (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)));
+}
+function safeData(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return Object.freeze({});
+    return Object.freeze(Object.fromEntries(Object.entries(value).filter((entry) => validDataValue(entry[1]))));
+}
+function nativePermission(value) {
+    if (value === 'granted')
+        return 'granted';
+    if (value === 'prompt' || value === 'prompt-with-rationale')
+        return 'prompt';
+    return 'denied';
+}
+function channelImportance(value) {
+    return { min: 1, low: 2, default: 3, high: 4, max: 5 }[value];
+}
+function channelVisibility(value) {
+    return { secret: -1, private: 0, public: 1 }[value];
+}
+function notificationErrorCategory(error) {
+    const text = typeof error === 'object' && error !== null
+        ? `${'code' in error ? String(error.code) : ''} ${'message' in error ? String(error.message) : ''}`
+        : String(error);
+    const normalized = text.toLowerCase();
+    if (normalized.includes('permission') || normalized.includes('denied'))
+        return 'permission';
+    if (normalized.includes('invalid') || normalized.includes('identifier'))
+        return 'invalid';
+    if (normalized.trim())
+        return 'provider';
+    return 'unknown';
+}
+//# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,163 @@
+import { InjectionToken, type EnvironmentProviders } from '@angular/core';
+import { type MeadowPurchasesConfig, type MeadowPurchaseTransport } from './purchases.js';
+import { type MeadowNotificationsConfig, type MeadowNotificationTransport } from './notifications.js';
+export type MeadowEnvironment = 'development' | 'device' | 'production';
+export type MeadowRuntimePlatform = 'ios' | 'android' | 'web';
+export interface MeadowAppConfig {
+    readonly name: string;
+    readonly id: string;
+    readonly supportEmail?: string;
+    readonly privacyUrl?: string;
+}
+export interface MeadowPlatformConfig {
+    readonly app: MeadowAppConfig;
+    readonly environment: MeadowEnvironment;
+    readonly analytics?: MeadowAnalyticsConfig;
+    readonly crashReporting?: MeadowCrashReportingConfig;
+    readonly purchases?: MeadowPurchasesConfig;
+    readonly notifications?: MeadowNotificationsConfig;
+}
+export interface MeadowAnalyticsConfig {
+    /** Makes analytics available. Collection still requires explicit persisted consent. */
+    readonly enabled: boolean;
+    /** App-owned event names accepted by the platform. */
+    readonly allowedEvents: readonly string[];
+    /** App-owned property names retained when an event is delivered. */
+    readonly allowedProperties?: readonly string[];
+}
+export interface MeadowCrashReportingConfig {
+    /** Makes crash reporting available. Collection still requires explicit persisted consent. */
+    readonly enabled: boolean;
+}
+export type MeadowConsentStatus = 'unknown' | 'granted' | 'denied';
+export type MeadowAnalyticsValue = string | number | boolean;
+export type MeadowAnalyticsParams = Readonly<Record<string, MeadowAnalyticsValue | null | undefined>>;
+export interface MeadowAnalyticsEvent {
+    readonly name: string;
+    readonly params?: Readonly<Record<string, MeadowAnalyticsValue>>;
+}
+/** Provider-neutral delivery boundary owned by Meadow Platform. */
+export interface MeadowAnalyticsTransport {
+    setEnabled(enabled: boolean): void | Promise<void>;
+    track(event: Readonly<MeadowAnalyticsEvent>): void | Promise<void>;
+}
+export type MeadowCrashContextValue = string | number | boolean;
+export interface MeadowCrashReport {
+    readonly message: string;
+    readonly context?: Readonly<Record<string, MeadowCrashContextValue>>;
+}
+/** Provider-neutral crash-reporting boundary owned by Meadow Platform. */
+export interface MeadowCrashReportingTransport {
+    setEnabled(enabled: boolean): void | Promise<void>;
+    record(report: Readonly<MeadowCrashReport>): void | Promise<void>;
+    log(message: string): void | Promise<void>;
+}
+export interface MeadowAppInfo {
+    readonly version: string | null;
+    readonly buildNumber: string | null;
+    readonly platform: MeadowRuntimePlatform;
+}
+export interface MeadowAppRatingTransport {
+    isAvailable(): boolean;
+    requestReview(): Promise<{
+        readonly attempted: boolean;
+    }>;
+}
+interface MeadowAppRatingStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+interface MeadowConsentStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/** Typed app-level configuration supplied by the consuming application. */
+export declare const MEADOW_PLATFORM_CONFIG: InjectionToken<Readonly<MeadowPlatformConfig>>;
+/** Meadow-owned boundary for runtime application metadata. */
+export declare abstract class MeadowAppInfoService {
+    abstract get(): Promise<Readonly<MeadowAppInfo>>;
+}
+/**
+ * Requests the native App Store or Play Store rating surface while applying
+ * Meadow's shared frequency safeguards. The store decides whether to display it.
+ */
+export declare class MeadowAppRatingService {
+    private readonly config;
+    private readonly appInfo;
+    private readonly transport;
+    private readonly storage;
+    private readonly now;
+    private requestInFlight;
+    isSupported(): boolean;
+    /** Returns true when a review request was successfully handed to the native store. */
+    requestReview(): Promise<boolean>;
+    private attemptReviewRequest;
+    private load;
+    private persist;
+    private storageKey;
+}
+/** Failure-safe analytics boundary used by application-owned event wrappers. */
+export declare class MeadowAnalyticsService {
+    private readonly config;
+    private readonly transport;
+    private readonly storage;
+    private readonly allowedEvents;
+    private readonly allowedProperties;
+    private consent;
+    private collectionEnabled;
+    private enableRequest;
+    constructor(config: Readonly<MeadowPlatformConfig>, transport?: MeadowAnalyticsTransport, storage?: MeadowConsentStorage | null);
+    /** Deliver an allowlisted event without allowing provider errors to affect the product flow. */
+    track(event: string, params?: MeadowAnalyticsParams): void;
+    /** Persist and apply the user's explicit analytics consent choice. */
+    setConsent(granted: boolean): Promise<void>;
+    consentStatus(): MeadowConsentStatus;
+    isEnabled(): boolean;
+    private isEffectivelyEnabled;
+    private applyEnabled;
+    private deliver;
+    private storageKey;
+}
+/** Consent-gated reporting for native crashes, handled errors, and diagnostic breadcrumbs. */
+export declare class MeadowCrashReportingService {
+    private readonly config;
+    private readonly transport;
+    private readonly storage;
+    private consent;
+    private reportingEnabled;
+    private enableRequest;
+    constructor(config: Readonly<MeadowPlatformConfig>, transport?: MeadowCrashReportingTransport, storage?: MeadowConsentStorage | null);
+    /** Persist and apply the user's explicit crash-reporting consent choice. */
+    setConsent(granted: boolean): Promise<void>;
+    consentStatus(): MeadowConsentStatus;
+    isEnabled(): boolean;
+    /** Record a handled error without allowing provider failures to affect the application. */
+    recordError(error: unknown, context?: Readonly<Record<string, MeadowCrashContextValue | null | undefined>>): void;
+    /** Add a short diagnostic breadcrumb to a future crash report. */
+    log(message: string): void;
+    private isEffectivelyEnabled;
+    private applyEnabled;
+    private deliver;
+    private deliverLog;
+    private storageKey;
+}
+/** Configure Meadow Platform once in the consuming application's root providers. */
+export declare function provideMeadowPlatform(config: MeadowPlatformConfig): EnvironmentProviders;
+export declare const MEADOW_APP_RATING_TESTING: {
+    readonly transport: InjectionToken<MeadowAppRatingTransport>;
+    readonly storage: InjectionToken<MeadowAppRatingStorage | null>;
+    readonly now: InjectionToken<() => number>;
+};
+export declare const MEADOW_OBSERVABILITY_TESTING: {
+    readonly analyticsTransport: InjectionToken<MeadowAnalyticsTransport>;
+    readonly crashReportingTransport: InjectionToken<MeadowCrashReportingTransport>;
+    readonly consentStorage: InjectionToken<MeadowConsentStorage | null>;
+};
+export declare const MEADOW_PURCHASES_TESTING: {
+    readonly transport: InjectionToken<MeadowPurchaseTransport>;
+};
+export declare const MEADOW_NOTIFICATIONS_TESTING: {
+    readonly transport: InjectionToken<MeadowNotificationTransport>;
+};
+export {};
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

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