ugly-app 0.1.0

package/dist/shared/DB.d.ts

@@ -0,0 +1,339 @@
+export interface DBObject {
+    id: string;
+    version: number;
+    created: Date;
+    updated: Date;
+}
+export type ParentPath = [string, string];
+export interface CollectionMeta {
+    cache: boolean;
+    trackable: boolean;
+    public: boolean;
+    parent: string | null;
+}
+export type CollectionRegistry = Record<string, CollectionMeta>;
+export interface CollectionDef<T extends DBObject = any> {
+    readonly name: string;
+    type: T;
+    meta: CollectionMeta;
+    onDelete?: (doc: T, db: TypedDB<any>) => Promise<void>;
+}
+export type CollectionDefRegistry = Record<string, Omit<CollectionDef, 'name'>>;
+/**
+ * All valid dot-notation paths for T (up to 4 levels deep).
+ * - Arrays: not recursed (just the key itself)
+ * - Date: not recursed (leaf)
+ * - Record<string, V> (dynamic map): allows "field.anyKey" via template string
+ * - Plain objects: recursed with typed sub-paths
+ */
+export type DotKeys<T, Prefix extends string = '', Depth extends unknown[] = []> = Depth['length'] extends 4 ? never : {
+    [K in keyof T & string]: T[K] extends unknown[] ? `${Prefix}${K}` : T[K] extends Date ? `${Prefix}${K}` : string extends keyof T[K] ? `${Prefix}${K}` | `${Prefix}${K}.${string}` : T[K] extends object ? `${Prefix}${K}` | DotKeys<T[K], `${Prefix}${K}.`, [...Depth, 0]> : `${Prefix}${K}`;
+}[keyof T & string];
+/**
+ * The value type at a dot-path P within T.
+ * Falls back to `unknown` when the path crosses a dynamic Record<string, V> boundary.
+ */
+export type DotValue<T, P extends string> = P extends keyof T ? T[P] : P extends `${infer K}.${infer Rest}` ? K extends keyof T ? string extends keyof T[K] ? unknown : DotValue<T[K], Rest> : unknown : unknown;
+/** A partial update object with dot-notation key support. */
+export type DocFields<T> = {
+    [P in DotKeys<T>]?: DotValue<T, P>;
+};
+/** MongoDB-style update operators, all supporting dot-notation paths. */
+export interface MongoUpdateOp<T> {
+    $inc?: DocFields<T>;
+    $addToSet?: DocFields<T>;
+    $pull?: DocFields<T>;
+    $unset?: {
+        [P in DotKeys<T>]?: '';
+    };
+    $set?: DocFields<T>;
+}
+export interface TypedDB<_Map extends Record<string, DBObject> = Record<string, DBObject>> {
+    /**
+     * Fetch a single document by id.
+     * Pass `parentId` when the collection uses compound `_id` (parent:child format).
+     */
+    getDoc<T extends DBObject>(collection: CollectionDef<T>, id: string, parentId?: string): Promise<T | null>;
+    /**
+     * Insert or replace a document.
+     * - `options.parentId`: compound parent id prefix for the MongoDB `_id`.
+     * - `options.skipIfExists`: when true, INSERT only — returns false if doc already exists.
+     * Returns true on success, false when skipIfExists=true and the doc already existed.
+     */
+    setDoc<T extends DBObject>(collection: CollectionDef<T>, doc: T, options?: {
+        skipIfExists?: boolean;
+        parentId?: string;
+    }): Promise<boolean>;
+    /**
+     * Partial update using dot-notation field paths.
+     * Automatically sets `updated` to now. Throws if the document does not exist.
+     * Returns the full updated document.
+     */
+    setDocFields<T extends DBObject>(collection: CollectionDef<T>, id: string, fields: DocFields<T>, options?: {
+        parentId?: string;
+    }): Promise<T>;
+    /**
+     * Like `setDocFields` but returns null (instead of throwing) when the doc doesn't exist.
+     */
+    setDocFieldsOrIgnore<T extends DBObject>(collection: CollectionDef<T>, id: string, fields: DocFields<T>, options?: {
+        parentId?: string;
+    }): Promise<T | null>;
+    /**
+     * Partial update if the document exists; otherwise creates it from `obj`.
+     * Returns the resulting document (updated or newly created).
+     */
+    setDocFieldsOrCreate<T extends DBObject>(collection: CollectionDef<T>, id: string, fields: DocFields<T>, obj: T, options?: {
+        parentId?: string;
+    }): Promise<T>;
+    /**
+     * Low-level MongoDB update operators ($inc, $addToSet, $pull, $unset, $set).
+     * All support dot-notation paths. Throws if the document does not exist.
+     * Returns the full updated document.
+     */
+    setDocOp<T extends DBObject>(collection: CollectionDef<T>, id: string, op: MongoUpdateOp<T>, options?: {
+        parentId?: string;
+    }): Promise<T>;
+    /**
+     * Like `setDocOp` but returns null (instead of throwing) when the doc doesn't exist.
+     */
+    setDocOpOrIgnore<T extends DBObject>(collection: CollectionDef<T>, id: string, op: MongoUpdateOp<T>, options?: {
+        parentId?: string;
+    }): Promise<T | null>;
+    /**
+     * Delete a document and cascade-delete all children.
+     */
+    deleteDoc<T extends DBObject>(collection: CollectionDef<T>, id: string, options?: {
+        parentId?: string;
+    }): Promise<void>;
+    /**
+     * Query documents. Pass `parentId` in options to filter by parent automatically.
+     */
+    getDocs<T extends DBObject>(collection: CollectionDef<T>, filter?: Record<string, unknown>, options?: {
+        sort?: Record<string, 1 | -1>;
+        limit?: number;
+        skip?: number;
+        parentId?: string;
+    }): Promise<T[]>;
+    /**
+     * MongoDB aggregation pipeline. Results are converted via fromMongoDoc.
+     */
+    getQuery<T>(collection: string, pipeline: Record<string, unknown>[], options?: {
+        skip?: number;
+        limit?: number;
+    }): Promise<T[]>;
+    /**
+     * Aggregation pipeline that appends a $count stage. Returns 0 if no results.
+     */
+    getQueryCount(collection: string, pipeline: Record<string, unknown>[]): Promise<number>;
+    /**
+     * Aggregation pipeline without fromMongoDoc conversion — returns raw BSON documents.
+     */
+    getQueryRaw<T>(collection: string, pipeline: Record<string, unknown>[], options?: {
+        skip?: number;
+        limit?: number;
+    }): Promise<T[]>;
+    /**
+     * Bulk delete documents matching `match`, cascade-deleting children and calling onDelete.
+     * Pass `parentId` to automatically inject the parent filter.
+     */
+    deleteQuery<T extends DBObject>(collection: CollectionDef<T>, match: Record<string, unknown>, options?: {
+        parentId?: string;
+    }): Promise<void>;
+    /**
+     * Fetch a single document by collection name string (dynamic/untyped access).
+     * Used for client-driven RPC where the collection name comes from the wire.
+     */
+    rawGetDoc(collection: string, id: string, parentId?: string): Promise<DBObject | null>;
+    /**
+     * Query documents by collection name string (dynamic/untyped access).
+     * Used for client-driven RPC where the collection name comes from the wire.
+     */
+    rawGetDocs(collection: string, filter?: Record<string, unknown>, options?: {
+        sort?: Record<string, 1 | -1>;
+        limit?: number;
+        skip?: number;
+    }): Promise<DBObject[]>;
+    /** Get a raw value from the LRU cache by key. */
+    cacheGet<T>(key: string): T | undefined;
+    /** Set a raw value in the LRU cache with optional TTL override (ms). */
+    cacheSet<T>(key: string, value: T, ttlMs?: number): void;
+    /** Delete a key from the cache on all servers (via NATS invalidation). */
+    cacheDelete(key: string): void;
+    /** Build a cache key for a document. Encodes segments to avoid collisions. */
+    cacheKey(collection: string, id: string, parentId?: string): string;
+}
+export declare function defineCollections<Defs extends CollectionDefRegistry>(defs: Defs): {
+    [K in keyof Defs & string]: Defs[K] & {
+        name: K;
+    };
+};
+export interface IndexDef {
+    fields: Record<string, 1 | -1>;
+    unique?: boolean;
+    ttl?: number;
+}
+export interface SearchIndexDef {
+    name: string;
+    fields: Record<string, 'string' | 'number'>;
+}
+export interface VectorIndexDef {
+    name: string;
+    field: string;
+    dimensions: number;
+    similarity: 'cosine' | 'euclidean' | 'dotProduct';
+}
+export interface CollectionIndexConfig {
+    indexes?: IndexDef[];
+    searchIndexes?: SearchIndexDef[];
+    vectorIndexes?: VectorIndexDef[];
+}
+export type DbIndexRegistry = Record<string, CollectionIndexConfig>;
+export declare function defineDbIndexes<T extends DbIndexRegistry>(idx: T): T;
+export declare function dbDefaults(): Pick<DBObject, 'version' | 'created' | 'updated'>;
+/** Minimal auth record. Apps extend this interface with app-specific fields. */
+export interface UserBase extends DBObject {
+    email?: string;
+    phone?: string;
+}
+export interface UserHelper<T extends UserBase> {
+    get(db: TypedDB, userId: string): Promise<T | null>;
+    set(db: TypedDB, user: T): Promise<boolean>;
+    update(db: TypedDB, userId: string, fields: DocFields<T>): Promise<T>;
+}
+export declare function createUserHelper<T extends UserBase>(userDef: CollectionDef<T>): UserHelper<T>;
+export interface ErrorLog extends DBObject {
+    level: 'log' | 'info' | 'warn' | 'error' | 'debug';
+    message: string;
+    stack?: string | null;
+    source: 'server' | 'browser' | 'client';
+    userId?: string | null;
+    meta?: Record<string, unknown> | null;
+    url?: string | null;
+    hash?: string;
+    count?: number;
+    timestamp?: number;
+}
+export interface ConsoleLog extends DBObject {
+    level: 'log' | 'info' | 'warn' | 'error' | 'debug';
+    message: string;
+    userId: string;
+    meta?: Record<string, unknown> | null;
+}
+export interface PerfLog extends DBObject {
+    operation: string;
+    durationMs: number;
+    userId: string;
+}
+export interface FeedbackLog extends DBObject {
+    type: 'bug' | 'design' | 'feature';
+    message: string;
+    screenshotUrl?: string | null;
+    userId: string;
+}
+export type BillingType = 'textGen' | 'imageGen' | 'stt' | 'tts' | 'embedding' | 'service';
+export interface BillingSpend extends DBObject {
+    userId?: string;
+    provider: string;
+    model: string;
+    type: BillingType;
+    costUsd: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    imageCount?: number;
+    audioSeconds?: number;
+    billingTimestamp: number;
+}
+export interface UserCredits extends DBObject {
+    balanceUsd: number;
+}
+export interface FeedbackReportDoc extends DBObject {
+    userId: string;
+    type: 'bug' | 'feature' | 'design';
+    message: string;
+    url: string;
+    screenshotUri?: string;
+    context?: string;
+    status: 'pending' | 'captured' | 'resolved' | 'declined';
+    resolution?: string;
+    resolvedAt?: number;
+}
+export declare const BUILTIN_DEFS: {
+    errorLog: {
+        type: ErrorLog;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "errorLog";
+    };
+    consoleLog: {
+        type: ConsoleLog;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "consoleLog";
+    };
+    perfLog: {
+        type: PerfLog;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "perfLog";
+    };
+    feedbackLog: {
+        type: FeedbackLog;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "feedbackLog";
+    };
+    billingSpend: {
+        type: BillingSpend;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "billingSpend";
+    };
+    userCredits: {
+        type: UserCredits;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "userCredits";
+    };
+    feedbackReport: {
+        type: FeedbackReportDoc;
+        meta: {
+            cache: false;
+            trackable: false;
+            public: false;
+            parent: null;
+        };
+    } & {
+        name: "feedbackReport";
+    };
+};
+//# sourceMappingURL=DB.d.ts.map

package/dist/shared/DB.d.ts.map

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

package/dist/shared/DB.js

@@ -0,0 +1,51 @@
+export function defineCollections(defs) {
+    return Object.fromEntries(Object.entries(defs).map(([k, v]) => [k, { ...v, name: k }]));
+}
+export function defineDbIndexes(idx) {
+    return idx;
+}
+export function dbDefaults() {
+    const now = new Date();
+    return { version: 1, created: now, updated: now };
+}
+export function createUserHelper(userDef) {
+    return {
+        get: (db, userId) => db.getDoc(userDef, userId),
+        set: (db, user) => db.setDoc(userDef, user),
+        update: (db, userId, fields) => db.setDocFields(userDef, userId, fields),
+    };
+}
+// ---------------------------------------------------------------------------
+// Builtin collection defs (no user — apps define their own)
+// ---------------------------------------------------------------------------
+export const BUILTIN_DEFS = defineCollections({
+    errorLog: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+    consoleLog: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+    perfLog: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+    feedbackLog: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+    billingSpend: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+    userCredits: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+    feedbackReport: {
+        type: {},
+        meta: { cache: false, trackable: false, public: false, parent: null },
+    },
+});
+//# sourceMappingURL=DB.js.map

package/dist/shared/DB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DB.js","sourceRoot":"","sources":["../../src/shared/DB.ts"],"names":[],"mappings":"AAwQA,MAAM,UAAU,iBAAiB,CAC/B,IAAU;IAEV,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAEtD,CAAC;AACX,CAAC;AA4BD,MAAM,UAAU,eAAe,CAA4B,GAAM;IAC/D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU;IAIxB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AACpD,CAAC;AAsBD,MAAM,UAAU,gBAAgB,CAC9B,OAAyB;IAEzB,OAAO;QACL,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAC/C,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;QAC3C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;KACzE,CAAC;AACJ,CAAC;AA6ED,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAC;IAC5C,QAAQ,EAAE;QACR,IAAI,EAAE,EAAc;QACpB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;IACD,UAAU,EAAE;QACV,IAAI,EAAE,EAAgB;QACtB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;IACD,OAAO,EAAE;QACP,IAAI,EAAE,EAAa;QACnB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;IACD,WAAW,EAAE;QACX,IAAI,EAAE,EAAiB;QACvB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,EAAkB;QACxB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;IACD,WAAW,EAAE;QACX,IAAI,EAAE,EAAiB;QACvB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,EAAuB;QAC7B,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;KACtE;CACF,CAAC,CAAC"}

package/dist/shared/Errors.d.ts

@@ -0,0 +1,10 @@
+export declare class NotFoundError extends Error {
+    constructor(message: string);
+}
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+export declare class SpendLimitError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=Errors.d.ts.map

package/dist/shared/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/shared/Errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,GAAE,MAAoD;CAI1E"}

package/dist/shared/Errors.js

@@ -0,0 +1,19 @@
+export class NotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotFoundError';
+    }
+}
+export class AuthError extends Error {
+    constructor(message) {
+        super(`AuthError: ${message}`);
+        this.name = 'AuthError';
+    }
+}
+export class SpendLimitError extends Error {
+    constructor(message = 'AI spend limit reached, try again shortly') {
+        super(message);
+        this.name = 'SpendLimitError';
+    }
+}
+//# sourceMappingURL=Errors.js.map

package/dist/shared/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../src/shared/Errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,UAAkB,2CAA2C;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/shared/FeedbackReport.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export interface FeedbackReport {
+    id: string;
+    userId: string;
+    type: 'bug' | 'feature' | 'design';
+    message: string;
+    url: string;
+    screenshotUri?: string;
+    context?: string;
+    status: 'pending' | 'captured' | 'resolved' | 'declined';
+    resolution?: string;
+    resolvedAt?: number;
+    version: number;
+    created: number;
+    updated: number;
+}
+export declare const SubmitFeedbackInput: z.ZodObject<{
+    message: z.ZodString;
+    type: z.ZodEnum<{
+        bug: "bug";
+        design: "design";
+        feature: "feature";
+    }>;
+    url: z.ZodString;
+    screenshotUri: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubmitFeedbackInputT = z.infer<typeof SubmitFeedbackInput>;
+export declare const ResolveFeedbackInput: z.ZodObject<{
+    feedbackId: z.ZodString;
+    status: z.ZodEnum<{
+        resolved: "resolved";
+        declined: "declined";
+    }>;
+    resolution: z.ZodString;
+}, z.core.$strip>;
+export type ResolveFeedbackInputT = z.infer<typeof ResolveFeedbackInput>;
+//# sourceMappingURL=FeedbackReport.d.ts.map

package/dist/shared/FeedbackReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackReport.d.ts","sourceRoot":"","sources":["../../src/shared/FeedbackReport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAM9B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,eAAO,MAAM,oBAAoB;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/shared/FeedbackReport.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const SubmitFeedbackInput = z.object({
+    message: z.string().min(1).max(5000),
+    type: z.enum(['bug', 'feature', 'design']),
+    url: z.string(),
+    screenshotUri: z.string().optional(),
+    context: z.string().optional(), // page-level context set via setFeedbackContext()
+});
+export const ResolveFeedbackInput = z.object({
+    feedbackId: z.string(),
+    status: z.enum(['resolved', 'declined']),
+    resolution: z.string().min(1),
+});
+//# sourceMappingURL=FeedbackReport.js.map

package/dist/shared/FeedbackReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackReport.js","sourceRoot":"","sources":["../../src/shared/FeedbackReport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,kDAAkD;CACnF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC"}

package/dist/shared/Router.d.ts

@@ -0,0 +1,28 @@
+export type TransitionType = 'REPLACE' | 'PUSH' | 'POP' | 'NONE';
+export type PopupSlideFrom = 'left' | 'right' | 'top' | 'bottom' | 'none';
+export type PopupMode = 'block' | 'transient' | 'contextMenu';
+export interface AnimConfig {
+    duration?: number;
+    easing?: (t: number) => number;
+}
+export interface PageMeta {
+    auth: boolean;
+    ssr: boolean;
+}
+export interface PageDef<Params extends Record<string, unknown>> extends PageMeta {
+    readonly _params?: Params;
+}
+export type PageRegistry = Record<string, PageDef<Record<string, unknown>>>;
+export type PageParams<P> = P extends PageDef<infer Params> ? Params : never;
+export interface AppRouterBase {
+    pages: PageRegistry;
+}
+export declare function definePage<Params extends Record<string, unknown>>(options?: Partial<PageMeta>): PageDef<Params>;
+export declare function definePages<T extends PageRegistry>(p: T): T;
+export interface RouterState {
+    routeName: string;
+    params: Record<string, string>;
+}
+export declare function buildUrl(pathTemplate: string, params: Record<string, unknown>): string;
+export declare function parseUrl(pages: PageRegistry, pathname: string, search: string): RouterState | null;
+//# sourceMappingURL=Router.d.ts.map

package/dist/shared/Router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../src/shared/Router.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC1E,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;AAC9D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC;AAGD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAGD,MAAM,WAAW,OAAO,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC7D,SAAQ,QAAQ;IAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAG5E,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;CACrB;AAGD,wBAAgB,UAAU,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,GAAE,OAAO,CAAC,QAAQ,CAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAKjB;AAGD,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAE3D;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAUD,wBAAgB,QAAQ,CACtB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CA4BR;AAID,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CAoCpB"}

package/dist/shared/Router.js

@@ -0,0 +1,82 @@
+// Factory: returns a real runtime object { auth, ssr }. Params is phantom.
+export function definePage(options = {}) {
+    return {
+        auth: options.auth ?? true,
+        ssr: options.ssr ?? false,
+    };
+}
+// Pass-through identity (mirrors defineFunctions pattern)
+export function definePages(p) {
+    return p;
+}
+// Escape special regex metacharacters in a literal string segment
+function escapeRegex(s) {
+    return s.replace(/[.+*?^${}()|[\]\\]/g, '\\$&');
+}
+// Build URL from path template + params
+// :name segments fill a single path component; *name segments fill the rest (may include slashes)
+// Remaining non-null params become ?query=string
+export function buildUrl(pathTemplate, params) {
+    const usedParams = new Set();
+    const path = pathTemplate
+        .split('/')
+        .map((segment) => {
+        if (segment.startsWith(':') || segment.startsWith('*')) {
+            const name = segment.slice(1);
+            usedParams.add(name);
+            const value = params[name];
+            if (segment.startsWith(':') && (value === null || value === undefined))
+                throw new Error(`Missing required path parameter: "${name}"`);
+            return value !== null && value !== undefined ? String(value) : '';
+        }
+        return segment;
+    })
+        .join('/');
+    const qs = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (!usedParams.has(key) && value !== null && value !== undefined) {
+            qs.append(key, String(value));
+        }
+    }
+    const qsStr = qs.toString();
+    const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
+    return qsStr ? `/${normalizedPath}?${qsStr}` : `/${normalizedPath}`;
+}
+// Match pathname+search against pages registry
+// Returns RouterState or null (no match)
+export function parseUrl(pages, pathname, search) {
+    // Strip leading slash for matching against route keys
+    const normalizedPathname = pathname.startsWith('/')
+        ? pathname.slice(1)
+        : pathname;
+    for (const [routeKey] of Object.entries(pages)) {
+        // Convert route key to regex: split on '/', classify each segment by prefix
+        const regexSource = routeKey
+            .split('/')
+            .map((segment) => {
+            if (segment.startsWith(':'))
+                return `(?<${segment.slice(1)}>[^/]+)`;
+            if (segment.startsWith('*'))
+                return `(?<${segment.slice(1)}>[^]*)`;
+            return escapeRegex(segment);
+        })
+            .join('/');
+        const regex = new RegExp(`^${regexSource}$`);
+        const match = regex.exec(normalizedPathname);
+        if (match) {
+            const queryParams = {};
+            if (search) {
+                const searchStr = search.startsWith('?') ? search.slice(1) : search;
+                for (const [key, value] of new URLSearchParams(searchStr)) {
+                    queryParams[key] = value;
+                }
+            }
+            return {
+                routeName: routeKey,
+                params: { ...queryParams, ...match.groups },
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=Router.js.map

package/dist/shared/Router.js.map

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