feat: community plugin list

.github/workflows/syncCommunityResources.yml

@@ -0,0 +1,53 @@
+name: 'Sync Community Resources'
+
+on:
+  schedule:
+    # weekly on Mondays at 00:00 UTC
+    - cron: '0 0 * * 1'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  sync-community-resources:
+    name: Sync Community Resources
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm i
+
+      - name: sync-community-resources
+        run: pnpm build:community-resources
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - run: pnpm prettier src/data -w
+
+   # tauri-docs PR
+      - name: Git config
+        run: |
+          git config --global user.name "tauri-bot"
+          git config --global user.email "tauri-bot@tauri.app"
+
+      - name: Create pull request for updated docs
+        id: cpr
+        # soft fork of https://github.com/peter-evans/create-pull-request for security purposes
+        uses: tauri-apps/create-pull-request@v3.4.1
+        if: github.event_name != 'pull_request' && github.event_name != 'push'
+        with:
+          token: ${{ secrets.ORG_TAURI_BOT_PAT }}
+          commit-message: 'chore(docs): Update Community Resources'
+          branch: ci/v2/update-community-resources
+          title: Update Community Resources
+          labels: 'bot'

package.json

@@ -14,6 +14,7 @@
     "dev": "astro dev",
     "format": "prettier -w --cache --plugin prettier-plugin-astro .",
     "format:check": "prettier -c --cache --plugin prettier-plugin-astro .",
+    "build:community-resources": "pnpm --filter community-resources run build",
     "build:compatibility-table": "pnpm --filter compatibility-table run build",
     "build:references": "pnpm --filter js-api-generator run build",
     "build:releases": "pnpm --filter releases-generator run build",

packages/community-resources/.prettierrc

@@ -0,0 +1,22 @@
+{
+  "printWidth": 100,
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "useTabs": false,
+  "overrides": [
+    {
+      "files": ["*.json", "*.md", "*.toml", "*.yml"],
+      "options": {
+        "useTabs": false
+      }
+    },
+    {
+      "files": ["*.md", "*.mdx"],
+      "options": {
+        "printWidth": 80
+      }
+    }
+  ]
+}

packages/community-resources/build.ts

@@ -0,0 +1,197 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const OUTPUT_FILE = path.resolve(__dirname, '../../src/data/communityResources.json');
+
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN || null;
+const query = 'tauri-plugin-';
+
+const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
+
+function cleanRepoUrl(url: string) {
+  if (!url) {
+    return null;
+  }
+  return url.replace(/^git\+/, '').replace(/\.git$/, '');
+}
+
+async function fetchJson(url: string, headers?: Headers) {
+  if (!headers) {
+    headers = new Headers();
+  }
+  if (!headers.has('User-Agent')) {
+    headers.set(
+      'User-Agent',
+      'tauri-docs-plugins-discover (https://github.com/tauri-apps/tauri-docs)'
+    );
+  }
+
+  const res = await fetch(url, { headers });
+  if (!res.ok) {
+    throw new Error(`Failed ${url}: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+
+// https://crates.io/data-access
+async function fetchCrates() {
+  const results = [];
+  let page = 1;
+  const per_page = 100;
+  while (true) {
+    const url = `https://crates.io/api/v1/crates?page=${page}&per_page=${per_page}&q=${query}`;
+    const j = await fetchJson(url);
+    if (!j.crates || j.crates.length === 0) {
+      break;
+    }
+    for (const c of j.crates) {
+      if (!c.name || !c.name.startsWith(query)) {
+        continue;
+      }
+      results.push({
+        source: 'crates',
+        name: c.name,
+        description: c.description || '',
+        version: c.max_version || c.newest_version || '',
+        created_at: c.created_at || '',
+        repository: cleanRepoUrl(c.repository || c.homepage || ''),
+        license: c.license || '',
+        homepage: c.homepage || '',
+        crates_io: `https://crates.io/crates/${c.name}`,
+      });
+    }
+    if (j.meta && j.meta.total <= page * per_page) break;
+    page++;
+    await sleep(1001);
+  }
+  return results;
+}
+
+interface ResultsItem {
+  source: string;
+  name: string;
+  description: string;
+  version: string;
+  version_npm?: string;
+  created_at?: string;
+  repository: string | null;
+  npm?: string;
+  crates_io?: string;
+}
+
+// https://docs.npmjs.com/policies/open-source-terms
+async function fetchNpm() {
+  const results: ResultsItem[] = [];
+  const size = 250;
+  const url = `https://registry.npmjs.org/-/v1/search?text=tauri-plugin-&size=${size}`;
+  const j = await fetchJson(url);
+  if (!j.objects) return results;
+  for (const obj of j.objects) {
+    const p = obj.package;
+    const name = p.name;
+    if (!name) {
+      continue;
+    }
+    if (!/(^|\/)tauri-plugin-/.test(name)) {
+      continue;
+    }
+    const repo = p.links && p.links.repository ? p.links.repository : p.repository;
+    results.push({
+      source: 'npm',
+      name,
+      description: p.description || '',
+      version: p.version || '',
+      created_at: p.date || '',
+      repository: cleanRepoUrl(repo || p.links?.homepage || ''),
+      npm: `https://www.npmjs.com/package/${encodeURIComponent(name)}`,
+    });
+  }
+  return results;
+}
+
+function extractGithubRepo(url: string) {
+  if (!url) {
+    return null;
+  }
+  try {
+    const u = new URL(url);
+    if (u.hostname !== 'github.com') {
+      return null;
+    }
+    const parts = u.pathname.replace(/^\//, '').split('/');
+    if (parts.length < 2) {
+      return null;
+    }
+    return `${parts[0]}/${parts[1]}`;
+  } catch (e) {
+    return null;
+  }
+}
+
+async function fetchGithubStars(ownerRepo: string) {
+  if (!ownerRepo) {
+    return null;
+  }
+  const url = `https://api.github.com/repos/${ownerRepo}`;
+  const headers = new Headers();
+  headers.append('Accept', 'application/vnd.github+json');
+  if (GITHUB_TOKEN) {
+    headers.append('Authorization', `token ${GITHUB_TOKEN}`);
+  }
+  try {
+    const j = await fetchJson(url, headers);
+    return j.stargazers_count ?? null;
+  } catch (e) {
+    return null;
+  }
+}
+
+async function run() {
+  console.log('Fetching crates.io packages...');
+  const crates = await fetchCrates();
+  console.log(`Found ${crates.length} crates matching prefix.`);
+
+  console.log('Fetching npm packages...');
+  const npm = await fetchNpm();
+  console.log(`Found ${npm.length} npm packages matching prefix.`);
+
+  const map = new Map();
+
+  for (const c of crates) {
+    map.set(c.name, { ...c });
+  }
+  for (const n of npm) {
+    const existing = map.get(n.name);
+    if (existing) {
+      existing.npm = n.npm;
+      existing.version_npm = n.version;
+      existing.description = existing.description || n.description;
+      existing.repository = existing.repository || n.repository;
+    } else {
+      map.set(n.name, { ...n });
+    }
+  }
+
+  const items = Array.from(map.values()).sort((a, b) => {
+    const dateA = a.created_at ? new Date(a.created_at).getTime() : 0;
+    const dateB = b.created_at ? new Date(b.created_at).getTime() : 0;
+    return dateB - dateA;
+  });
+
+  const outputData = {
+    generated: new Date().toISOString(),
+    count: items.length,
+    resources: items,
+  };
+
+  await fs.mkdir(path.dirname(OUTPUT_FILE), { recursive: true });
+  await fs.writeFile(OUTPUT_FILE, JSON.stringify(outputData, null, 2), 'utf8');
+  console.log(`Wrote ${items.length} resources to ${OUTPUT_FILE}`);
+}
+
+run().catch((e) => {
+  console.error('Error generating resources:', e);
+  process.exit(1);
+});

packages/community-resources/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "community-resources",
+  "version": "1.0.0",
+  "private": "true",
+  "description": "",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "build": "tsm ./build.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@types/node": "^22.0.0",
+    "tsm": "^2.3.0",
+    "typescript": "^5.3.3"
+  }
+}

packages/community-resources/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "strict": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  }
+}

pnpm-workspace.yaml

@@ -6,6 +6,7 @@ packages:
   - packages/releases-generator
   - packages/compatibility-table
   - packages/fetch-sponsors
+  - packages/community-resources
 onlyBuiltDependencies:
   - '@parcel/watcher'
   - esbuild