@lattix/app 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# @lattix/app
+
+Optional App Runtime manifest foundation for Lattix.
+
+`@lattix/app` keeps app concerns outside Lattix Core UI nodes. It provides a readable authoring DSL that resolves to plain, typed, serializable manifests.
+
+## Example
+
+```ts
+import { App } from "@lattix/app";
+
+const manifest = App("Shop")
+  .platforms(["web", "native"])
+  .environment((env) =>
+    env
+      .variable("API_URL", { required: true })
+      .variable("APP_ENV", { defaultValue: "development" }),
+  )
+  .providers((providers) =>
+    providers.provider("query-client", { adapter: "tanstack-query" }),
+  )
+  .toManifest();
+```
+
+The manifest is the runtime source of truth. Adapters in later phases will consume manifests; they must not consume fluent builder state.
+
+## Current scope
+
+Phase 10 includes:
+
+- `App("Name")`
+- platform declarations
+- provider declarations
+- environment variable declarations
+- structured manifest validation
+- `validateManifest()`
+- `printManifest()`
+
+Navigation, data, storage, auth, web/native capabilities, and observability adapters are planned for later optional runtime phases.

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+import type { LattixDiagnostic, LattixSourceLocation, ValidationMode, ValidationResult } from "@lattix/core";
+export type LattixPlatform = "web" | "native";
+export interface LattixEnvironmentVariable {
+    readonly key: string;
+    readonly required?: boolean;
+    readonly defaultValue?: string;
+}
+export interface LattixEnvironmentManifest {
+    readonly variables: readonly LattixEnvironmentVariable[];
+}
+export interface LattixProviderManifest {
+    readonly id: string;
+    readonly adapter?: string;
+}
+export interface LattixObservabilityConsent {
+    readonly category: string;
+    readonly required?: boolean;
+}
+export interface LattixAnalyticsEventManifest {
+    readonly id: string;
+    readonly consent?: string;
+    readonly pii?: boolean;
+}
+export interface LattixScreenTrackingManifest {
+    readonly screenRef: string;
+}
+export interface LattixLogManifest {
+    readonly id: string;
+    readonly level: "debug" | "info" | "warn" | "error";
+}
+export interface LattixCrashReportingManifest {
+    readonly id: string;
+    readonly provider: string;
+}
+export interface LattixPerformanceSpanManifest {
+    readonly id: string;
+    readonly consent?: string;
+}
+export interface LattixPrivacyManifest {
+    readonly policyUrl: string;
+}
+export interface LattixObservabilityManifest {
+    readonly consent: readonly LattixObservabilityConsent[];
+    readonly analyticsEvents: readonly LattixAnalyticsEventManifest[];
+    readonly screenTracking: readonly LattixScreenTrackingManifest[];
+    readonly logs: readonly LattixLogManifest[];
+    readonly crashReporting: readonly LattixCrashReportingManifest[];
+    readonly performanceSpans: readonly LattixPerformanceSpanManifest[];
+    readonly webVitals: boolean;
+    readonly nativePerformance: boolean;
+    readonly privacy?: LattixPrivacyManifest;
+}
+export interface ObservabilityAdapterPlan {
+    readonly providers: readonly string[];
+    readonly analyticsEvents: readonly string[];
+    readonly performanceSpans: readonly string[];
+    readonly consentCategories: readonly string[];
+}
+export interface LattixManifestMeta {
+    readonly source?: LattixSourceLocation;
+    readonly path: string;
+    readonly builderTrace: readonly string[];
+}
+export interface LattixAppManifest {
+    readonly kind: "app";
+    readonly name: string;
+    readonly platforms: readonly string[];
+    readonly environment?: LattixEnvironmentManifest;
+    readonly providers: readonly LattixProviderManifest[];
+    readonly observability?: LattixObservabilityManifest;
+    readonly meta: LattixManifestMeta;
+    readonly validation: ValidationResult;
+}
+export interface ToManifestOptions {
+    readonly mode?: ValidationMode;
+    readonly throwOnError?: boolean;
+}
+export declare class LattixAppValidationError extends Error {
+    readonly diagnostics: readonly LattixDiagnostic[];
+    constructor(diagnostics: readonly LattixDiagnostic[]);
+}
+export declare const validateManifest: (manifest: LattixAppManifest) => ValidationResult;
+export declare class LattixEnvironmentBuilder {
+    private readonly variables;
+    variable(key: string, options?: Omit<LattixEnvironmentVariable, "key">): this;
+    toManifest(): LattixEnvironmentManifest;
+}
+export declare class LattixProvidersBuilder {
+    private readonly providers;
+    provider(id: string, options?: Omit<LattixProviderManifest, "id">): this;
+    toManifest(): readonly LattixProviderManifest[];
+}
+export declare class LattixObservabilityBuilder {
+    private readonly consentItems;
+    private readonly analyticsEvents;
+    private readonly screenTrackingItems;
+    private readonly logItems;
+    private readonly crashItems;
+    private readonly spanItems;
+    private webVitalsEnabled;
+    private nativePerformanceEnabled;
+    private privacyManifest;
+    consent(category: string, options?: Omit<LattixObservabilityConsent, "category">): this;
+    analytics(id: string, options?: Omit<LattixAnalyticsEventManifest, "id">): this;
+    screenTracking(screenRef: string): this;
+    log(id: string, options: Omit<LattixLogManifest, "id">): this;
+    crash(id: string, options: Omit<LattixCrashReportingManifest, "id">): this;
+    span(id: string, options?: Omit<LattixPerformanceSpanManifest, "id">): this;
+    webVitals(): this;
+    nativePerformance(): this;
+    privacy(privacy: LattixPrivacyManifest): this;
+    toManifest(): LattixObservabilityManifest;
+}
+export declare class LattixAppBuilder {
+    private state;
+    constructor(name: string);
+    platforms(platforms: readonly string[]): this;
+    providers(author: (providers: LattixProvidersBuilder) => LattixProvidersBuilder): this;
+    environment(author: (environment: LattixEnvironmentBuilder) => LattixEnvironmentBuilder): this;
+    observability(author: (observability: LattixObservabilityBuilder) => LattixObservabilityBuilder): this;
+    toManifest(options?: ToManifestOptions): LattixAppManifest;
+    validate(options?: ToManifestOptions): ValidationResult;
+    debug(options?: ToManifestOptions): {
+        manifest: LattixAppManifest;
+        validation: ValidationResult;
+        printed: string;
+    };
+}
+export declare const App: (name: string) => LattixAppBuilder;
+export declare const printManifest: (manifest: LattixAppManifest) => string;
+export declare const createObservabilityAdapterPlan: (manifest: LattixAppManifest) => ObservabilityAdapterPlan;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,381 @@
+const SUPPORTED_PLATFORMS = new Set(["web", "native"]);
+const ENVIRONMENT_KEY_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+const OBSERVABILITY_PROVIDERS = new Set(["sentry", "bugsnag", "custom"]);
+const runtimeDiagnostic = (diagnostic) => ({
+    manifestKind: "app",
+    ...diagnostic,
+});
+export class LattixAppValidationError extends Error {
+    diagnostics;
+    constructor(diagnostics) {
+        super(diagnostics[0]?.summary ?? "Lattix app manifest validation failed.");
+        this.name = "LattixAppValidationError";
+        this.diagnostics = diagnostics;
+    }
+}
+export const validateManifest = (manifest) => {
+    const diagnostics = [];
+    if (manifest.name.trim().length === 0) {
+        diagnostics.push(runtimeDiagnostic({
+            code: "LATTIX_INVALID_APP_NAME",
+            message: "App name is required.",
+            summary: "App name is required.",
+            path: "app.name",
+            field: "name",
+            received: manifest.name,
+            expected: "A non-empty app name.",
+            suggestion: 'Pass a non-empty name to App("Name").',
+        }));
+    }
+    manifest.platforms.forEach((platform, index) => {
+        if (!SUPPORTED_PLATFORMS.has(platform)) {
+            diagnostics.push(runtimeDiagnostic({
+                code: "LATTIX_UNSUPPORTED_PLATFORM",
+                message: `Unsupported platform "${platform}".`,
+                summary: `Platform "${platform}" is not supported by Lattix App Runtime.`,
+                path: `app.platforms[${index}]`,
+                field: "platforms",
+                received: platform,
+                expected: '"web" or "native".',
+                suggestion: 'Use platforms(["web"]), platforms(["native"]), or platforms(["web", "native"]).',
+            }));
+        }
+    });
+    const providerIds = new Set();
+    manifest.providers.forEach((provider, index) => {
+        if (providerIds.has(provider.id)) {
+            diagnostics.push(runtimeDiagnostic({
+                code: "LATTIX_DUPLICATE_PROVIDER_ID",
+                message: `Duplicate provider id "${provider.id}".`,
+                summary: `Provider id "${provider.id}" is declared more than once.`,
+                path: `app.providers[${index}]`,
+                field: "providers.id",
+                received: provider.id,
+                expected: "A unique provider id.",
+                suggestion: "Use a unique provider id or remove the duplicate provider declaration.",
+            }));
+        }
+        providerIds.add(provider.id);
+    });
+    manifest.environment?.variables.forEach((variable, index) => {
+        if (!ENVIRONMENT_KEY_PATTERN.test(variable.key)) {
+            diagnostics.push(runtimeDiagnostic({
+                code: "LATTIX_INVALID_ENVIRONMENT_KEY",
+                message: `Invalid environment key "${variable.key}".`,
+                summary: `Environment key "${variable.key}" must be uppercase snake case.`,
+                path: `app.environment.variables[${index}]`,
+                field: "environment.variables.key",
+                received: variable.key,
+                expected: "Uppercase snake case, for example API_URL.",
+                suggestion: "Rename the environment key to uppercase snake case.",
+            }));
+        }
+    });
+    const observability = manifest.observability;
+    if (observability) {
+        const consentCategories = new Set(observability.consent.map((item) => item.category));
+        const eventIds = new Set();
+        observability.analyticsEvents.forEach((event, index) => {
+            if (eventIds.has(event.id)) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_DUPLICATE_OBSERVABILITY_EVENT_ID",
+                    message: `Duplicate observability event id "${event.id}".`,
+                    summary: "Observability event IDs must be unique.",
+                    path: `app.observability.analyticsEvents[${index}]`,
+                    field: "observability.analyticsEvents.id",
+                    received: event.id,
+                    expected: "A unique analytics event id.",
+                    suggestion: "Use a unique event id or remove the duplicate event.",
+                }));
+            }
+            eventIds.add(event.id);
+            if (!event.consent || !consentCategories.has(event.consent)) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_OBSERVABILITY_MISSING_CONSENT",
+                    message: `Analytics event "${event.id}" is missing a declared consent category.`,
+                    summary: "Analytics events should reference declared consent categories.",
+                    path: `app.observability.analyticsEvents[${index}].consent`,
+                    field: "observability.analyticsEvents.consent",
+                    received: event.consent,
+                    expected: "A declared consent category.",
+                    suggestion: "Declare consent() and reference it from analytics().",
+                }));
+            }
+            if (event.pii && !event.consent) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_OBSERVABILITY_PRIVACY_CONSENT_REQUIRED",
+                    message: `Analytics event "${event.id}" is marked PII without consent.`,
+                    summary: "Privacy-sensitive analytics must reference a consent category.",
+                    path: `app.observability.analyticsEvents[${index}].consent`,
+                    field: "observability.analyticsEvents.consent",
+                    received: event.consent,
+                    expected: "A consent category for PII events.",
+                    suggestion: "Add a consent category to privacy-sensitive analytics events.",
+                }));
+            }
+        });
+        const logIds = new Set();
+        observability.logs.forEach((log, index) => {
+            if (logIds.has(log.id)) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_DUPLICATE_OBSERVABILITY_LOG_ID",
+                    message: `Duplicate observability log id "${log.id}".`,
+                    summary: "Structured log IDs must be unique.",
+                    path: `app.observability.logs[${index}]`,
+                    field: "observability.logs.id",
+                    received: log.id,
+                    expected: "A unique log id.",
+                    suggestion: "Use a unique log id or remove the duplicate log declaration.",
+                }));
+            }
+            logIds.add(log.id);
+        });
+        observability.crashReporting.forEach((crash, index) => {
+            if (!OBSERVABILITY_PROVIDERS.has(crash.provider)) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_UNKNOWN_OBSERVABILITY_PROVIDER",
+                    message: `Unknown observability provider "${crash.provider}".`,
+                    summary: "Crash reporting providers must be known adapter targets.",
+                    path: `app.observability.crashReporting[${index}].provider`,
+                    field: "observability.crashReporting.provider",
+                    received: crash.provider,
+                    expected: "sentry, bugsnag, or custom.",
+                    suggestion: 'Use "custom" for host-defined observability providers.',
+                }));
+            }
+        });
+        const spanIds = new Set();
+        observability.performanceSpans.forEach((span, index) => {
+            if (spanIds.has(span.id)) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_DUPLICATE_OBSERVABILITY_SPAN_ID",
+                    message: `Duplicate observability span id "${span.id}".`,
+                    summary: "Performance span IDs must be unique.",
+                    path: `app.observability.performanceSpans[${index}]`,
+                    field: "observability.performanceSpans.id",
+                    received: span.id,
+                    expected: "A unique performance span id.",
+                    suggestion: "Use a unique span id or remove the duplicate span declaration.",
+                }));
+            }
+            spanIds.add(span.id);
+            if (!span.consent || !consentCategories.has(span.consent)) {
+                diagnostics.push(runtimeDiagnostic({
+                    code: "LATTIX_OBSERVABILITY_MISSING_CONSENT",
+                    message: `Performance span "${span.id}" is missing a declared consent category.`,
+                    summary: "Performance spans should reference declared consent categories.",
+                    path: `app.observability.performanceSpans[${index}].consent`,
+                    field: "observability.performanceSpans.consent",
+                    received: span.consent,
+                    expected: "A declared consent category.",
+                    suggestion: "Declare consent() and reference it from span().",
+                }));
+            }
+        });
+    }
+    return {
+        valid: diagnostics.length === 0,
+        diagnostics,
+    };
+};
+const withValidation = (manifest, options = {}) => {
+    const completeManifest = {
+        ...manifest,
+        validation: { valid: true, diagnostics: [] },
+    };
+    const validation = validateManifest(completeManifest);
+    const validatedManifest = { ...completeManifest, validation };
+    const mode = options.mode ?? "strict";
+    const throwOnError = options.throwOnError ?? mode === "strict";
+    if (!validation.valid && throwOnError) {
+        throw new LattixAppValidationError(validation.diagnostics);
+    }
+    return validatedManifest;
+};
+export class LattixEnvironmentBuilder {
+    variables = [];
+    variable(key, options = {}) {
+        this.variables.push({ key, ...options });
+        return this;
+    }
+    toManifest() {
+        return { variables: [...this.variables] };
+    }
+}
+export class LattixProvidersBuilder {
+    providers = [];
+    provider(id, options = {}) {
+        this.providers.push({ id, ...options });
+        return this;
+    }
+    toManifest() {
+        return [...this.providers];
+    }
+}
+export class LattixObservabilityBuilder {
+    consentItems = [];
+    analyticsEvents = [];
+    screenTrackingItems = [];
+    logItems = [];
+    crashItems = [];
+    spanItems = [];
+    webVitalsEnabled = false;
+    nativePerformanceEnabled = false;
+    privacyManifest;
+    consent(category, options = {}) {
+        this.consentItems.push({ category, ...options });
+        return this;
+    }
+    analytics(id, options = {}) {
+        this.analyticsEvents.push({ id, ...options });
+        return this;
+    }
+    screenTracking(screenRef) {
+        this.screenTrackingItems.push({ screenRef });
+        return this;
+    }
+    log(id, options) {
+        this.logItems.push({ id, ...options });
+        return this;
+    }
+    crash(id, options) {
+        this.crashItems.push({ id, ...options });
+        return this;
+    }
+    span(id, options = {}) {
+        this.spanItems.push({ id, ...options });
+        return this;
+    }
+    webVitals() {
+        this.webVitalsEnabled = true;
+        return this;
+    }
+    nativePerformance() {
+        this.nativePerformanceEnabled = true;
+        return this;
+    }
+    privacy(privacy) {
+        this.privacyManifest = privacy;
+        return this;
+    }
+    toManifest() {
+        return {
+            consent: [...this.consentItems],
+            analyticsEvents: [...this.analyticsEvents],
+            screenTracking: [...this.screenTrackingItems],
+            logs: [...this.logItems],
+            crashReporting: [...this.crashItems],
+            performanceSpans: [...this.spanItems],
+            webVitals: this.webVitalsEnabled,
+            nativePerformance: this.nativePerformanceEnabled,
+            ...(this.privacyManifest ? { privacy: this.privacyManifest } : {}),
+        };
+    }
+}
+export class LattixAppBuilder {
+    state;
+    constructor(name) {
+        this.state = {
+            name,
+            platforms: [],
+            providers: [],
+            environmentVariables: [],
+            builderTrace: [`App("${name}")`],
+        };
+    }
+    platforms(platforms) {
+        this.state = {
+            ...this.state,
+            platforms: [...platforms],
+            builderTrace: [...this.state.builderTrace, "platforms"],
+        };
+        return this;
+    }
+    providers(author) {
+        const builder = author(new LattixProvidersBuilder());
+        this.state = {
+            ...this.state,
+            providers: builder.toManifest(),
+            builderTrace: [...this.state.builderTrace, "providers"],
+        };
+        return this;
+    }
+    environment(author) {
+        const builder = author(new LattixEnvironmentBuilder());
+        this.state = {
+            ...this.state,
+            environmentVariables: builder.toManifest().variables,
+            builderTrace: [...this.state.builderTrace, "environment"],
+        };
+        return this;
+    }
+    observability(author) {
+        const builder = author(new LattixObservabilityBuilder());
+        this.state = {
+            ...this.state,
+            observability: builder.toManifest(),
+            builderTrace: [...this.state.builderTrace, "observability"],
+        };
+        return this;
+    }
+    toManifest(options) {
+        const environment = this.state.environmentVariables.length > 0
+            ? { variables: [...this.state.environmentVariables] }
+            : undefined;
+        return withValidation({
+            kind: "app",
+            name: this.state.name,
+            platforms: this.state.platforms.length > 0 ? [...this.state.platforms] : ["web"],
+            providers: [...this.state.providers],
+            ...(environment ? { environment } : {}),
+            ...(this.state.observability ? { observability: this.state.observability } : {}),
+            meta: {
+                path: "app",
+                builderTrace: [...this.state.builderTrace],
+            },
+        }, options);
+    }
+    validate(options) {
+        return this.toManifest({ ...options, throwOnError: false }).validation;
+    }
+    debug(options) {
+        const manifest = this.toManifest({ ...options, throwOnError: false });
+        return {
+            manifest,
+            validation: manifest.validation,
+            printed: printManifest(manifest),
+        };
+    }
+}
+export const App = (name) => new LattixAppBuilder(name);
+export const printManifest = (manifest) => {
+    const lines = [
+        `app name=${manifest.name} platforms=${manifest.platforms.join(",")}`,
+    ];
+    if (manifest.environment) {
+        lines.push("  environment");
+        for (const variable of manifest.environment.variables) {
+            lines.push(`    variable key=${variable.key}`);
+        }
+    }
+    if (manifest.providers.length > 0) {
+        lines.push("  providers");
+        for (const provider of manifest.providers) {
+            lines.push(`    provider id=${provider.id}`);
+        }
+    }
+    if (manifest.observability) {
+        lines.push("  observability");
+        for (const event of manifest.observability.analyticsEvents) {
+            lines.push(`    analytics id=${event.id}`);
+        }
+    }
+    return lines.join("\n");
+};
+export const createObservabilityAdapterPlan = (manifest) => ({
+    providers: manifest.observability?.crashReporting.map((crash) => crash.provider) ?? [],
+    analyticsEvents: manifest.observability?.analyticsEvents.map((event) => event.id) ?? [],
+    performanceSpans: manifest.observability?.performanceSpans.map((span) => span.id) ?? [],
+    consentCategories: manifest.observability?.consent.map((item) => item.category) ?? [],
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@lattix/app",
+  "version": "0.1.0",
+  "description": "Optional app runtime manifests and authoring DSL for Lattix",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@lattix/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}