@igstack/app-catalog-backend-core 0.0.1

package/prisma/schema.prisma

@@ -0,0 +1,149 @@
+// Prisma schema for backend-core library
+// Uses AC_CORE_DATABASE_URL environment variable
+
+datasource db {
+  provider = "postgresql"
+  url      = env("AC_CORE_DATABASE_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+generator json {
+  provider = "prisma-json-types-generator"
+}
+
+// ========== Better Auth Models ==========
+model user {
+  id            String    @id
+  name          String?
+  email         String?   @unique
+  emailVerified Boolean   @default(false)
+  image         String?
+  role          String    @default("user") // 'user' | 'admin'
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  accounts      account[]
+  sessions      session[]
+}
+
+model session {
+  id        String   @id
+  token     String   @unique
+  userId    String
+  user      user     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  expiresAt DateTime
+  ipAddress String?
+  userAgent String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+model account {
+  id                    String    @id
+  userId                String
+  user                  user      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  accountId             String
+  providerId            String
+  refreshToken          String?
+  accessToken           String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  idToken               String?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+
+  @@unique([providerId, accountId])
+}
+
+model verification {
+  id         String   @id
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@unique([identifier, value])
+}
+
+// ========== EnvHopper Models ==========
+
+enum ApprovalMethodType {
+  service
+  personTeam
+  custom
+}
+
+model DbApprovalMethod {
+  slug        String             @id
+  type        ApprovalMethodType
+  displayName String
+  /// [ApprovalMethodConfig] - Type-specific configuration
+  config      Json?
+  createdAt   DateTime           @default(now())
+  updatedAt   DateTime           @updatedAt
+
+  @@unique([type, displayName])
+}
+
+model DbAppForCatalog {
+  id            String   @id @default(cuid())
+  slug          String   @unique // URL-friendly identifier for navigation
+  displayName   String
+  description   String
+  /// [AccessMethod]
+  access        Json?
+  teams         String[] @default([])
+  /// [AppAccessRequest] - Per-app approval configuration linking to ApprovalMethod
+  accessRequest Json?
+  notes         String?
+  tags          String[] @default([])
+  appUrl        String?
+  /// [AppLink[]]
+  links         Json? // Array of {displayName?: string, url: string}
+  iconName      String? // Optional icon identifier matching DbAsset.name
+  screenshotIds String[] @default([]) // Ordered array of DbAsset IDs
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  @@index([displayName])
+  @@index([slug])
+  @@index([tags])
+}
+
+model DbAppTagDefinition {
+  id          String   @id @default(cuid())
+  prefix      String   @unique
+  displayName String
+  description String
+  /// [GroupingTagValue[]]
+  values      Json
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+}
+
+enum AssetType {
+  icon
+  screenshot
+}
+
+model DbAsset {
+  id        String    @id @default(cuid())
+  name      String    @unique // Name with extension (e.g., "jira.svg", "github.png")
+  assetType AssetType @default(icon)
+  content   Bytes // Binary storage for all asset types (SVG, PNG, etc)
+  checksum  String // SHA-256 of content for deduplication
+  mimeType  String // e.g., "image/svg+xml", "image/png", "image/jpeg"
+  fileSize  Int // Size in bytes
+  width     Int? // Image width in pixels
+  height    Int? // Image height in pixels
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+
+  @@index([name])
+  @@index([assetType])
+}

package/src/__tests__/dummy.test.ts

@@ -0,0 +1,7 @@
+import { describe, expect, it } from 'vitest'
+
+describe('dummy', () => {
+  it('always passes', () => {
+    expect(true).toBe(true)
+  })
+})

package/src/db/client.ts

@@ -0,0 +1,42 @@
+import { PrismaClient } from '@prisma/client'
+
+let prismaClient: PrismaClient | null = null
+
+/**
+ * Gets the internal Prisma client instance.
+ * Creates one if it doesn't exist.
+ */
+export function getDbClient(): PrismaClient {
+  if (!prismaClient) {
+    prismaClient = new PrismaClient()
+  }
+  return prismaClient
+}
+
+/**
+ * Sets the internal Prisma client instance.
+ * Used by middleware to bridge with existing getDbClient() usage.
+ */
+export function setDbClient(client: PrismaClient): void {
+  prismaClient = client
+}
+
+/**
+ * Connects to the database.
+ * Call this before performing database operations.
+ */
+export async function connectDb(): Promise<void> {
+  const client = getDbClient()
+  await client.$connect()
+}
+
+/**
+ * Disconnects from the database.
+ * Call this when done with database operations (e.g., in scripts).
+ */
+export async function disconnectDb(): Promise<void> {
+  if (prismaClient) {
+    await prismaClient.$disconnect()
+    prismaClient = null
+  }
+}

package/src/db/index.ts

@@ -0,0 +1,21 @@
+// Database connection
+export { connectDb, disconnectDb, getDbClient, setDbClient } from './client'
+
+// Table sync utilities
+export {
+  tableSyncPrisma,
+  type MakeTFromPrismaModel,
+  type ObjectKeys,
+  type ScalarFilter,
+  type ScalarKeys,
+  type TableSyncParamsPrisma,
+} from './tableSyncPrismaAdapter'
+
+export {
+  TABLE_SYNC_MAGAZINE,
+  type TableSyncMagazine,
+  type TableSyncMagazineModelNameKey,
+} from './tableSyncMagazine'
+
+// App catalog sync
+export { syncAppCatalog, type SyncAppCatalogResult } from './syncAppCatalog'

package/src/db/syncAppCatalog.ts

@@ -0,0 +1,312 @@
+import type {
+  AppForCatalog,
+  GroupingTagDefinition,
+} from '../types/common/appCatalogTypes'
+import { getDbClient } from './client'
+import { TABLE_SYNC_MAGAZINE } from './tableSyncMagazine'
+import { tableSyncPrisma } from './tableSyncPrismaAdapter'
+import { readFile, readdir, stat } from 'node:fs/promises'
+import { group } from 'radashi'
+import { upsertAsset } from '../modules/assets/upsertAsset'
+import type { ApprovalMethod } from '../types'
+import type { PrismaClient } from '@prisma/client'
+
+export interface SyncAppCatalogResult {
+  created: number
+  updated: number
+  deleted: number
+  total: number
+}
+
+interface AssetSyncResult {
+  screenshotIds: Array<string>
+  iconName: string | null
+}
+
+function isFileNotFoundError(error: unknown): boolean {
+  return (
+    error instanceof Error &&
+    'code' in error &&
+    (error as NodeJS.ErrnoException).code === 'ENOENT'
+  )
+}
+
+async function processAssetDirectory(
+  dirPath: string,
+  appSlug: string,
+  assetType: 'screenshot' | 'icon',
+  prisma: PrismaClient,
+): Promise<Array<string>> {
+  try {
+    const files = await readdir(dirPath)
+    const assetIds: Array<string> = []
+
+    for (let i = 0; i < files.length; i++) {
+      const fileName = files[i]
+      if (!fileName) continue
+
+      const assetName =
+        assetType === 'screenshot'
+          ? `${appSlug}-screenshot-${i + 1}`
+          : `${appSlug}-icon`
+
+      const id = await upsertAsset({
+        prisma,
+        buffer: await readFile(`${dirPath}/${fileName}`),
+        originalFilename: fileName,
+        name: assetName,
+        assetType,
+      })
+      assetIds.push(id)
+
+      // For icons, only process the first file
+      if (assetType === 'icon') {
+        break
+      }
+    }
+
+    return assetIds
+  } catch (error: unknown) {
+    if (isFileNotFoundError(error)) {
+      return []
+    }
+    throw error
+  }
+}
+
+async function syncAppAssets(
+  appSlug: string,
+  appPath: string,
+  prisma: PrismaClient,
+): Promise<AssetSyncResult> {
+  const screenshotIds = await processAssetDirectory(
+    `${appPath}/screenshots`,
+    appSlug,
+    'screenshot',
+    prisma,
+  )
+
+  const iconIds = await processAssetDirectory(
+    `${appPath}/icons`,
+    appSlug,
+    'icon',
+    prisma,
+  )
+
+  return {
+    screenshotIds,
+    iconName: iconIds.length > 0 ? `${appSlug}-icon` : null,
+  }
+}
+
+async function syncAssetsFromFileSystem(
+  apps: Array<AppForCatalog>,
+  allAppsAssetsPath: string,
+) {
+  const appDirectories = await readdir(allAppsAssetsPath)
+  const prisma = getDbClient()
+  const bySlug = group(apps, (a) => a.slug)
+
+  for (const appDirName of appDirectories) {
+    try {
+      const stats = await stat(`${allAppsAssetsPath}/${appDirName}`)
+      if (!stats.isDirectory()) {
+        continue
+      }
+    } catch (error: unknown) {
+      if (isFileNotFoundError(error)) {
+        continue
+      }
+      throw error
+    }
+
+    const appSlug = appDirName
+    if (!bySlug[appSlug]) {
+      throw new Error(
+        `App '${appSlug}' does not exist in the app catalog. Existing apps: ${Object.keys(bySlug).join(', ')}`,
+      )
+    }
+
+    try {
+      const { screenshotIds, iconName } = await syncAppAssets(
+        appSlug,
+        `${allAppsAssetsPath}/${appDirName}`,
+        prisma,
+      )
+
+      const updateData: {
+        screenshotIds?: Array<string>
+        iconName?: string | null
+      } = {}
+
+      if (screenshotIds.length > 0) {
+        updateData.screenshotIds = screenshotIds
+      }
+      if (iconName !== null) {
+        updateData.iconName = iconName
+      }
+
+      if (Object.keys(updateData).length > 0) {
+        await prisma.dbAppForCatalog.update({
+          where: { slug: appSlug },
+          data: updateData,
+        })
+      }
+    } catch (error: unknown) {
+      const errorMessage =
+        error instanceof Error ? error.message : String(error)
+      throw new Error(
+        `Error while upserting assets for app '${appSlug}': ${errorMessage}`,
+      )
+    }
+  }
+  // private async syncScreenshots(apps: AppForCatalog[], screenshotsPath: string): Promise<void> {
+  //     const db = getDbClient();
+  //
+  //     for (const app of apps) {
+  //     const dirPath = join(screenshotsPath, `${app.slug}-screenshots`);
+  //
+  //     try {
+  //       const files = await readdir(dirPath);
+  //       const imageFiles = files.filter(f => /\.(png|jpg|jpeg|gif|webp)$/i.test(f)).sort();
+  //
+  //       if (imageFiles.length === 0) continue;
+  //
+  //       const screenshotIds: string[] = [];
+  //
+  //       for (const filename of imageFiles) {
+  //         const filePath = join(dirPath, filename);
+  //         const content = await readFile(filePath);
+  //         const buffer = Buffer.from(content);
+  //         const checksum = generateChecksum(buffer);
+  //         const { width, height } = await getImageDimensions(buffer);
+  //
+  //         const ext = filename.split('.').pop()?.toLowerCase();
+  //         const mimeType = {
+  //           png: 'image/png',
+  //           jpg: 'image/jpeg',
+  //           jpeg: 'image/jpeg',
+  //           gif: 'image/gif',
+  //           webp: 'image/webp',
+  //         }[ext || ''] || 'application/octet-stream';
+  //
+  //         const asset = await db.dbAsset.upsert({
+  //           where: { checksum },
+  //           create: {
+  //             name: `${app.slug}/${filename}`,
+  //             assetType: 'screenshot',
+  //             content: new Uint8Array(buffer),
+  //             checksum,
+  //             mimeType,
+  //             fileSize: buffer.length,
+  //             width,
+  //             height,
+  //           },
+  //           update: {
+  //             name: `${app.slug}/${filename}`,
+  //             content: new Uint8Array(buffer),
+  //             mimeType,
+  //             fileSize: buffer.length,
+  //             width,
+  //             height,
+  //           },
+  //         });
+  //
+  //         screenshotIds.push(asset.id);
+  //       }
+  //
+  //       await db.dbAppForCatalog.update({
+  //         where: { slug: app.slug },
+  //         data: { screenshotIds },
+  //       });
+  //
+  //       logger.info(`Synced ${screenshotIds.length} screenshots for ${app.slug}`);
+  //     } catch (error: any) {
+  //       if (error.code === 'ENOENT') continue; // Skip if directory doesn't exist
+  //       throw error;
+  //     }
+  //   }
+  // }
+}
+
+/**
+ * Syncs app catalog data to the database using table sync.
+ * This will create new apps, update existing ones, and delete any that are no longer in the input.
+ *
+ * Note: Call connectDb() before and disconnectDb() after if running in a script.
+ */
+export async function syncAppCatalog(
+  apps: Array<AppForCatalog>,
+  tagsDefinitions: Array<GroupingTagDefinition>,
+  approvalMethods: Array<ApprovalMethod>,
+  sreenshotsPath?: string,
+): Promise<SyncAppCatalogResult> {
+  try {
+    const prisma = getDbClient()
+
+    await tableSyncPrisma({
+      prisma,
+      ...TABLE_SYNC_MAGAZINE.DbApprovalMethod,
+    }).sync(approvalMethods)
+
+    const sync = tableSyncPrisma({
+      prisma,
+      ...TABLE_SYNC_MAGAZINE.DbAppForCatalog,
+    })
+
+    await tableSyncPrisma({
+      prisma,
+      ...TABLE_SYNC_MAGAZINE.DbAppTagDefinition,
+    }).sync(tagsDefinitions)
+
+    // Transform AppForCatalog to DbAppForCatalog format
+    const dbApps = apps.map((app) => {
+      const slug =
+        app.slug ||
+        app.displayName
+          .toLowerCase()
+          .replace(/[^a-z0-9]+/g, '-')
+          .replace(/^-+|-+$/g, '')
+
+      return {
+        slug,
+        displayName: app.displayName,
+        description: app.description,
+        teams: app.teams ?? [],
+        accessRequest: app.accessRequest ?? null,
+        notes: app.notes ?? null,
+        tags: app.tags ?? [],
+        appUrl: app.appUrl ?? null,
+        links: app.links ?? null,
+        iconName: app.iconName ?? null,
+        screenshotIds: app.screenshotIds ?? [],
+      }
+    })
+
+    const result = await sync.sync(dbApps)
+
+    // Get actual synced data to calculate stats
+    const actual = result.getActual()
+
+    if (sreenshotsPath) {
+      await syncAssetsFromFileSystem(apps, sreenshotsPath)
+    } else {
+      console.warn('DO not sync screenhots')
+    }
+
+    return {
+      created: actual.length - apps.length + (apps.length - actual.length),
+      updated: 0, // TableSync doesn't expose this directly
+      deleted: 0, // TableSync doesn't expose this directly
+      total: actual.length,
+    }
+  } catch (error) {
+    // Wrap error with context
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    const errorStack = error instanceof Error ? error.stack : undefined
+
+    throw new Error(
+      `Error syncing app catalog: ${errorMessage}\n\nDetails:\n${errorStack || 'No stack trace available'}`,
+    )
+  }
+}

package/src/db/tableSyncMagazine.ts

@@ -0,0 +1,32 @@
+import type { Prisma } from '@prisma/client'
+import type { ObjectKeys, ScalarKeys } from './tableSyncPrismaAdapter'
+
+interface CommonSyncTableInfo<TPrismaModelName extends Prisma.ModelName> {
+  prismaModelName: TPrismaModelName
+  id?: ScalarKeys<TPrismaModelName>
+  uniqColumns: Array<ScalarKeys<TPrismaModelName>>
+  relationColumns?: Array<ObjectKeys<TPrismaModelName>>
+}
+
+type TableSyncMagazineType = Partial<{
+  [key in Prisma.ModelName]: CommonSyncTableInfo<key>
+}>
+
+export const TABLE_SYNC_MAGAZINE = {
+  DbAppForCatalog: {
+    prismaModelName: 'DbAppForCatalog',
+    uniqColumns: ['slug'],
+  },
+  DbAppTagDefinition: {
+    prismaModelName: 'DbAppTagDefinition',
+    uniqColumns: ['prefix'],
+  },
+  DbApprovalMethod: {
+    id: 'slug',
+    prismaModelName: 'DbApprovalMethod',
+    uniqColumns: ['slug'],
+  },
+} as const satisfies TableSyncMagazineType
+
+export type TableSyncMagazine = typeof TABLE_SYNC_MAGAZINE
+export type TableSyncMagazineModelNameKey = keyof TableSyncMagazine