takos-control 1.0.0

package/src/application/services/source/explore-repos.ts

@@ -0,0 +1,189 @@
+import type { Env } from '../../../shared/types';
+import { repositories } from '../../../infra/db';
+import { desc, asc } from 'drizzle-orm';
+import type { ExploreReposResult } from './explore-types';
+import {
+  ALLOWED_ORDER_BY_COLUMNS,
+  resolveOrderByColumn,
+  resolveOrderDirection,
+  buildBaseConditions,
+  queryReposWithAccount,
+  countRepos,
+  buildExploreResult,
+} from './source-exploration';
+
+export async function listExploreRepos(
+  dbBinding: Env['DB'],
+  options: {
+    sort: string;
+    order: string;
+    limit: number;
+    offset: number;
+    searchQuery: string;
+    category?: string;
+    language?: string;
+    license?: string;
+    since?: string;
+    userId?: string;
+  }
+): Promise<ExploreReposResult> {
+  const sortKey = resolveOrderByColumn(options.sort);
+  const orderDirection = resolveOrderDirection(options.order);
+
+  const conditions = buildBaseConditions({
+    category: options.category,
+    language: options.language,
+    license: options.license,
+    since: options.since,
+    sinceField: 'updatedAt',
+    searchQuery: options.searchQuery || undefined,
+  });
+
+  const orderByMap = {
+    'updatedAt': repositories.updatedAt,
+    'createdAt': repositories.createdAt,
+    'forks': repositories.forks,
+    'stars': repositories.stars,
+  } as const;
+  const col = orderByMap[ALLOWED_ORDER_BY_COLUMNS[sortKey as keyof typeof ALLOWED_ORDER_BY_COLUMNS] as keyof typeof orderByMap] ?? repositories.stars;
+  const orderByClause = orderDirection === 'asc' ? asc(col) : desc(col);
+
+  const [repos, total] = await Promise.all([
+    queryReposWithAccount(dbBinding, {
+      conditions,
+      orderBy: [orderByClause],
+      limit: options.limit,
+      offset: options.offset,
+    }),
+    countRepos(dbBinding, conditions),
+  ]);
+
+  return buildExploreResult(
+    dbBinding,
+    repos,
+    total,
+    options.offset,
+    options.userId
+  );
+}
+
+export async function listTrendingRepos(
+  dbBinding: Env['DB'],
+  options: {
+    limit: number;
+    offset: number;
+    category?: string;
+    language?: string;
+    license?: string;
+    since?: string;
+    userId?: string;
+  }
+): Promise<ExploreReposResult> {
+  const sevenDaysAgo = new Date();
+  sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
+  const sevenDaysAgoStr = sevenDaysAgo.toISOString();
+  const updatedSince = options.since && options.since > sevenDaysAgoStr ? options.since : sevenDaysAgoStr;
+
+  const conditions = buildBaseConditions({
+    category: options.category,
+    language: options.language,
+    license: options.license,
+    since: updatedSince,
+    sinceField: 'updatedAt',
+  });
+
+  const repos = await queryReposWithAccount(dbBinding, {
+    conditions,
+    orderBy: [desc(repositories.stars), desc(repositories.updatedAt)],
+    limit: options.limit,
+    offset: options.offset,
+  });
+
+  const total = await countRepos(dbBinding, conditions);
+
+  return buildExploreResult(
+    dbBinding,
+    repos,
+    total,
+    options.offset,
+    options.userId
+  );
+}
+
+export async function listNewRepos(
+  dbBinding: Env['DB'],
+  options: {
+    limit: number;
+    offset: number;
+    category?: string;
+    language?: string;
+    license?: string;
+    since?: string;
+    userId?: string;
+  }
+): Promise<ExploreReposResult> {
+  const conditions = buildBaseConditions({
+    category: options.category,
+    language: options.language,
+    license: options.license,
+    since: options.since,
+    sinceField: 'createdAt',
+  });
+
+  const [repos, total] = await Promise.all([
+    queryReposWithAccount(dbBinding, {
+      conditions,
+      orderBy: [desc(repositories.createdAt)],
+      limit: options.limit,
+      offset: options.offset,
+    }),
+    countRepos(dbBinding, conditions),
+  ]);
+
+  return buildExploreResult(
+    dbBinding,
+    repos,
+    total,
+    options.offset,
+    options.userId
+  );
+}
+
+export async function listRecentRepos(
+  dbBinding: Env['DB'],
+  options: {
+    limit: number;
+    offset: number;
+    category?: string;
+    language?: string;
+    license?: string;
+    since?: string;
+    userId?: string;
+  }
+): Promise<ExploreReposResult> {
+  const conditions = buildBaseConditions({
+    category: options.category,
+    language: options.language,
+    license: options.license,
+    since: options.since,
+    sinceField: 'updatedAt',
+  });
+
+  const [repos, total] = await Promise.all([
+    queryReposWithAccount(dbBinding, {
+      conditions,
+      orderBy: [desc(repositories.updatedAt)],
+      limit: options.limit,
+      offset: options.offset,
+    }),
+    countRepos(dbBinding, conditions),
+  ]);
+
+  return buildExploreResult(
+    dbBinding,
+    repos,
+    total,
+    options.offset,
+    options.userId
+  );
+}

package/src/application/services/source/explore-types.ts

@@ -0,0 +1,155 @@
+export interface ExploreRepoResponse {
+  id: string;
+  name: string;
+  description: string | null;
+  visibility: 'public';
+  default_branch: string;
+  stars: number;
+  forks: number;
+  workspace: {
+    id: string;
+    name: string;
+  };
+  owner: {
+    id: string;
+    name: string;
+    username: string;
+    avatar_url: string | null;
+  };
+  is_starred: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ExploreReposResult {
+  repos: ExploreRepoResponse[];
+  total: number;
+  has_more: boolean;
+}
+
+export interface CatalogRepoResponse {
+  id: string;
+  name: string;
+  description: string | null;
+  visibility: 'public';
+  default_branch: string;
+  stars: number;
+  forks: number;
+  category: string | null;
+  language: string | null;
+  license: string | null;
+  is_starred: boolean;
+  created_at: string;
+  updated_at: string;
+  workspace: {
+    id: string;
+    name: string;
+  };
+  owner: {
+    id: string;
+    name: string;
+    username: string;
+    avatar_url: string | null;
+  };
+}
+
+export interface CatalogTakopackResponse {
+  available: boolean;
+  app_id: string | null;
+  latest_version: string | null;
+  latest_tag: string | null;
+  release_id: string | null;
+  release_tag: string | null;
+  asset_id: string | null;
+  description: string | null;
+  icon: string | null;
+  category: string | null;
+  tags: string[];
+  downloads: number;
+  rating_avg: number | null;
+  rating_count: number;
+  publish_status: 'none' | 'pending' | 'approved' | 'rejected';
+  certified: boolean;
+  published_at: string | null;
+}
+
+export interface CatalogInstallationResponse {
+  installed: boolean;
+  bundle_deployment_id: string | null;
+  installed_version: string | null;
+  deployed_at: string | null;
+}
+
+export interface CatalogItemResponse {
+  repo: CatalogRepoResponse;
+  takopack: CatalogTakopackResponse;
+  installation?: CatalogInstallationResponse;
+  official?: boolean;
+}
+
+export interface CatalogResult {
+  items: CatalogItemResponse[];
+  total: number;
+  has_more: boolean;
+}
+
+export type CatalogSort = 'trending' | 'new' | 'stars' | 'updated' | 'downloads';
+export type CatalogType = 'all' | 'repo' | 'deployable-app' | 'official';
+
+export type RepositoryWithAccount = {
+  id: string;
+  name: string;
+  description: string | null;
+  defaultBranch: string;
+  stars: number;
+  forks: number;
+  officialCategory: string | null;
+  primaryLanguage: string | null;
+  license: string | null;
+  createdAt: string;
+  updatedAt: string;
+  account: {
+    id: string;
+    name: string;
+    slug: string;
+    picture: string | null;
+  };
+};
+
+export interface ReleaseAsset {
+  id: string;
+  name: string;
+  size: number;
+  download_count: number;
+  bundle_format?: string;
+  bundle_meta?: {
+    name?: string;
+    app_id?: string;
+    version?: string;
+    description?: string;
+    icon?: string;
+    category?: string;
+    tags?: string[];
+  };
+}
+
+export interface ParsedTakopackRelease {
+  releaseId: string;
+  repoId: string;
+  appId: string;
+  releaseTag: string;
+  publishedAt: string | null;
+  version: string;
+  description: string | null;
+  icon: string | null;
+  category: string | null;
+  tags: string[];
+  assetId: string;
+  downloadCount: number;
+  totalDownloads: number;
+}
+
+export interface ParsedCatalogTags {
+  tags: string[];
+  invalid: boolean;
+}

package/src/application/services/source/explore.ts

@@ -0,0 +1,20 @@
+// Re-export all public types and functions so existing imports remain valid.
+
+export type {
+  ExploreRepoResponse,
+  ExploreReposResult,
+  CatalogRepoResponse,
+  CatalogTakopackResponse,
+  CatalogInstallationResponse,
+  CatalogItemResponse,
+  CatalogResult,
+} from './explore-types';
+
+export {
+  listExploreRepos,
+  listTrendingRepos,
+  listNewRepos,
+  listRecentRepos,
+} from './explore-repos';
+
+export { listCatalogItems } from './explore-catalog';

package/src/application/services/source/external-import-utils.ts

@@ -0,0 +1,126 @@
+/**
+ * External Import Utilities.
+ *
+ * URL parsing, name inference, and auth header construction
+ * for importing external Git repositories into the store.
+ */
+
+/**
+ * Parse a Git HTTPS URL into its components.
+ *
+ * Supports formats:
+ *   - https://github.com/owner/repo.git
+ *   - https://github.com/owner/repo
+ *   - https://gitlab.example.com/group/subgroup/repo.git
+ */
+export function parseGitUrl(url: string): { host: string; path: string; owner: string; repo: string } {
+  let normalized = url.trim();
+
+  // Remove trailing slashes and .git suffix for parsing
+  normalized = normalized.replace(/\/+$/, '');
+  const withoutGit = normalized.replace(/\.git$/, '');
+
+  let parsed: URL;
+  try {
+    parsed = new URL(withoutGit);
+  } catch {
+    throw new Error(`Invalid Git URL: ${url}`);
+  }
+
+  if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+    throw new Error(`Unsupported protocol: ${parsed.protocol} (only https:// is supported)`);
+  }
+
+  const pathParts = parsed.pathname.split('/').filter(Boolean);
+
+  if (pathParts.length < 2) {
+    throw new Error(`Git URL must include owner and repository: ${url}`);
+  }
+
+  const repo = pathParts[pathParts.length - 1];
+  const owner = pathParts.slice(0, -1).join('/');
+
+  return {
+    host: parsed.host,
+    path: parsed.pathname,
+    owner,
+    repo,
+  };
+}
+
+/**
+ * Infer a local repository name from a Git URL.
+ *
+ * Examples:
+ *   - `https://github.com/owner/my-repo.git` → `my-repo`
+ *   - `https://gitlab.com/group/sub/project` → `project`
+ */
+export function inferRepoName(url: string): string {
+  const { repo } = parseGitUrl(url);
+  return repo;
+}
+
+/**
+ * Normalize a Git URL to ensure it ends with `.git`.
+ *
+ * Many servers accept both `/repo` and `/repo.git` but the smart HTTP
+ * protocol endpoints (`/info/refs`, `/git-upload-pack`) are typically
+ * mounted under the `.git` suffix.
+ */
+export function normalizeGitUrl(url: string): string {
+  let normalized = url.trim().replace(/\/+$/, '');
+  if (!normalized.endsWith('.git')) {
+    normalized += '.git';
+  }
+  return normalized;
+}
+
+/**
+ * Build an HTTP Basic auth header.
+ */
+export function buildBasicAuthHeader(username: string, password: string): string {
+  const encoded = btoa(`${username}:${password}`);
+  return `Basic ${encoded}`;
+}
+
+/**
+ * Build a Bearer auth header (for PAT or OAuth tokens).
+ */
+export function buildBearerAuthHeader(token: string): string {
+  return `Bearer ${token}`;
+}
+
+/**
+ * Build an auth header from flexible input options.
+ * Returns null if no credentials are provided.
+ */
+export function buildAuthHeader(auth?: {
+  token?: string;
+  username?: string;
+  password?: string;
+}): string | null {
+  if (!auth) return null;
+
+  if (auth.token) {
+    return buildBearerAuthHeader(auth.token);
+  }
+
+  if (auth.username && auth.password) {
+    return buildBasicAuthHeader(auth.username, auth.password);
+  }
+
+  return null;
+}
+
+/**
+ * Sanitize a repository name for local use.
+ * Allows alphanumeric, hyphens, underscores, and dots.
+ */
+export function sanitizeImportName(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+    .slice(0, 100);
+}