aimeat 1.40.1 → 2.1.0

package/dist/src/storage/providers/postgres-kysely/methods/system-extras.js

@@ -0,0 +1,109 @@
+/**
+ * @file src/storage/providers/postgres-kysely/methods/system-extras.ts
+ * @description System prompts (SystemPrompt + SystemPromptVersion) and the federation replication queue
+ *   (ReplicationQueue) for the Postgres+Kysely backend. Translated to match the Prisma provider.
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 5: system prompts + replication queue on Postgres+Kysely.
+ */
+import { sql } from 'kysely';
+import { jsonb } from '../helpers.js';
+const iso = (t) => (t instanceof Date ? t : new Date(t)).toISOString();
+const isoN = (t) => (t == null ? null : iso(t));
+function toPrompt(r) {
+    return {
+        id: r.id, name: r.name, group: r.group, description: r.description, content: r.content,
+        variables: r.variables ?? [], usedIn: r.usedIn ?? [], locales: (r.locales ?? undefined),
+        active: r.active, version: r.version, updatedBy: r.updatedBy, updatedAt: iso(r.updatedAt),
+    };
+}
+function toVersion(r) {
+    return {
+        promptId: r.promptId, version: r.version, content: r.content, locales: (r.locales ?? undefined),
+        changedBy: r.changedBy, changeNote: r.changeNote ?? undefined, changedAt: iso(r.changedAt),
+    };
+}
+function toQueue(r) {
+    return {
+        id: r.id, type: r.type, payload: r.payload ?? undefined, targetPeers: r.targetPeers ?? [],
+        attempts: r.attempts, status: r.status, createdAt: iso(r.createdAt), lastAttemptAt: isoN(r.lastAttemptAt),
+    };
+}
+export const systemPromptMethods = {
+    async listSystemPrompts(opts) {
+        let q = this.db.selectFrom('SystemPrompt').selectAll();
+        if (opts?.group)
+            q = q.where('group', '=', opts.group);
+        return (await q.execute()).map(toPrompt);
+    },
+    async getSystemPrompt(id) {
+        const r = await this.db.selectFrom('SystemPrompt').selectAll().where('id', '=', id).executeTakeFirst();
+        return r ? toPrompt(r) : null;
+    },
+    async upsertSystemPrompt(r) {
+        const shared = { name: r.name, group: r.group, description: r.description ?? '', content: r.content, variables: r.variables ?? [], usedIn: r.usedIn ?? [], locales: jsonb(r.locales ?? null), active: r.active, version: r.version, updatedBy: r.updatedBy, updatedAt: new Date(r.updatedAt) };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await this.db.insertInto('SystemPrompt').values({ id: r.id, ...shared })
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .onConflict(oc => oc.column('id').doUpdateSet(shared)).execute();
+        return r;
+    },
+    async getSystemPromptVersions(promptId) {
+        return (await this.db.selectFrom('SystemPromptVersion').selectAll().where('promptId', '=', promptId).orderBy('version', 'desc').execute()).map(toVersion);
+    },
+    async getSystemPromptVersion(promptId, version) {
+        const r = await this.db.selectFrom('SystemPromptVersion').selectAll().where('promptId', '=', promptId).where('version', '=', version).executeTakeFirst();
+        return r ? toVersion(r) : null;
+    },
+    async createSystemPromptVersion(r) {
+        await this.db.insertInto('SystemPromptVersion').values({
+            promptId: r.promptId, version: r.version, content: r.content, locales: jsonb(r.locales ?? null), changedBy: r.changedBy, changeNote: r.changeNote ?? null,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }).execute();
+        return r;
+    },
+    async pruneSystemPromptVersions(promptId, keepCount) {
+        const keep = await this.db.selectFrom('SystemPromptVersion').select('version').where('promptId', '=', promptId).orderBy('version', 'desc').limit(keepCount).execute();
+        const keepVersions = keep.map(k => k.version);
+        let q = this.db.deleteFrom('SystemPromptVersion').where('promptId', '=', promptId);
+        if (keepVersions.length)
+            q = q.where('version', 'not in', keepVersions);
+        const r = await q.executeTakeFirst();
+        return Number(r.numDeletedRows ?? 0);
+    },
+    async deleteAllSystemPrompts() {
+        await this.db.deleteFrom('SystemPromptVersion').execute();
+        await this.db.deleteFrom('SystemPrompt').execute();
+    },
+};
+export const replicationQueueMethods = {
+    async enqueueReplication(entry) {
+        const [row] = await this.db.insertInto('ReplicationQueue').values({
+            type: entry.type, payload: entry.payload == null ? null : (typeof entry.payload === 'string' ? entry.payload : JSON.stringify(entry.payload)), targetPeers: entry.targetPeers ?? [], attempts: 0, status: 'pending',
+        }).returning('id').execute();
+        return row.id;
+    },
+    async dequeueReplication(peerId, limit) {
+        const rows = await this.db.selectFrom('ReplicationQueue').selectAll().where('status', '=', 'pending')
+            .where(sql `${peerId} = ANY("targetPeers")`).orderBy('createdAt', 'asc').limit(limit).execute();
+        return rows.map(toQueue);
+    },
+    async markReplicationSent(ids) {
+        if (ids.length === 0)
+            return;
+        await this.db.updateTable('ReplicationQueue').set({ status: 'sent', lastAttemptAt: new Date() }).where('id', 'in', ids).execute();
+    },
+    async markReplicationFailed(ids) {
+        if (ids.length === 0)
+            return;
+        await this.db.updateTable('ReplicationQueue').set({ status: 'failed', lastAttemptAt: new Date(), attempts: sql `"attempts" + 1` }).where('id', 'in', ids).execute();
+    },
+    async pruneReplicationQueue(maxAge) {
+        const r = await this.db.deleteFrom('ReplicationQueue').where('createdAt', '<', maxAge).executeTakeFirst();
+        return Number(r.numDeletedRows ?? 0);
+    },
+    async replicationQueueSize() {
+        const r = await this.db.selectFrom('ReplicationQueue').select(sql `count(*)`.as('n')).where('status', '=', 'pending').executeTakeFirst();
+        return Number(r?.n ?? 0);
+    },
+};
+//# sourceMappingURL=system-extras.js.map

package/dist/src/storage/providers/postgres-kysely/methods/system-extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-extras.js","sourceRoot":"","sources":["../../../../../../src/storage/providers/postgres-kysely/methods/system-extras.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/providers/postgres-kysely/methods/system.d.ts

@@ -0,0 +1,32 @@
+import type { MaintenanceState, StorageStatsSnapshot } from '../../../interface.js';
+import type { PostgresKyselyStorage } from '../index.js';
+export declare const systemMethods: {
+    supportsConfigPersistence(this: PostgresKyselyStorage): boolean;
+    getConfigValue(this: PostgresKyselyStorage, key: string): Promise<string | null>;
+    setConfigValue(this: PostgresKyselyStorage, key: string, value: string): Promise<void>;
+    deleteConfigValue(this: PostgresKyselyStorage, key: string): Promise<void>;
+    getAllConfigValues(this: PostgresKyselyStorage): Promise<Record<string, string>>;
+    getMaintenanceMode(this: PostgresKyselyStorage): Promise<MaintenanceState>;
+    setMaintenanceMode(this: PostgresKyselyStorage, state: MaintenanceState): Promise<MaintenanceState>;
+    setNodeKey(this: PostgresKyselyStorage, publicKey: string, privateKey: string): Promise<void>;
+    getNodeKey(this: PostgresKyselyStorage): Promise<{
+        publicKey: string;
+        privateKey: string;
+    } | null>;
+    flushStats(this: PostgresKyselyStorage, counters: Record<string, number>): Promise<void>;
+    loadStats(this: PostgresKyselyStorage): Promise<Record<string, number>>;
+    flushDailyHistory(this: PostgresKyselyStorage, history: Record<string, Record<string, number>>): Promise<void>;
+    loadDailyHistory(this: PostgresKyselyStorage): Promise<Record<string, Record<string, number>>>;
+    getTableRowCounts(this: PostgresKyselyStorage): Promise<Record<string, number>>;
+    getMemoryRowBreakdown(this: PostgresKyselyStorage): Promise<{
+        versionRows: number;
+        archivedRows: number;
+    }>;
+    saveStorageStatsSnapshot(this: PostgresKyselyStorage, s: StorageStatsSnapshot): Promise<void>;
+    listStorageStatsSnapshots(this: PostgresKyselyStorage, opts?: {
+        limit?: number;
+        sinceIso?: string;
+    }): Promise<StorageStatsSnapshot[]>;
+    pruneStorageStatsSnapshots(this: PostgresKyselyStorage, beforeIso: string): Promise<number>;
+};
+//# sourceMappingURL=system.d.ts.map

package/dist/src/storage/providers/postgres-kysely/methods/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/providers/postgres-kysely/methods/system.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,eAAO,MAAM,aAAa;oCAEQ,qBAAqB,GAAG,OAAO;yBAEpC,qBAAqB,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;yBAK3D,qBAAqB,OAAO,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;4BAK9D,qBAAqB,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;6BAIjD,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;6BAQvD,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;6BAKjD,qBAAqB,SAAS,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;qBAQlF,qBAAqB,aAAa,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;qBAM5E,qBAAqB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;qBAMjF,qBAAqB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;oBAOxE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;4BAO/C,qBAAqB,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;2BAYvF,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;4BAQtE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gCAiBnD,qBAAqB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;mCAU3E,qBAAqB,KAAK,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;oCAM7D,qBAAqB,SAAS;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;qCAWpG,qBAAqB,aAAa,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlG,CAAC"}

package/dist/src/storage/providers/postgres-kysely/methods/system.js

@@ -0,0 +1,144 @@
+/**
+ * @file src/storage/providers/postgres-kysely/methods/system.ts
+ * @description Node-wide system methods for the Postgres+Kysely backend: config persistence, maintenance
+ *   mode, the node keypair, and the stats counters/daily-history — the group the server touches during
+ *   boot (config-init) and the stats flusher. Translated 1:1 from the Prisma implementations against the
+ *   same tables (SystemSetting keyed `config:*` / `maintenance`, NodeKey, StatsCounter, StatsDailyHistory).
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 5: startup/system domain on Postgres+Kysely.
+ */
+import { sql } from 'kysely';
+import { jsonb } from '../helpers.js';
+export const systemMethods = {
+    // ── Config persistence (SystemSetting, key `config:<dotPath>`) ──
+    supportsConfigPersistence() { return true; },
+    async getConfigValue(key) {
+        const r = await this.db.selectFrom('SystemSetting').select('value').where('key', '=', `config:${key}`).executeTakeFirst();
+        return r?.value ?? null;
+    },
+    async setConfigValue(key, value) {
+        await this.db.insertInto('SystemSetting').values({ key: `config:${key}`, value })
+            .onConflict(oc => oc.column('key').doUpdateSet({ value })).execute();
+    },
+    async deleteConfigValue(key) {
+        await this.db.deleteFrom('SystemSetting').where('key', '=', `config:${key}`).execute();
+    },
+    async getAllConfigValues() {
+        const rows = await this.db.selectFrom('SystemSetting').select(['key', 'value']).where('key', 'like', 'config:%').execute();
+        const out = {};
+        for (const r of rows)
+            out[r.key.replace('config:', '')] = r.value;
+        return out;
+    },
+    // ── Maintenance mode (SystemSetting key `maintenance`) ──
+    async getMaintenanceMode() {
+        const r = await this.db.selectFrom('SystemSetting').select('value').where('key', '=', 'maintenance').executeTakeFirst();
+        return r ? JSON.parse(r.value) : { enabled: false, message: '', enabledAt: null, enabledBy: null };
+    },
+    async setMaintenanceMode(state) {
+        const value = JSON.stringify(state);
+        await this.db.insertInto('SystemSetting').values({ key: 'maintenance', value })
+            .onConflict(oc => oc.column('key').doUpdateSet({ value })).execute();
+        return state;
+    },
+    // ── Node keypair (single-row NodeKey) ──
+    async setNodeKey(publicKey, privateKey) {
+        const existing = await this.db.selectFrom('NodeKey').select('id').executeTakeFirst();
+        if (existing)
+            await this.db.updateTable('NodeKey').set({ publicKey, privateKey }).where('id', '=', existing.id).execute();
+        else
+            await this.db.insertInto('NodeKey').values({ publicKey, privateKey }).execute();
+    },
+    async getNodeKey() {
+        const r = await this.db.selectFrom('NodeKey').selectAll().executeTakeFirst();
+        return r ? { publicKey: r.publicKey, privateKey: r.privateKey } : null;
+    },
+    // ── Stats counters + daily history ──
+    async flushStats(counters) {
+        for (const [id, value] of Object.entries(counters)) {
+            await this.db.insertInto('StatsCounter').values({ id, value })
+                .onConflict(oc => oc.column('id').doUpdateSet({ value })).execute();
+        }
+    },
+    async loadStats() {
+        const rows = await this.db.selectFrom('StatsCounter').selectAll().execute();
+        const out = {};
+        for (const r of rows)
+            out[r.id] = r.value;
+        return out;
+    },
+    async flushDailyHistory(history) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 90);
+        const cutoffStr = cutoff.toISOString().split('T')[0];
+        for (const [date, counters] of Object.entries(history)) {
+            for (const [key, value] of Object.entries(counters)) {
+                await this.db.insertInto('StatsDailyHistory').values({ date, key, value })
+                    .onConflict(oc => oc.columns(['date', 'key']).doUpdateSet({ value })).execute();
+            }
+        }
+        await this.db.deleteFrom('StatsDailyHistory').where('date', '<', cutoffStr).execute();
+    },
+    async loadDailyHistory() {
+        const rows = await this.db.selectFrom('StatsDailyHistory').selectAll().orderBy('date', 'asc').execute();
+        const out = {};
+        for (const r of rows) {
+            (out[r.date] ??= {})[r.key] = r.value;
+        }
+        return out;
+    },
+    // ── Storage-size telemetry (operator DB tab) ──
+    async getTableRowCounts() {
+        // Exact count(*) per table in ONE round-trip (a UNION ALL). pg_stat's n_live_tup is instant but an
+        // estimate that reads 0 until autovacuum analyses (e.g. right after a bulk load) — wrong for an
+        // operator's accounting tool. Once an hour, a scan per table is an acceptable price for correct numbers.
+        const tbls = await sql `
+      SELECT table_name FROM information_schema.tables
+      WHERE table_schema = 'public' AND table_type = 'BASE TABLE' AND table_name <> '_kysely_migrations'
+    `.execute(this.db);
+        if (tbls.rows.length === 0)
+            return {};
+        const union = tbls.rows
+            .map(r => `SELECT '${r.table_name.replace(/'/g, "''")}' AS t, count(*)::bigint AS n FROM "${r.table_name.replace(/"/g, '""')}"`)
+            .join(' UNION ALL ');
+        const res = await sql `${sql.raw(union)}`.execute(this.db);
+        const counts = {};
+        for (const r of res.rows)
+            counts[r.t] = Number(r.n);
+        return counts;
+    },
+    async getMemoryRowBreakdown() {
+        // One aggregate over the Memory table — no values loaded. `.version.N` history + archived rows
+        // both inflate the table invisibly; the admin DB tab shows the composition.
+        const res = await sql `
+      SELECT count(*) FILTER (WHERE "key" LIKE '%.version.%')::bigint AS v,
+             count(*) FILTER (WHERE "archived")::bigint AS a
+      FROM "Memory"`.execute(this.db);
+        const r = res.rows[0];
+        return { versionRows: Number(r?.v ?? 0), archivedRows: Number(r?.a ?? 0) };
+    },
+    async saveStorageStatsSnapshot(s) {
+        await this.db.insertInto('StorageStatsSnapshot').values({
+            id: s.id, capturedAt: new Date(s.capturedAt), counts: jsonb(s.counts), totalRows: s.totalRows,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }).onConflict(oc => oc.column('id').doUpdateSet({ capturedAt: new Date(s.capturedAt), counts: jsonb(s.counts), totalRows: s.totalRows })).execute();
+    },
+    async listStorageStatsSnapshots(opts) {
+        let q = this.db.selectFrom('StorageStatsSnapshot').selectAll();
+        if (opts?.sinceIso)
+            q = q.where('capturedAt', '>=', new Date(opts.sinceIso));
+        q = q.orderBy('capturedAt', 'desc');
+        if (opts?.limit)
+            q = q.limit(opts.limit);
+        const rows = await q.execute();
+        return rows.map(r => ({
+            id: r.id, capturedAt: (r.capturedAt instanceof Date ? r.capturedAt : new Date(r.capturedAt)).toISOString(),
+            counts: (r.counts ?? {}), totalRows: r.totalRows,
+        }));
+    },
+    async pruneStorageStatsSnapshots(beforeIso) {
+        const r = await this.db.deleteFrom('StorageStatsSnapshot').where('capturedAt', '<', new Date(beforeIso)).executeTakeFirst();
+        return Number(r.numDeletedRows ?? 0);
+    },
+};
+//# sourceMappingURL=system.js.map

package/dist/src/storage/providers/postgres-kysely/methods/system.js.map

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

package/dist/src/storage/providers/postgres-kysely/methods/template-listings.d.ts

@@ -0,0 +1,34 @@
+import type { TemplateListingRecord, TemplateReview, TemplateDiscussion, TemplateFilter } from '../../../interface.js';
+import type { PostgresKyselyStorage } from '../index.js';
+export declare const templateListingMethods: {
+    createTemplateListing(this: PostgresKyselyStorage, record: TemplateListingRecord): Promise<TemplateListingRecord>;
+    getTemplateListing(this: PostgresKyselyStorage, id: string): Promise<TemplateListingRecord | null>;
+    getListingByPackage(this: PostgresKyselyStorage, packageGroupId: string): Promise<TemplateListingRecord | null>;
+    listTemplateListings(this: PostgresKyselyStorage, filter: TemplateFilter): Promise<{
+        listings: TemplateListingRecord[];
+        total: number;
+    }>;
+    updateTemplateListing(this: PostgresKyselyStorage, id: string, updates: Partial<TemplateListingRecord>): Promise<TemplateListingRecord | null>;
+    deleteTemplateListing(this: PostgresKyselyStorage, id: string): Promise<boolean>;
+    incrementInstallCount(this: PostgresKyselyStorage, listingId: string): Promise<void>;
+    listPendingTemplates(this: PostgresKyselyStorage, limit?: number, offset?: number): Promise<TemplateListingRecord[]>;
+    addReview(this: PostgresKyselyStorage, review: TemplateReview): Promise<TemplateReview>;
+    getReviewsByListing(this: PostgresKyselyStorage, listingId: string, limit?: number, offset?: number): Promise<{
+        reviews: TemplateReview[];
+        total: number;
+    }>;
+    getReviewByAuthor(this: PostgresKyselyStorage, listingId: string, authorGhii: string): Promise<TemplateReview | null>;
+    updateReview(this: PostgresKyselyStorage, id: string, updates: Partial<TemplateReview>): Promise<TemplateReview | null>;
+    deleteReview(this: PostgresKyselyStorage, id: string): Promise<boolean>;
+    recalculateRating(this: PostgresKyselyStorage, listingId: string): Promise<{
+        rating: number;
+        reviewCount: number;
+    }>;
+    addDiscussion(this: PostgresKyselyStorage, discussion: TemplateDiscussion): Promise<TemplateDiscussion>;
+    getDiscussionsByListing(this: PostgresKyselyStorage, listingId: string, limit?: number, offset?: number): Promise<{
+        discussions: TemplateDiscussion[];
+        total: number;
+    }>;
+    deleteDiscussion(this: PostgresKyselyStorage, id: string): Promise<boolean>;
+};
+//# sourceMappingURL=template-listings.d.ts.map

package/dist/src/storage/providers/postgres-kysely/methods/template-listings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-listings.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/providers/postgres-kysely/methods/template-listings.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAyDzD,eAAO,MAAM,sBAAsB;gCAGC,qBAAqB,UAAU,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;6BA8BxF,qBAAqB,MAAM,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;8BAKxE,qBAAqB,kBAAkB,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;+BAKpF,qBAAqB,UAAU,cAAc,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;gCAc5G,qBAAqB,MAAM,MAAM,WAAW,OAAO,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;gCAsBlH,qBAAqB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;gCASpD,qBAAqB,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;+BAKzD,qBAAqB,oCAA2B,OAAO,CAAC,qBAAqB,EAAE,CAAC;oBAQ3F,qBAAqB,UAAU,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;8BAmB7D,qBAAqB,aAAa,MAAM,UAAU,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;4BAOnI,qBAAqB,aAAa,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;uBAMlG,qBAAqB,MAAM,MAAM,WAAW,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;uBAapG,qBAAqB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;4BAU/C,qBAAqB,aAAa,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;wBAa/F,qBAAqB,cAAc,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;kCAazE,qBAAqB,aAAa,MAAM,UAAU,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;2BAOhJ,qBAAqB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAMlF,CAAC"}

package/dist/src/storage/providers/postgres-kysely/methods/template-listings.js

@@ -0,0 +1,278 @@
+/**
+ * @file src/storage/providers/postgres-kysely/methods/template-listings.ts
+ * @description Template-listing domain for the Postgres+Kysely backend (TemplateListing / TemplateReview /
+ *   TemplateDiscussion): the social/discovery layer over package groups. Listing CRUD with
+ *   category/featured/status/tag filtering + sort + pagination, install-count bump, moderation queue,
+ *   reviews (upsert keyed by the unique (listingId, authorGhii) + denormalized rating recompute), and
+ *   threaded discussions. Translated 1:1 from the Prisma (Mongo/PG) implementation — all columns are
+ *   scalar or text[] (no JSONB), so mapping is direct; rating recompute aggregates avg + count in-DB.
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 5: template-listing layer on Postgres+Kysely.
+ */
+import { sql } from 'kysely';
+const iso = (t) => (t instanceof Date ? t : new Date(t)).toISOString();
+function toTemplateListing(r) {
+    return {
+        id: r.id,
+        packageGroupId: r.packageGroupId,
+        packageName: r.packageName,
+        packageAuthor: r.packageAuthor,
+        publishedBy: r.publishedBy,
+        publishedByGhii: r.publishedByGhii,
+        title: r.title,
+        description: r.description ?? '',
+        screenshots: r.screenshots ?? [],
+        category: r.category ?? 'other',
+        tags: r.tags ?? [],
+        featured: r.featured ?? false,
+        installCount: r.installCount ?? 0,
+        rating: r.rating ?? 0,
+        reviewCount: r.reviewCount ?? 0,
+        status: (r.status ?? 'listed'),
+        createdAt: iso(r.createdAt),
+        updatedAt: iso(r.updatedAt),
+        ...(r.rejectionReason ? { rejectionReason: r.rejectionReason } : {}),
+        ...(r.reviewedBy ? { reviewedBy: r.reviewedBy } : {}),
+        ...(r.reviewedAt ? { reviewedAt: iso(r.reviewedAt) } : {}),
+        ...(r.reviewComment ? { reviewComment: r.reviewComment } : {}),
+        ...(r.proposedAt ? { proposedAt: iso(r.proposedAt) } : {}),
+        ...(r.proposedBy ? { proposedBy: r.proposedBy } : {}),
+    };
+}
+function toTemplateReview(r) {
+    return {
+        id: r.id,
+        listingId: r.listingId,
+        authorGhii: r.authorGhii,
+        authorName: r.authorName,
+        rating: r.rating,
+        comment: r.comment ?? '',
+        createdAt: iso(r.createdAt),
+    };
+}
+function toTemplateDiscussion(r) {
+    return {
+        id: r.id,
+        listingId: r.listingId,
+        authorGhii: r.authorGhii,
+        authorName: r.authorName,
+        message: r.message,
+        parentId: r.parentId ?? undefined,
+        createdAt: iso(r.createdAt),
+    };
+}
+export const templateListingMethods = {
+    // ── Listings ──
+    async createTemplateListing(record) {
+        const row = await this.db.insertInto('TemplateListing').values({
+            packageGroupId: record.packageGroupId,
+            packageName: record.packageName,
+            packageAuthor: record.packageAuthor,
+            publishedBy: record.publishedBy,
+            publishedByGhii: record.publishedByGhii,
+            title: record.title,
+            description: record.description,
+            screenshots: record.screenshots ?? [],
+            category: record.category,
+            tags: record.tags ?? [],
+            featured: record.featured,
+            installCount: record.installCount,
+            rating: record.rating,
+            reviewCount: record.reviewCount,
+            status: record.status,
+            createdAt: new Date(record.createdAt),
+            updatedAt: new Date(record.updatedAt),
+            rejectionReason: record.rejectionReason ?? null,
+            reviewedBy: record.reviewedBy ?? null,
+            reviewedAt: record.reviewedAt ? new Date(record.reviewedAt) : null,
+            reviewComment: record.reviewComment ?? null,
+            proposedAt: record.proposedAt ? new Date(record.proposedAt) : null,
+            proposedBy: record.proposedBy ?? null,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }).returningAll().executeTakeFirstOrThrow();
+        return toTemplateListing(row);
+    },
+    async getTemplateListing(id) {
+        const r = await this.db.selectFrom('TemplateListing').selectAll().where('id', '=', id).executeTakeFirst();
+        return r ? toTemplateListing(r) : null;
+    },
+    async getListingByPackage(packageGroupId) {
+        const r = await this.db.selectFrom('TemplateListing').selectAll().where('packageGroupId', '=', packageGroupId).executeTakeFirst();
+        return r ? toTemplateListing(r) : null;
+    },
+    async listTemplateListings(filter) {
+        let base = this.db.selectFrom('TemplateListing');
+        if (filter.category)
+            base = base.where('category', '=', filter.category);
+        if (filter.status)
+            base = base.where('status', '=', filter.status);
+        if (filter.featured !== undefined)
+            base = base.where('featured', '=', filter.featured);
+        if (filter.tags && filter.tags.length > 0)
+            base = base.where(sql `"tags" && ${sql.val(filter.tags)}`); // array-overlap (hasSome)
+        if (filter.search)
+            base = base.where(eb => eb.or([eb('title', 'ilike', `%${filter.search}%`), eb('description', 'ilike', `%${filter.search}%`)]));
+        const sortCol = filter.sort === 'rating' ? 'rating' : filter.sort === 'installs' ? 'installCount' : 'createdAt';
+        const rows = await base.selectAll().orderBy(sortCol, 'desc').limit(filter.limit ?? 50).offset(filter.offset ?? 0).execute();
+        const totalRow = await base.select(this.db.fn.countAll().as('n')).executeTakeFirst();
+        return { listings: rows.map(toTemplateListing), total: Number(totalRow?.n ?? 0) };
+    },
+    async updateTemplateListing(id, updates) {
+        const data = {};
+        if (updates.title !== undefined)
+            data.title = updates.title;
+        if (updates.description !== undefined)
+            data.description = updates.description;
+        if (updates.screenshots !== undefined)
+            data.screenshots = updates.screenshots;
+        if (updates.category !== undefined)
+            data.category = updates.category;
+        if (updates.tags !== undefined)
+            data.tags = updates.tags;
+        if (updates.featured !== undefined)
+            data.featured = updates.featured;
+        if (updates.status !== undefined)
+            data.status = updates.status;
+        if (updates.rejectionReason !== undefined)
+            data.rejectionReason = updates.rejectionReason;
+        if (updates.reviewedBy !== undefined)
+            data.reviewedBy = updates.reviewedBy;
+        if (updates.reviewedAt !== undefined)
+            data.reviewedAt = new Date(updates.reviewedAt);
+        if (updates.reviewComment !== undefined)
+            data.reviewComment = updates.reviewComment;
+        if (updates.proposedAt !== undefined)
+            data.proposedAt = new Date(updates.proposedAt);
+        if (updates.proposedBy !== undefined)
+            data.proposedBy = updates.proposedBy;
+        data.updatedAt = new Date();
+        try {
+            const rows = await this.db.updateTable('TemplateListing').set(data).where('id', '=', id).returningAll().execute();
+            return rows[0] ? toTemplateListing(rows[0]) : null;
+        }
+        catch {
+            return null;
+        }
+    },
+    async deleteTemplateListing(id) {
+        try {
+            await this.db.deleteFrom('TemplateReview').where('listingId', '=', id).execute();
+            await this.db.deleteFrom('TemplateDiscussion').where('listingId', '=', id).execute();
+            const r = await this.db.deleteFrom('TemplateListing').where('id', '=', id).executeTakeFirst();
+            return Number(r.numDeletedRows ?? 0) > 0;
+        }
+        catch {
+            return false;
+        }
+    },
+    async incrementInstallCount(listingId) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await this.db.updateTable('TemplateListing').set({ installCount: sql `"TemplateListing"."installCount" + 1` }).where('id', '=', listingId).execute();
+    },
+    async listPendingTemplates(limit = 20, offset = 0) {
+        const rows = await this.db.selectFrom('TemplateListing').selectAll()
+            .where('status', '=', 'pending_review').orderBy('createdAt', 'asc').limit(limit).offset(offset).execute();
+        return rows.map(toTemplateListing);
+    },
+    // ── Reviews ──
+    async addReview(review) {
+        const row = await this.db.insertInto('TemplateReview').values({
+            listingId: review.listingId,
+            authorGhii: review.authorGhii,
+            authorName: review.authorName,
+            rating: review.rating,
+            comment: review.comment,
+            createdAt: new Date(review.createdAt),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }).onConflict(oc => oc.columns(['listingId', 'authorGhii']).doUpdateSet({
+            authorName: review.authorName,
+            rating: review.rating,
+            comment: review.comment,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        })).returningAll().executeTakeFirstOrThrow();
+        await templateListingMethods.recalculateRating.call(this, review.listingId);
+        return toTemplateReview(row);
+    },
+    async getReviewsByListing(listingId, limit, offset) {
+        const base = this.db.selectFrom('TemplateReview').where('listingId', '=', listingId);
+        const rows = await base.selectAll().orderBy('createdAt', 'desc').limit(limit ?? 50).offset(offset ?? 0).execute();
+        const totalRow = await base.select(this.db.fn.countAll().as('n')).executeTakeFirst();
+        return { reviews: rows.map(toTemplateReview), total: Number(totalRow?.n ?? 0) };
+    },
+    async getReviewByAuthor(listingId, authorGhii) {
+        const r = await this.db.selectFrom('TemplateReview').selectAll()
+            .where('listingId', '=', listingId).where('authorGhii', '=', authorGhii).executeTakeFirst();
+        return r ? toTemplateReview(r) : null;
+    },
+    async updateReview(id, updates) {
+        const data = {};
+        if (updates.rating !== undefined)
+            data.rating = updates.rating;
+        if (updates.comment !== undefined)
+            data.comment = updates.comment;
+        if (updates.authorName !== undefined)
+            data.authorName = updates.authorName;
+        try {
+            const rows = await this.db.updateTable('TemplateReview').set(data).where('id', '=', id).returningAll().execute();
+            if (!rows[0])
+                return null;
+            await templateListingMethods.recalculateRating.call(this, rows[0].listingId);
+            return toTemplateReview(rows[0]);
+        }
+        catch {
+            return null;
+        }
+    },
+    async deleteReview(id) {
+        try {
+            const row = await this.db.selectFrom('TemplateReview').select('listingId').where('id', '=', id).executeTakeFirst();
+            if (!row)
+                return false;
+            await this.db.deleteFrom('TemplateReview').where('id', '=', id).execute();
+            await templateListingMethods.recalculateRating.call(this, row.listingId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    async recalculateRating(listingId) {
+        const agg = await this.db.selectFrom('TemplateReview').where('listingId', '=', listingId)
+            .select([this.db.fn.avg('rating').as('avg'), this.db.fn.count('rating').as('cnt')])
+            .executeTakeFirst();
+        const rating = Math.round((Number(agg?.avg ?? 0)) * 10) / 10;
+        const reviewCount = Number(agg?.cnt ?? 0);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await this.db.updateTable('TemplateListing').set({ rating, reviewCount }).where('id', '=', listingId).execute();
+        return { rating, reviewCount };
+    },
+    // ── Discussions ──
+    async addDiscussion(discussion) {
+        const row = await this.db.insertInto('TemplateDiscussion').values({
+            listingId: discussion.listingId,
+            authorGhii: discussion.authorGhii,
+            authorName: discussion.authorName,
+            message: discussion.message,
+            parentId: discussion.parentId ?? null,
+            createdAt: new Date(discussion.createdAt),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }).returningAll().executeTakeFirstOrThrow();
+        return toTemplateDiscussion(row);
+    },
+    async getDiscussionsByListing(listingId, limit, offset) {
+        const base = this.db.selectFrom('TemplateDiscussion').where('listingId', '=', listingId);
+        const rows = await base.selectAll().orderBy('createdAt', 'asc').limit(limit ?? 50).offset(offset ?? 0).execute();
+        const totalRow = await base.select(this.db.fn.countAll().as('n')).executeTakeFirst();
+        return { discussions: rows.map(toTemplateDiscussion), total: Number(totalRow?.n ?? 0) };
+    },
+    async deleteDiscussion(id) {
+        try {
+            const r = await this.db.deleteFrom('TemplateDiscussion').where('id', '=', id).executeTakeFirst();
+            return Number(r.numDeletedRows ?? 0) > 0;
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=template-listings.js.map