mirror of
https://github.com/aljazceru/gitpear.git
synced 2025-12-17 14:14:22 +01:00
12
Readme.md
12
Readme.md
@@ -120,18 +120,20 @@ git pull
|
||||
|
||||
Collaboration is possible with the following flow between Carol and David in a peer-to-peer manner.
|
||||
|
||||
Supported authentication methods are `native` and `nip98`. The `nip98` authentication, requires environment variable `GIT_PEAR_AUTH_NSEC` with nsec
|
||||
|
||||
### Carol steps (as a server of code)
|
||||
1. Start daemon
|
||||
* `GIT_PEAR_AUTH_NSEC=<Carol's nsec> GIT_PEAR_AUTH='nip98' git pear daemon -s`
|
||||
* `GIT_PEAR_AUTH='native' git pear daemon -s`
|
||||
2. Go to repository
|
||||
* `cd repo`
|
||||
3. Initialize git pear repository
|
||||
* `git pear init .`
|
||||
4. Share repository wit hviben visibility () - (default is `public`)
|
||||
* `git pear share . <private|public>`
|
||||
* `git pear share . public`
|
||||
5. Add Daviv as a `contirbutor`.
|
||||
6. List David's npub as a contributor
|
||||
* `git pear acl add <David npub>:contributor`
|
||||
* `git pear acl add <David pub key hex>:contributor`
|
||||
7. Retreive repo url and share it with Dave
|
||||
* `git pear list -s`
|
||||
|
||||
@@ -139,14 +141,14 @@ Collaboration is possible with the following flow between Carol and David in a p
|
||||
1. Start daemon. This will be needed later for push. Not that no auth or sec are provided which means that push to this place will not be supportedd.
|
||||
* `git pear daemon -s`
|
||||
2. Clone repository. Authorization data and type are necesary for server (Carol) to grant corresponding access persmissions
|
||||
* `GIT_PEAR_AUTH_NSEC=<David's nsec> GIT_PEAR_AUTH='nip98' git clone pear://<Carol's url>/<repo name>`
|
||||
* `GIT_PEAR_AUTH='native' git clone pear://<Carol's pub key hex>/<repo name>`
|
||||
3. Do the necessary change in separate branch
|
||||
* `git checkout -b feat/david`
|
||||
* do change
|
||||
* `git add .`
|
||||
* `git commit -s -m 'made by David'`
|
||||
4. Push branch to origin
|
||||
* `GIT_PEAR_AUTH_NSEC=<David's nsec> GIT_PEAR_AUTH='nip98' git push origin feat/david`
|
||||
* `GIT_PEAR_AUTH='native' git push origin feat/david`
|
||||
|
||||
### Carol steps
|
||||
1. For Carol the changes will arrive as branch `feat/david` into her `pear`
|
||||
|
||||
@@ -28,7 +28,7 @@ const targetKey = matches[1]
|
||||
const repoName = matches[2]
|
||||
|
||||
const store = new Corestore(RAM)
|
||||
const swarm = new Hyperswarm({ keypair: home.getKeyPair() })
|
||||
const swarm = new Hyperswarm({ keyPair: home.getKeyPair() })
|
||||
|
||||
if (!home.isDaemonRunning()) {
|
||||
console.error('Please start git pear daemon')
|
||||
@@ -42,7 +42,7 @@ swarm.on('connection', async (socket) => {
|
||||
const rpc = new ProtomuxRPC(socket)
|
||||
|
||||
let payload = { body: { url, method: 'get-repos' } }
|
||||
if (process.env.GIT_PEAR_AUTH) {
|
||||
if (process.env.GIT_PEAR_AUTH && process.env.GIT_PEAR_AUTH !== 'native') {
|
||||
payload.header = await auth.getToken(payload.body)
|
||||
}
|
||||
|
||||
@@ -73,7 +73,7 @@ swarm.on('connection', async (socket) => {
|
||||
await drive.core.update({ wait: true })
|
||||
|
||||
payload = { body: { url, method: 'get-refs', data: repoName }}
|
||||
if (process.env.GIT_PEAR_AUTH) {
|
||||
if (process.env.GIT_PEAR_AUTH && process.env.GIT_PEAR_AUTH !== 'native') {
|
||||
payload.header = await auth.getToken(payload.body)
|
||||
}
|
||||
const refsRes = await rpc.request('get-refs', Buffer.from(JSON.stringify(payload)))
|
||||
@@ -101,10 +101,6 @@ async function talkToGit (refs, drive, repoName, rpc, commit) {
|
||||
const isDelete = !src
|
||||
const isForce = src.startsWith('+')
|
||||
|
||||
if (!home.isShared(repoName)) {
|
||||
home.shareAppFolder(name)
|
||||
}
|
||||
|
||||
dst = dst.replace('refs/heads/', '').replace('\n\n', '')
|
||||
|
||||
try { home.createAppFolder(repoName) } catch (e) { }
|
||||
@@ -134,7 +130,7 @@ async function talkToGit (refs, drive, repoName, rpc, commit) {
|
||||
data: `${dst}#${commit}`,
|
||||
method
|
||||
} }
|
||||
if (process.env.GIT_PEAR_AUTH) {
|
||||
if (process.env.GIT_PEAR_AUTH && process.env.GIT_PEAR_AUTH !== 'native') {
|
||||
payload.header = await auth.getToken(payload.body)
|
||||
}
|
||||
const res = await rpc.request(method, Buffer.from(JSON.stringify(payload)))
|
||||
|
||||
13
src/rpc.js
13
src/rpc.js
@@ -1,4 +1,5 @@
|
||||
const ProtomuxRPC = require('protomux-rpc')
|
||||
const SecretStream = require('@hyperswarm/secret-stream')
|
||||
const { spawn } = require('child_process')
|
||||
const home = require('./home')
|
||||
const auth = require('./auth')
|
||||
@@ -21,14 +22,14 @@ module.exports = class RPC {
|
||||
// which can in turn be stored in a .git-daemon-export-ok file
|
||||
|
||||
/* -- PULL HANDLERS -- */
|
||||
rpc.respond('get-repos', async req => await this.getReposHandler(peerInfo.publicKey, req))
|
||||
rpc.respond('get-refs', async req => await this.getRefsHandler(peerInfo.publicKey, req))
|
||||
rpc.respond('get-repos', async req => await this.getReposHandler(socket.remotePublicKey, req))
|
||||
rpc.respond('get-refs', async req => await this.getRefsHandler(socket.remotePublicKey, req))
|
||||
|
||||
if (process.env.GIT_PEAR_AUTH) {
|
||||
/* -- PUSH HANDLERS -- */
|
||||
rpc.respond('push', async req => await this.pushHandler(peerInfo.publicKey, req))
|
||||
rpc.respond('f-push', async req => await this.forcePushHandler(peerInfo.publicKey, req))
|
||||
rpc.respond('d-branch', async req => await this.deleteBranchHandler(peerInfo.publicKey, req))
|
||||
rpc.respond('push', async req => await this.pushHandler(socket.remotePublicKey, req))
|
||||
rpc.respond('f-push', async req => await this.forcePushHandler(socket.remotePublicKey, req))
|
||||
rpc.respond('d-branch', async req => await this.deleteBranchHandler(socket.remotePublicKey, req))
|
||||
}
|
||||
|
||||
this.connections[peerInfo.publicKey] = rpc
|
||||
@@ -145,11 +146,13 @@ module.exports = class RPC {
|
||||
url: request.body.url,
|
||||
userId: await this.authenticate(publicKey, request),
|
||||
}
|
||||
console.error('parsed', parsed)
|
||||
return parsed
|
||||
}
|
||||
|
||||
async authenticate (publicKey, request) {
|
||||
if (!process.env.GIT_PEAR_AUTH) return publicKey.toString('hex')
|
||||
if (process.env.GIT_PEAR_AUTH === 'native') return publicKey.toString('hex')
|
||||
if (!request.header) throw new Error('You are not allowed to access this repo')
|
||||
|
||||
return (await auth.getId({ ...request.body, payload: request.header })).userId
|
||||
|
||||
Reference in New Issue
Block a user