@nyaitter/nap 0.0.0-stage → 0.2.0

package/lib/read.js

@@ -0,0 +1,68 @@
+'use strict';
+
+const crypto = require('crypto');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { git, gitText, refExists, remoteUrl } = require('./git');
+const { INDEX_BRANCH, VERSIONS_BRANCH } = require('./core');
+
+// 指定した ref の索引をリポジトリ内から読む。索引は先頭ファイルと全チャンク。無ければ空。
+function readIndexAt(root, ref) {
+    if (!refExists(root, ref)) {
+        return { head: { chunks: [], total: 0 }, entries: [] };
+    }
+    const head = JSON.parse(git(['show', `${ref}:index.json`], { cwd: root }).toString('utf8'));
+    const entries = [];
+    for (const chunk of head.chunks) {
+        const list = JSON.parse(
+            git(['show', `${ref}:${chunk.file}`], { cwd: root }).toString('utf8'),
+        );
+        for (const entry of list) entries.push({ ...entry, chunkFile: chunk.file });
+    }
+    return { head, entries };
+}
+
+// リモートから索引・タグ・nap/versions ブランチを取り込んだ一時 bare リポジトリを作る。
+// 読み取り専用の作業場所で、対象リポジトリの ref は汚さない。
+function openSnapshot(root, remote) {
+    const url = remoteUrl(root, remote);
+    const key = crypto
+        .createHash('sha256')
+        .update(`${root}\n${url}`)
+        .digest('hex')
+        .slice(0, 16);
+    const dir = path.join(os.tmpdir(), `nap-read-${key}`);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+        git(['init', '--bare', '--quiet', dir], {});
+    }
+    const refspecs = [
+        `+refs/heads/${INDEX_BRANCH}:refs/heads/${INDEX_BRANCH}`,
+        `+refs/heads/${VERSIONS_BRANCH}:refs/heads/${VERSIONS_BRANCH}`,
+        '+refs/tags/nap/*:refs/tags/nap/*',
+    ];
+    for (const refspec of refspecs) {
+        try {
+            git(['--git-dir', dir, 'fetch', '--quiet', url, refspec], {});
+        } catch {
+            // リモートにまだ無い ref は取り込まない
+        }
+    }
+    return dir;
+}
+
+function listTagIds(snapshotDir) {
+    let out = '';
+    try {
+        out = gitText(['--git-dir', snapshotDir, 'tag', '-l', 'nap/*'], {});
+    } catch {
+        return [];
+    }
+    return out
+        .split('\n')
+        .filter(Boolean)
+        .map((tag) => tag.slice('nap/'.length));
+}
+
+module.exports = { readIndexAt, openSnapshot, listTagIds };

package/lib/remove.js

@@ -0,0 +1,70 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { parseDeclaration, DECLARATION_FILE } = require('./declaration');
+const { parseGetTarget, dependencyRefFor, isForkDir, MODULES_DIR } = require('./get');
+const { askYesNo } = require('./publish');
+
+// 依存関係の記録から、指定した参照を取り除いた宣言のテキストを返す。
+// 記録が無ければ null。
+function dropDependency(declarationText, ref) {
+    const doc = JSON.parse(declarationText);
+    if (!Array.isArray(doc.composition)) return null;
+    const entryName = (entry) => (typeof entry === 'string' ? entry : entry && entry.name);
+    const composition = doc.composition.filter((entry) => entryName(entry) !== ref);
+    if (composition.length === doc.composition.length) return null;
+    if (composition.length === 0) delete doc.composition;
+    else doc.composition = composition;
+    const text = `${JSON.stringify(doc, null, 2)}\n`;
+    parseDeclaration(text);
+    return text;
+}
+
+// 導入したパッケージを取り除く。nap_modules の実体と、宣言の記録が対象。
+async function remove(specText, options = {}) {
+    const cwd = process.cwd();
+    const declarationPath = path.join(cwd, DECLARATION_FILE);
+    if (!fs.existsSync(declarationPath)) {
+        throw new Error(
+            `${DECLARATION_FILE} がありません。プロジェクトのフォルダで実行してください。`,
+        );
+    }
+    const { repo, ref: versionRef } = parseGetTarget(specText);
+    if (versionRef) {
+        throw new Error('版の指定は要りません。');
+    }
+    const ref = dependencyRefFor(repo);
+    const target = path.join(cwd, MODULES_DIR, ref);
+    const declarationText = fs.readFileSync(declarationPath, 'utf8');
+    const nextText = dropDependency(declarationText, ref);
+    const installed = fs.existsSync(target);
+    if (!installed && !nextText) {
+        throw new Error(`導入されていません: ${ref}`);
+    }
+    if (installed && isForkDir(target) && !options.yes) {
+        const ok = await askYesNo(
+            `${ref} はフォークです。作業内容が失われますが、取り除きますか？ [y/N] `,
+        );
+        if (!ok) {
+            console.log('取り除きませんでした。');
+            return;
+        }
+    }
+    if (installed) {
+        fs.rmSync(target, { recursive: true, force: true });
+        // 空になった組織IDのフォルダも片付ける。
+        const orgDir = path.dirname(target);
+        if (fs.existsSync(orgDir) && fs.readdirSync(orgDir).length === 0) {
+            fs.rmdirSync(orgDir);
+        }
+        const modulesDir = path.join(cwd, MODULES_DIR);
+        if (fs.existsSync(modulesDir) && fs.readdirSync(modulesDir).length === 0) {
+            fs.rmdirSync(modulesDir);
+        }
+    }
+    if (nextText) fs.writeFileSync(declarationPath, nextText, 'utf8');
+    console.log(`取り除きました: ${ref}`);
+}
+
+module.exports = { remove, dropDependency };

package/lib/search.js

@@ -0,0 +1,92 @@
+'use strict';
+
+// GitHub のコード検索で nap.json を持つリポジトリを探し、
+// 各リポジトリの nap.json を読んでパッケージ名と構成を表示する。
+// コード検索には認証が必要なため、トークンを GITHUB_TOKEN から読む。
+// 無ければ GH_TOKEN を読む。
+
+function buildQuery(keywords) {
+    return ['filename:nap.json', ...keywords].join(' ');
+}
+
+// 検索結果の項目から、リポジトリ単位に重複を取り除く。
+function dedupeRepos(items) {
+    const seen = new Map();
+    for (const item of items || []) {
+        const repo = item && item.repository && item.repository.full_name;
+        if (!repo || seen.has(repo)) continue;
+        seen.set(repo, {
+            repo,
+            defaultBranch: item.repository.default_branch || 'HEAD',
+            htmlUrl: item.repository.html_url || '',
+        });
+    }
+    return [...seen.values()];
+}
+
+async function fetchJson(url, token, fetchImpl) {
+    const res = await fetchImpl(url, {
+        headers: {
+            Accept: 'application/vnd.github+json',
+            Authorization: `Bearer ${token}`,
+            'X-GitHub-Api-Version': '2022-11-28',
+        },
+    });
+    if (!res.ok) {
+        let detail = '';
+        try {
+            const body = await res.json();
+            detail = body && body.message ? `: ${body.message}` : '';
+        } catch {
+            detail = '';
+        }
+        throw new Error(`GitHub API がエラーを返しました。HTTP ${res.status}${detail}`);
+    }
+    return res.json();
+}
+
+async function search(keywords, options = {}) {
+    const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN || '';
+    if (!token) {
+        throw new Error(
+            'GitHub のコード検索には認証が必要です。GITHUB_TOKEN にトークンを設定してください。',
+        );
+    }
+    const fetchImpl = options.fetch || ((...args) => globalThis.fetch(...args));
+    const apiBase = (process.env.NAP_GITHUB_API_BASE || 'https://api.github.com').replace(/\/$/, '');
+    const rawBase = (process.env.NAP_RAW_BASE || 'https://raw.githubusercontent.com').replace(/\/$/, '');
+    const limit = options.limit || 20;
+
+    const query = buildQuery(keywords);
+    const url = `${apiBase}/search/code?q=${encodeURIComponent(query)}&per_page=100`;
+    const data = await fetchJson(url, token, fetchImpl);
+    const candidates = dedupeRepos(data.items).slice(0, limit);
+    if (candidates.length === 0) {
+        console.log('パッケージは見つかりませんでした。');
+        return;
+    }
+    console.log(`候補: ${data.total_count} 件中 ${candidates.length} 件のリポジトリを確認します`);
+    for (const candidate of candidates) {
+        let summary = 'nap.json を読めませんでした';
+        try {
+            const res = await fetchImpl(
+                `${rawBase}/${candidate.repo}/${candidate.defaultBranch}/nap.json`,
+            );
+            if (res.ok) {
+                const declaration = await res.json();
+                const members = Array.isArray(declaration.composition)
+                    ? declaration.composition.length
+                    : 0;
+                summary = `パッケージ: ${declaration.name || '名前なし'} / 構成員: ${members} 件`;
+            }
+        } catch {
+            summary = 'nap.json を読めませんでした';
+        }
+        console.log(`  ${candidate.repo}  ${summary}`);
+    }
+    if (data.total_count > candidates.length) {
+        console.log(`他 ${data.total_count - candidates.length} 件。キーワードで絞り込めます`);
+    }
+}
+
+module.exports = { search, buildQuery, dedupeRepos };

package/package.json

@@ -1,6 +1,19 @@
 {
+  "bin": {
+    "nap": "./cli.js"
+  },
+  "description": "NAP の CLI と、クライアント向け取得ライブラリです。Git 拡張方式の発行を行います。",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "cli.js",
+    "lib",
+    "client"
+  ],
   "name": "@nyaitter/nap",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.2.0"
+}