@mongrov/analytics 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mongrov
+
+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/dist/core/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error taxonomy for @mongrov/analytics core.
+ *
+ * Full code set frozen in T-16 (Phase 7 — Error taxonomy). This file
+ * ships the class and code union so stubs can throw typed errors from
+ * day one; downstream phases add more codes without breaking imports.
+ */
+export type AnalyticsErrorCode = 'engine_open_failed' | 'extension_load_failed' | 'attach_failed' | 'token_vendor_failed' | 'migration_failed' | 'query_failed' | 'not_attached' | 'not_ready' | 'not_implemented';
+export declare class AnalyticsError extends Error {
+    readonly code: AnalyticsErrorCode;
+    readonly cause?: unknown;
+    constructor(code: AnalyticsErrorCode, message: string, cause?: unknown);
+}
+/**
+ * Thrown by unimplemented stubs. Distinct class so tests can assert on
+ * "this surface isn't wired yet" without ambiguity against runtime errors.
+ */
+export declare class NotImplementedError extends AnalyticsError {
+    constructor(symbol: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,uBAAuB,GACvB,eAAe,GACf,qBAAqB,GACrB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,WAAW,GACX,iBAAiB,CAAA;AAErB,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,kBAAkB,CAAA;IACxC,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAA;gBAEnB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAMvE;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,MAAM,EAAE,MAAM;CAI3B"}

package/dist/core/errors.js

@@ -0,0 +1,26 @@
+/**
+ * Error taxonomy for @mongrov/analytics core.
+ *
+ * Full code set frozen in T-16 (Phase 7 — Error taxonomy). This file
+ * ships the class and code union so stubs can throw typed errors from
+ * day one; downstream phases add more codes without breaking imports.
+ */
+export class AnalyticsError extends Error {
+    constructor(code, message, cause) {
+        super(message);
+        this.name = 'AnalyticsError';
+        this.code = code;
+        this.cause = cause;
+    }
+}
+/**
+ * Thrown by unimplemented stubs. Distinct class so tests can assert on
+ * "this surface isn't wired yet" without ambiguity against runtime errors.
+ */
+export class NotImplementedError extends AnalyticsError {
+    constructor(symbol) {
+        super('not_implemented', `${symbol} is not implemented in @mongrov/analytics@0.1.0-alpha.0`);
+        this.name = 'NotImplementedError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAIvC,YAAY,IAAwB,EAAE,OAAe,EAAE,KAAe;QACpE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,MAAc;QACxB,KAAK,CAAC,iBAAiB,EAAE,GAAG,MAAM,yDAAyD,CAAC,CAAA;QAC5F,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/core/factory.d.ts

@@ -0,0 +1,9 @@
+import type { AnalyticsConfig, AnalyticsEngine } from './types';
+/**
+ * Wires config into engine + warehouse + machine.
+ *
+ * Stub in T-02. Full wiring lands in T-10 (Phase 4 — factory) once the
+ * engine (T-03/04), warehouse (T-05/06/07/08), and machine (T-09) exist.
+ */
+export declare function createAnalytics(_config: AnalyticsConfig): AnalyticsEngine;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/core/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAEzE"}

package/dist/core/factory.js

@@ -0,0 +1,11 @@
+import { NotImplementedError } from './errors';
+/**
+ * Wires config into engine + warehouse + machine.
+ *
+ * Stub in T-02. Full wiring lands in T-10 (Phase 4 — factory) once the
+ * engine (T-03/04), warehouse (T-05/06/07/08), and machine (T-09) exist.
+ */
+export function createAnalytics(_config) {
+    throw new NotImplementedError('createAnalytics');
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/core/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG9C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;AAClD,CAAC"}

package/dist/core/hooks.d.ts

@@ -0,0 +1,27 @@
+import type { AnalyticsState, Insight } from './types';
+/**
+ * React hooks over the analytics engine. Stubs in T-02; real wiring via
+ * `useSyncExternalStore` on `engine.subscribe()` lands in Phase 5 (T-11/12/13).
+ *
+ * React is an optional peer, so these stubs deliberately do not import
+ * React — they simply throw NotImplementedError. This keeps @mongrov/analytics
+ * consumable from non-React runtimes (Node CLI, background workers) until
+ * the hooks are actually implemented.
+ */
+export declare function useAnalytics(): {
+    state: AnalyticsState;
+    isReady: boolean;
+    isAttached: boolean;
+    error: Error | null;
+};
+export declare function useTimeseries<T = unknown>(_key: string | undefined, _sql: string, _params?: Record<string, unknown>): {
+    data: T[] | undefined;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+export declare function useInsight(_id: string): {
+    insight: Insight | undefined;
+    loading: boolean;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/core/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtD;;;;;;;;GAQG;AAGH,wBAAgB,YAAY,IAAI;IAC9B,KAAK,EAAE,cAAc,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAEA;AAGD,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;IACD,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CAEA;AAGD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG;IACvC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,OAAO,EAAE,OAAO,CAAA;CACjB,CAEA"}

package/dist/core/hooks.js

@@ -0,0 +1,23 @@
+import { NotImplementedError } from './errors';
+/**
+ * React hooks over the analytics engine. Stubs in T-02; real wiring via
+ * `useSyncExternalStore` on `engine.subscribe()` lands in Phase 5 (T-11/12/13).
+ *
+ * React is an optional peer, so these stubs deliberately do not import
+ * React — they simply throw NotImplementedError. This keeps @mongrov/analytics
+ * consumable from non-React runtimes (Node CLI, background workers) until
+ * the hooks are actually implemented.
+ */
+// T-11 — public shape per analytics-core/spec.md §Hooks
+export function useAnalytics() {
+    throw new NotImplementedError('useAnalytics');
+}
+// T-12 — public shape per analytics-core/spec.md §Hooks
+export function useTimeseries(_key, _sql, _params) {
+    throw new NotImplementedError('useTimeseries');
+}
+// T-13 — public shape per analytics-core/spec.md §Hooks
+export function useInsight(_id) {
+    throw new NotImplementedError('useInsight');
+}
+//# sourceMappingURL=hooks.js.map

package/dist/core/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG9C;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,MAAM,UAAU,YAAY;IAM1B,MAAM,IAAI,mBAAmB,CAAC,cAAc,CAAC,CAAA;AAC/C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAC3B,IAAwB,EACxB,IAAY,EACZ,OAAiC;IAOjC,MAAM,IAAI,mBAAmB,CAAC,eAAe,CAAC,CAAA;AAChD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,GAAW;IAIpC,MAAM,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAA;AAC7C,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @mongrov/analytics core — public surface.
+ *
+ * Stubs land in T-02; concrete implementations replace them per the
+ * phased tasks in `.specifica/features/analytics-core/tasks.md`.
+ */
+export { createAnalytics } from './factory';
+export { useAnalytics, useInsight, useTimeseries } from './hooks';
+export { AnalyticsError, NotImplementedError } from './errors';
+export type { AnalyticsErrorCode } from './errors';
+export type { AnalyticsAppender, AnalyticsConfig, AnalyticsEngine, AnalyticsLogger, AnalyticsState, AttachContext, EventBus, FamilyMembersProvider, Insight, KVStore, TenantScope, TokenContext, TokenResponse, TokenVendor, Unsubscribe, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG3C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGjE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAGlD,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,qBAAqB,EACrB,OAAO,EACP,OAAO,EACP,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+/**
+ * @mongrov/analytics core — public surface.
+ *
+ * Stubs land in T-02; concrete implementations replace them per the
+ * phased tasks in `.specifica/features/analytics-core/tasks.md`.
+ */
+// Factory (T-02 stub → T-10 real)
+export { createAnalytics } from './factory';
+// Hooks (T-02 stubs → T-11/12/13 real)
+export { useAnalytics, useInsight, useTimeseries } from './hooks';
+// Errors
+export { AnalyticsError, NotImplementedError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEjE,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Public type surface for @mongrov/analytics core.
+ *
+ * Shapes are the minimum required by the T-02 stub API. Concrete
+ * semantics land in later phases (engine wrapper T-03, warehouse T-05,
+ * machine T-09, factory T-10, retention T-14). Rich unions like
+ * MetricId + METRIC_METADATA land in T-07.
+ */
+/** Fire-and-forget unsubscribe. */
+export type Unsubscribe = () => void;
+/** Tenant scope for attach + token contexts. */
+export type TenantScope = 'family' | 'org';
+/** Machine state per analytics-core/spec.md §State machine. */
+export type AnalyticsState = 'idle' | 'opening' | 'ready' | 'attaching' | 'attached' | 'detaching' | 'error';
+export interface AttachContext {
+    brand: string;
+    tenantScope: TenantScope;
+    tenantId: string;
+    userId: string;
+}
+export interface TokenContext {
+    brand: string;
+    tenantScope: TenantScope;
+    tenantId: string;
+}
+export interface TokenResponse {
+    token: string;
+    expiresAt: Date;
+    scopeClaims: {
+        brand: string;
+        tenantScope: TenantScope;
+        tenantId: string;
+        permissions: ('read' | 'write')[];
+    };
+}
+export interface TokenVendor {
+    fetch(context: TokenContext): Promise<TokenResponse>;
+}
+/** App-provided family membership. Reads Family.memberIds from RxDB in v1. */
+export type FamilyMembersProvider = (ctx: {
+    brand: string;
+    familyId: string;
+}) => Promise<string[]>;
+export interface AnalyticsLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Structural KVStore contract used by the analytics package. Kept local so
+ * this package does not require a value-level import from @mongrov/db.
+ * The app supplies an implementation (typically @mongrov/db KVStore).
+ */
+export interface KVStore {
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Structural EventBus contract from @mongrov/data-access. Optional peer:
+ * populated when analytics-sync emits invalidation events. Full glob
+ * semantics documented in data-access/spec.md.
+ */
+export interface EventBus {
+    emit<T>(name: string, payload: T): void;
+    subscribe<T>(name: string, handler: (payload: T) => void): Unsubscribe;
+    subscribePattern<T>(pattern: string, handler: (name: string, payload: T) => void): Unsubscribe;
+}
+export interface AnalyticsConfig {
+    storage: KVStore;
+    logger?: AnalyticsLogger;
+    warehouseUriBuilder: (brand: string, tenantScope: TenantScope, tenantId: string) => string;
+    catalogEndpoint: string;
+    tokenVendor: TokenVendor;
+    familyMembersProvider: FamilyMembersProvider;
+    retention: Record<string, {
+        days: number;
+    }>;
+    extensions?: string[];
+    dbPath?: string;
+    duckdb?: {
+        memoryLimit?: string;
+        threads?: string;
+    };
+    eventBus?: EventBus;
+}
+export interface AnalyticsAppender {
+    appendRow(values: unknown[]): void;
+    flush(): void;
+    close(): void;
+}
+export interface AnalyticsEngine {
+    attach(ctx: AttachContext): Promise<void>;
+    detach(): Promise<void>;
+    execute<T = unknown>(sql: string, params?: Record<string, unknown>): Promise<T[]>;
+    stream<T = unknown>(sql: string, params?: Record<string, unknown>): AsyncIterable<T[]>;
+    createAppender(table: string): AnalyticsAppender;
+    readonly state: AnalyticsState;
+    subscribe(listener: (s: AnalyticsState) => void): Unsubscribe;
+    setRetention(days: number): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Insight row shape as read from the `insight` DuckDB table.
+ * The full schema is frozen in T-06 (schemas.ts); this stub matches the
+ * columns needed by `useInsight()` in v0.1.0.
+ */
+export interface Insight {
+    id: string;
+    brand: string;
+    familyId: string;
+    userId: string;
+    ruleId?: string;
+    severity: 'info' | 'warn' | 'critical';
+    observedAt: Date;
+    observedValue?: number;
+    thresholdValue?: number;
+    payload?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,10 @@
+/**
+ * Public type surface for @mongrov/analytics core.
+ *
+ * Shapes are the minimum required by the T-02 stub API. Concrete
+ * semantics land in later phases (engine wrapper T-03, warehouse T-05,
+ * machine T-09, factory T-10, retention T-14). Rich unions like
+ * MetricId + METRIC_METADATA land in T-07.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @mongrov/analytics — DuckDB + R2 Iceberg local analytics
+ *
+ * Root subpath re-exports the core surface. Subpaths:
+ *   - @mongrov/analytics         → core (engine, factory, hooks)
+ *   - @mongrov/analytics/rules   → structured threshold rule engine
+ *   - @mongrov/analytics/tools   → typed AI SDK tools + MCP server
+ *   - @mongrov/analytics/sync    → firmware mapper + sensor sink + R2 push/fetch
+ *   - @mongrov/analytics/ui      → UI primitives (subpath reserved)
+ *
+ * See `.specifica/features/analytics-core/spec.md` for scope.
+ */
+export * from './core';
+//# 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":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,QAAQ,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @mongrov/analytics — DuckDB + R2 Iceberg local analytics
+ *
+ * Root subpath re-exports the core surface. Subpaths:
+ *   - @mongrov/analytics         → core (engine, factory, hooks)
+ *   - @mongrov/analytics/rules   → structured threshold rule engine
+ *   - @mongrov/analytics/tools   → typed AI SDK tools + MCP server
+ *   - @mongrov/analytics/sync    → firmware mapper + sensor sink + R2 push/fetch
+ *   - @mongrov/analytics/ui      → UI primitives (subpath reserved)
+ *
+ * See `.specifica/features/analytics-core/spec.md` for scope.
+ */
+export * from './core';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,QAAQ,CAAA"}

package/dist/rules/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAA"}

package/dist/rules/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":""}

package/dist/sync/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAA"}

package/dist/sync/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":""}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAA"}

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":""}

package/dist/ui/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAA"}

package/dist/ui/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@mongrov/analytics",
+  "version": "0.1.0-alpha.0",
+  "description": "DuckDB + R2 Iceberg local analytics for @mongrov apps",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mongrov/mongrov-packages.git",
+    "directory": "packages/analytics"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "duckdb",
+    "iceberg",
+    "analytics",
+    "r2",
+    "cloudflare"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./rules": {
+      "types": "./dist/rules/index.d.ts",
+      "import": "./dist/rules/index.js",
+      "default": "./dist/rules/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js",
+      "default": "./dist/tools/index.js"
+    },
+    "./sync": {
+      "types": "./dist/sync/index.d.ts",
+      "import": "./dist/sync/index.js",
+      "default": "./dist/sync/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui/index.d.ts",
+      "import": "./dist/ui/index.js",
+      "default": "./dist/ui/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@mongrov/types": "^0.4.0",
+    "react": ">=19",
+    "react-native": ">=0.81",
+    "react-native-duckdb": ">=1.0.0",
+    "@mongrov/db": "0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react-native-duckdb": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9",
+    "xstate": "^5.30.0",
+    "zod": "^3.23.8",
+    "@mongrov/db": "0.3.0",
+    "@mongrov/types": "0.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prebuild": "pnpm run clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}