@de-otio/trellis 0.4.0

package/dist/lib/taxonomy-metrics.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Taxonomy Metrics
+ *
+ * Analytics and usage metrics tracking for taxonomy system.
+ *
+ * @see doc/requirements/taxonomy/14_analytics_usage_metrics.md
+ */
+import { PrismaClient } from "@prisma/client";
+export interface TaxonMetric {
+    taxonId: string;
+    displayName: string;
+    dimension: string;
+    category: string;
+    usageCount: number;
+    userCount: number;
+    contentCount: number;
+    lastUsedAt: Date | null;
+}
+export interface PruningCandidate {
+    taxonId: string;
+    displayName: string;
+    reason: "unused" | "low_usage" | "single_user" | "stale" | "unknown";
+    metrics: TaxonMetric;
+}
+export interface FreeFormTag {
+    tag: string;
+    usageCount: number;
+    suggestedTaxon?: string;
+}
+export declare class TaxonomyMetrics {
+    private prisma;
+    constructor(prisma: PrismaClient);
+    /**
+     * Get comprehensive metrics for all taxons
+     */
+    getTaxonMetrics(tenantId: string, options?: {
+        dimension?: string;
+        minUsageCount?: number;
+        includeUnused?: boolean;
+    }): Promise<TaxonMetric[]>;
+    /**
+     * Get usage count for each taxon
+     */
+    getTaxonUsageCounts(tenantId: string, dimension?: string): Promise<Array<{
+        taxonId: string;
+        usageCount: number;
+    }>>;
+    /**
+     * Get unique user count for each taxon
+     */
+    getTaxonUserCounts(tenantId: string): Promise<Array<{
+        taxonId: string;
+        userCount: number;
+    }>>;
+    /**
+     * Get last used timestamp for each taxon
+     */
+    getTaxonLastUsed(tenantId: string): Promise<Array<{
+        taxonId: string;
+        lastUsedAt: Date | null;
+    }>>;
+    /**
+     * Check for taxons that should be pruned
+     */
+    checkPruningCandidates(tenantId: string): Promise<PruningCandidate[]>;
+    private determinePruningReason;
+    /**
+     * Get popular free-form tags that don't match taxonomy.
+     *
+     * Currently returns an empty array because the schema does not have a
+     * free-form tags table — all tags are structured taxonomy taxons.
+     * When free-form tagging is added, this method should query that table.
+     */
+    getPopularFreeFormTags(_tenantId: string, _limit?: number): Promise<FreeFormTag[]>;
+}
+//# sourceMappingURL=taxonomy-metrics.d.ts.map

package/dist/lib/taxonomy-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/taxonomy-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAU,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;IACrE,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAExC;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GACA,OAAO,CAAC,WAAW,EAAE,CAAC;IA+DzB;;OAEG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAuC1D;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA0BzD;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IA8B/D;;OAEG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAmC3E,OAAO,CAAC,sBAAsB;IAY9B;;;;;;OAMG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAY,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC;CAG1B"}

package/dist/lib/taxonomy-metrics.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Taxonomy Metrics
+ *
+ * Analytics and usage metrics tracking for taxonomy system.
+ *
+ * @see doc/requirements/taxonomy/14_analytics_usage_metrics.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaxonomyMetrics = void 0;
+const client_1 = require("@prisma/client");
+class TaxonomyMetrics {
+    prisma;
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    /**
+     * Get comprehensive metrics for all taxons
+     */
+    async getTaxonMetrics(tenantId, options) {
+        const { dimension, minUsageCount = 0, includeUnused = true, } = options || {};
+        const results = await this.prisma.$queryRaw `
+      SELECT
+        t."taxonId" as taxon_id,
+        t.display_name,
+        d.code as dimension,
+        c.code as category,
+        COUNT(DISTINCT pt.id) +
+        COUNT(DISTINCT et.id) +
+        COUNT(DISTINCT prt.id) as usage_count,
+        COUNT(DISTINCT COALESCE(pt.added_by, et.entity_id, prt.product_id)) as user_count,
+        COUNT(DISTINCT pt.post_id) +
+        COUNT(DISTINCT et.entity_id) +
+        COUNT(DISTINCT prt.product_id) as content_count,
+        GREATEST(
+          MAX(pt.created_at),
+          MAX(et.created_at),
+          MAX(prt.created_at)
+        ) as last_used_at
+      FROM taxonomy_taxons t
+      INNER JOIN taxonomy_categories c ON c.id = t.category_id
+      INNER JOIN taxonomy_dimensions d ON d.id = c.dimension_id
+      LEFT JOIN post_taxonomy_tags pt ON pt.taxon_id = t.id
+      LEFT JOIN entity_taxonomy_tags et ON et.taxon_id = t.id
+      LEFT JOIN product_taxonomy_tags prt ON prt.taxon_id = t.id
+      WHERE t.tenant_id = ${tenantId}
+        AND t.is_active = true
+        ${dimension ? client_1.Prisma.sql `AND d.code = ${dimension}` : client_1.Prisma.empty}
+      GROUP BY t."taxonId", t.display_name, d.code, c.code
+      HAVING COUNT(DISTINCT pt.id) + COUNT(DISTINCT et.id) + COUNT(DISTINCT prt.id) >= ${minUsageCount}
+        OR ${includeUnused} = true
+      ORDER BY usage_count DESC, last_used_at DESC NULLS LAST
+    `;
+        return results.map((r) => ({
+            taxonId: r.taxon_id,
+            displayName: r.display_name,
+            dimension: r.dimension,
+            category: r.category,
+            usageCount: Number(r.usage_count),
+            userCount: Number(r.user_count),
+            contentCount: Number(r.content_count),
+            lastUsedAt: r.last_used_at,
+        }));
+    }
+    /**
+     * Get usage count for each taxon
+     */
+    async getTaxonUsageCounts(tenantId, dimension) {
+        const results = await this.prisma.$queryRaw `
+      SELECT
+        t."taxonId" as taxon_id,
+        COUNT(DISTINCT pt.id) +
+        COUNT(DISTINCT et.id) +
+        COUNT(DISTINCT prt.id) as usage_count
+      FROM taxonomy_taxons t
+      LEFT JOIN post_taxonomy_tags pt ON pt.taxon_id = t.id
+      LEFT JOIN entity_taxonomy_tags et ON et.taxon_id = t.id
+      LEFT JOIN product_taxonomy_tags prt ON prt.taxon_id = t.id
+      WHERE t.tenant_id = ${tenantId}
+        AND t.is_active = true
+        ${dimension
+            ? client_1.Prisma.sql `AND t.category_id IN (
+          SELECT id FROM taxonomy_categories
+          WHERE dimension_id IN (
+            SELECT id FROM taxonomy_dimensions
+            WHERE tenant_id = ${tenantId} AND code = ${dimension}
+          )
+        )`
+            : client_1.Prisma.empty}
+      GROUP BY t."taxonId"
+      ORDER BY usage_count DESC
+    `;
+        return results.map((r) => ({
+            taxonId: r.taxon_id,
+            usageCount: Number(r.usage_count),
+        }));
+    }
+    /**
+     * Get unique user count for each taxon
+     */
+    async getTaxonUserCounts(tenantId) {
+        const results = await this.prisma.$queryRaw `
+      SELECT
+        t."taxonId" as taxon_id,
+        COUNT(DISTINCT COALESCE(pt.added_by, et.entity_id, prt.product_id)) as user_count
+      FROM taxonomy_taxons t
+      LEFT JOIN post_taxonomy_tags pt ON pt.taxon_id = t.id
+      LEFT JOIN entity_taxonomy_tags et ON et.taxon_id = t.id
+      LEFT JOIN product_taxonomy_tags prt ON prt.taxon_id = t.id
+      WHERE t.tenant_id = ${tenantId}
+        AND t.is_active = true
+      GROUP BY t."taxonId"
+      ORDER BY user_count DESC
+    `;
+        return results.map((r) => ({
+            taxonId: r.taxon_id,
+            userCount: Number(r.user_count),
+        }));
+    }
+    /**
+     * Get last used timestamp for each taxon
+     */
+    async getTaxonLastUsed(tenantId) {
+        const results = await this.prisma.$queryRaw `
+      SELECT
+        t."taxonId" as taxon_id,
+        GREATEST(
+          MAX(pt.created_at),
+          MAX(et.created_at),
+          MAX(prt.created_at)
+        ) as last_used_at
+      FROM taxonomy_taxons t
+      LEFT JOIN post_taxonomy_tags pt ON pt.taxon_id = t.id
+      LEFT JOIN entity_taxonomy_tags et ON et.taxon_id = t.id
+      LEFT JOIN product_taxonomy_tags prt ON prt.taxon_id = t.id
+      WHERE t.tenant_id = ${tenantId}
+        AND t.is_active = true
+      GROUP BY t."taxonId"
+      ORDER BY last_used_at DESC NULLS LAST
+    `;
+        return results.map((r) => ({
+            taxonId: r.taxon_id,
+            lastUsedAt: r.last_used_at,
+        }));
+    }
+    /**
+     * Check for taxons that should be pruned
+     */
+    async checkPruningCandidates(tenantId) {
+        const metrics = await this.getTaxonMetrics(tenantId, {
+            includeUnused: true,
+        });
+        const twelveMonthsAgo = new Date();
+        twelveMonthsAgo.setMonth(twelveMonthsAgo.getMonth() - 12);
+        return metrics
+            .filter((m) => {
+            // Unused for 12+ months
+            if (m.lastUsedAt && m.lastUsedAt < twelveMonthsAgo) {
+                return true;
+            }
+            // Low usage
+            if (m.usageCount < 5) {
+                return true;
+            }
+            // Single user
+            if (m.userCount === 1) {
+                return true;
+            }
+            return false;
+        })
+            .map((m) => ({
+            taxonId: m.taxonId,
+            displayName: m.displayName,
+            reason: this.determinePruningReason(m, twelveMonthsAgo),
+            metrics: m,
+        }));
+    }
+    determinePruningReason(metric, twelveMonthsAgo) {
+        if (metric.usageCount === 0)
+            return "unused";
+        if (metric.usageCount < 5)
+            return "low_usage";
+        if (metric.userCount === 1)
+            return "single_user";
+        if (metric.lastUsedAt && metric.lastUsedAt < twelveMonthsAgo)
+            return "stale";
+        return "unknown";
+    }
+    /**
+     * Get popular free-form tags that don't match taxonomy.
+     *
+     * Currently returns an empty array because the schema does not have a
+     * free-form tags table — all tags are structured taxonomy taxons.
+     * When free-form tagging is added, this method should query that table.
+     */
+    async getPopularFreeFormTags(_tenantId, _limit = 100) {
+        return [];
+    }
+}
+exports.TaxonomyMetrics = TaxonomyMetrics;
+//# sourceMappingURL=taxonomy-metrics.js.map

package/dist/lib/taxonomy-metrics.js.map

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

package/dist/lib/taxonomy-search-metrics.d.ts

@@ -0,0 +1,45 @@
+import type { KVNamespace } from "../types/cloudflare-compat";
+/**
+ * Taxonomy Search Metrics
+ *
+ * Tracks search queries and results for analytics and continuous improvement.
+ */
+import { type LoggerEnv } from "./logger";
+export interface SearchMetrics {
+    query: string;
+    resultCount: number;
+    timestamp: number;
+    dimension?: string;
+    category?: string;
+    tenantId: string;
+    userId?: string;
+}
+export interface SearchMetricsSummary {
+    totalQueries: number;
+    uniqueQueries: number;
+    averageResultCount: number;
+    topQueries: Array<{
+        query: string;
+        count: number;
+    }>;
+    queriesWithNoResults: number;
+}
+export declare class TaxonomySearchMetrics {
+    private kv?;
+    private enabled;
+    private logger;
+    constructor(kv?: KVNamespace, enabled?: boolean, env?: LoggerEnv | any);
+    /**
+     * Track a search query
+     */
+    trackSearch(metrics: SearchMetrics): Promise<void>;
+    /**
+     * Increment query count for analytics
+     */
+    private incrementQueryCount;
+    /**
+     * Get search metrics summary (for analytics dashboard)
+     */
+    getSearchSummary(tenantId: string, days?: number): Promise<SearchMetricsSummary>;
+}
+//# sourceMappingURL=taxonomy-search-metrics.d.ts.map

package/dist/lib/taxonomy-search-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy-search-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/taxonomy-search-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,4BAA4B,CAAC;AACzF;;;;GAIG;AAGH,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,EAAE,CAAC,CAAc;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;gBAGrB,EAAE,CAAC,EAAE,WAAW,EAChB,OAAO,GAAE,OAAc,EACvB,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG;IAOvB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD;;OAEG;YACW,mBAAmB;IAmBjC;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,oBAAoB,CAAC;CAYjC"}

package/dist/lib/taxonomy-search-metrics.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaxonomySearchMetrics = void 0;
+/**
+ * Taxonomy Search Metrics
+ *
+ * Tracks search queries and results for analytics and continuous improvement.
+ */
+const logger_1 = require("./logger");
+class TaxonomySearchMetrics {
+    kv;
+    enabled;
+    logger;
+    constructor(kv, enabled = true, env) {
+        this.kv = kv;
+        this.enabled = enabled;
+        this.logger = logger_1.Logger.getInstance(env);
+    }
+    /**
+     * Track a search query
+     */
+    async trackSearch(metrics) {
+        if (!this.enabled || !this.kv) {
+            return;
+        }
+        try {
+            const key = `search:metrics:${metrics.tenantId}:${Date.now()}:${Math.random()}`;
+            await this.kv.put(key, JSON.stringify(metrics), {
+                expirationTtl: 86400 * 30, // 30 days
+            });
+            // Also track in aggregate counters
+            await this.incrementQueryCount(metrics.tenantId, metrics.query);
+        }
+        catch (error) {
+            // Don't fail search if metrics tracking fails
+            this.logger.error("Error tracking search metrics:", error);
+        }
+    }
+    /**
+     * Increment query count for analytics
+     */
+    async incrementQueryCount(tenantId, query) {
+        if (!this.kv)
+            return;
+        try {
+            const normalizedQuery = query.toLowerCase().trim();
+            const counterKey = `search:counter:${tenantId}:${normalizedQuery}`;
+            const current = await this.kv.get(counterKey);
+            const count = current ? parseInt(current, 10) + 1 : 1;
+            await this.kv.put(counterKey, count.toString(), {
+                expirationTtl: 86400 * 90, // 90 days
+            });
+        }
+        catch (error) {
+            this.logger.error("Error incrementing query count:", error);
+        }
+    }
+    /**
+     * Get search metrics summary (for analytics dashboard)
+     */
+    async getSearchSummary(tenantId, days = 7) {
+        // This would require scanning KV keys, which is expensive
+        // For production, consider using a time-series database or analytics service
+        // This is a placeholder implementation
+        return {
+            totalQueries: 0,
+            uniqueQueries: 0,
+            averageResultCount: 0,
+            topQueries: [],
+            queriesWithNoResults: 0,
+        };
+    }
+}
+exports.TaxonomySearchMetrics = TaxonomySearchMetrics;
+//# sourceMappingURL=taxonomy-search-metrics.js.map

package/dist/lib/taxonomy-search-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy-search-metrics.js","sourceRoot":"","sources":["../../src/lib/taxonomy-search-metrics.ts"],"names":[],"mappings":";;;AACA;;;;GAIG;AAGH,qCAAkD;AAoBlD,MAAa,qBAAqB;IACxB,EAAE,CAAe;IACjB,OAAO,CAAU;IACjB,MAAM,CAAS;IAEvB,YACE,EAAgB,EAChB,UAAmB,IAAI,EACvB,GAAqB;QAErB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,eAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAsB;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,kBAAkB,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAChF,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;gBAC9C,aAAa,EAAE,KAAK,GAAG,EAAE,EAAE,UAAU;aACtC,CAAC,CAAC;YAEH,mCAAmC;YACnC,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8CAA8C;YAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAC/B,QAAgB,EAChB,KAAa;QAEb,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,UAAU,GAAG,kBAAkB,QAAQ,IAAI,eAAe,EAAE,CAAC;YACnE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE;gBAC9C,aAAa,EAAE,KAAK,GAAG,EAAE,EAAE,UAAU;aACtC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,QAAgB,EAChB,OAAe,CAAC;QAEhB,0DAA0D;QAC1D,6EAA6E;QAC7E,uCAAuC;QACvC,OAAO;YACL,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,UAAU,EAAE,EAAE;YACd,oBAAoB,EAAE,CAAC;SACxB,CAAC;IACJ,CAAC;CACF;AA7ED,sDA6EC"}

package/dist/lib/tenant-context.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tenant Context
+ *
+ * Provides tenant context structure for white-label support.
+ * For MVP, always returns single tenant (Trellis).
+ * Future: Will support multi-tenant detection and configuration.
+ */
+import type { Session } from "./session-manager";
+export interface Tenant {
+    id: string;
+    name: string;
+}
+export interface TenantRequestContext {
+    tenant?: Tenant;
+    user?: {
+        id: string;
+        email: string;
+    };
+}
+/**
+ * Get request context with tenant information
+ *
+ * For MVP, always returns single tenant (Trellis).
+ * Future: Will detect tenant from subdomain/custom domain.
+ *
+ * @param request - Request object
+ * @param session - Optional session
+ * @returns Request context with tenant
+ */
+export declare function getRequestContext(request: Request, session?: Session | null): Promise<TenantRequestContext>;
+/**
+ * Get request context synchronously
+ */
+export declare function getRequestContextSync(request: Request, session?: Session | null): TenantRequestContext;
+//# sourceMappingURL=tenant-context.d.ts.map

package/dist/lib/tenant-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-context.d.ts","sourceRoot":"","sources":["../../src/lib/tenant-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAEd;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KAEf,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,oBAAoB,CAatB"}

package/dist/lib/tenant-context.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Tenant Context
+ *
+ * Provides tenant context structure for white-label support.
+ * For MVP, always returns single tenant (Trellis).
+ * Future: Will support multi-tenant detection and configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRequestContext = getRequestContext;
+exports.getRequestContextSync = getRequestContextSync;
+/**
+ * Get request context with tenant information
+ *
+ * For MVP, always returns single tenant (Trellis).
+ * Future: Will detect tenant from subdomain/custom domain.
+ *
+ * @param request - Request object
+ * @param session - Optional session
+ * @returns Request context with tenant
+ */
+async function getRequestContext(request, session) {
+    // For MVP, always return single tenant
+    return {
+        tenant: {
+            id: "trellis",
+            name: "Trellis",
+        },
+        user: session
+            ? {
+                id: session.userId,
+                email: session.email || "",
+            }
+            : undefined,
+    };
+}
+/**
+ * Get request context synchronously
+ */
+function getRequestContextSync(request, session) {
+    return {
+        tenant: {
+            id: "trellis",
+            name: "Trellis",
+        },
+        user: session
+            ? {
+                id: session.userId,
+                email: session.email || "",
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=tenant-context.js.map

package/dist/lib/tenant-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-context.js","sourceRoot":"","sources":["../../src/lib/tenant-context.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA6BH,8CAiBC;AAKD,sDAgBC;AAhDD;;;;;;;;;GASG;AACI,KAAK,UAAU,iBAAiB,CACrC,OAAgB,EAChB,OAAwB;IAExB,uCAAuC;IACvC,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,SAAS;SAChB;QACD,IAAI,EAAE,OAAO;YACX,CAAC,CAAC;gBACE,EAAE,EAAE,OAAO,CAAC,MAAM;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;aAC3B;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,OAAgB,EAChB,OAAwB;IAExB,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,SAAS;SAChB;QACD,IAAI,EAAE,OAAO;YACX,CAAC,CAAC;gBACE,EAAE,EAAE,OAAO,CAAC,MAAM;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;aAC3B;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/lib/terminology.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Terminology Abstraction
+ *
+ * Provides configurable terminology backed by the extension registry.
+ * Each extension provides its own terminology (entity name, plural).
+ */
+export interface Terminology {
+    entity: string;
+    entityPlural: string;
+    post: string;
+    profile: string;
+    owner: string;
+}
+/**
+ * Get terminology, optionally for a specific entity type.
+ *
+ * If entityType is provided and a matching extension is registered,
+ * its terminology overrides the defaults.
+ */
+export declare function getTerminology(entityType?: string): Terminology;
+/**
+ * Get terminology synchronously (for use in non-async contexts)
+ */
+export declare function getTerminologySync(entityType?: string): Terminology;
+//# sourceMappingURL=terminology.d.ts.map

package/dist/lib/terminology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminology.d.ts","sourceRoot":"","sources":["../../src/lib/terminology.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAY/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAEnE"}

package/dist/lib/terminology.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Terminology Abstraction
+ *
+ * Provides configurable terminology backed by the extension registry.
+ * Each extension provides its own terminology (entity name, plural).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTerminology = getTerminology;
+exports.getTerminologySync = getTerminologySync;
+const extensions_1 = require("../extensions");
+const DEFAULT_TERMINOLOGY = {
+    entity: "entity",
+    entityPlural: "entities",
+    post: "post",
+    profile: "profile",
+    owner: "owner",
+};
+/**
+ * Get terminology, optionally for a specific entity type.
+ *
+ * If entityType is provided and a matching extension is registered,
+ * its terminology overrides the defaults.
+ */
+function getTerminology(entityType) {
+    if (entityType) {
+        const ext = (0, extensions_1.getExtension)(entityType);
+        if (ext) {
+            return {
+                ...DEFAULT_TERMINOLOGY,
+                entity: ext.terminology.entity,
+                entityPlural: ext.terminology.entityPlural,
+            };
+        }
+    }
+    return DEFAULT_TERMINOLOGY;
+}
+/**
+ * Get terminology synchronously (for use in non-async contexts)
+ */
+function getTerminologySync(entityType) {
+    return getTerminology(entityType);
+}
+//# sourceMappingURL=terminology.js.map

package/dist/lib/terminology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminology.js","sourceRoot":"","sources":["../../src/lib/terminology.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA0BH,wCAYC;AAKD,gDAEC;AA3CD,8CAA6C;AAU7C,MAAM,mBAAmB,GAAgB;IACvC,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,UAAU;IACxB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,UAAmB;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAA,yBAAY,EAAC,UAAU,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,OAAO;gBACL,GAAG,mBAAmB;gBACtB,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,MAAM;gBAC9B,YAAY,EAAE,GAAG,CAAC,WAAW,CAAC,YAAY;aAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,UAAmB;IACpD,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/theme.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Theme Configuration
+ *
+ * Provides theme structure for white-label support.
+ * For MVP, always returns default Trellis theme.
+ * Future: Will support tenant-specific themes.
+ */
+export interface Theme {
+    primaryColor: string;
+    secondaryColor: string;
+    logoUrl?: string;
+    faviconUrl?: string;
+    name?: string;
+}
+/**
+ * Get theme for a tenant
+ *
+ * For MVP, always returns default Trellis theme.
+ * Future: Will look up tenant-specific theme from database.
+ *
+ * @param tenantId - Optional tenant ID (not used in MVP)
+ * @returns Theme object
+ */
+export declare function getTheme(tenantId?: string): Theme;
+/**
+ * Get theme synchronously
+ */
+export declare function getThemeSync(tenantId?: string): Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/lib/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/lib/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAGjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAErD"}

package/dist/lib/theme.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Theme Configuration
+ *
+ * Provides theme structure for white-label support.
+ * For MVP, always returns default Trellis theme.
+ * Future: Will support tenant-specific themes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTheme = getTheme;
+exports.getThemeSync = getThemeSync;
+const DEFAULT_THEME = {
+    primaryColor: "#3B82F6", // Trellis blue
+    secondaryColor: "#10B981", // Trellis green
+    logoUrl: "/logo.svg",
+    faviconUrl: "/favicon.ico",
+    name: "Trellis",
+};
+/**
+ * Get theme for a tenant
+ *
+ * For MVP, always returns default Trellis theme.
+ * Future: Will look up tenant-specific theme from database.
+ *
+ * @param tenantId - Optional tenant ID (not used in MVP)
+ * @returns Theme object
+ */
+function getTheme(tenantId) {
+    // For MVP, always return default
+    return DEFAULT_THEME;
+}
+/**
+ * Get theme synchronously
+ */
+function getThemeSync(tenantId) {
+    return DEFAULT_THEME;
+}
+//# sourceMappingURL=theme.js.map