executive-pi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PI Executive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LISTING.md

@@ -0,0 +1,14 @@
+# PiOS list.md row (SDK table)
+
+Use this row in https://github.com/pi-apps/PiOS/blob/main/list.md under "SDKs and other libraries":
+
+| Pi SDK for JavaScript | JavaScript backend SDK wrapper for Pi Platform API, supporting U2A and A2U payment flows, server-side approval/completion/cancel, and user token verification. | SDK | JavaScript/Node.js | [executive-pi](https://github.com/piexecutive69/executive-pi) | |
+
+## PR Title suggestion
+
+Add "Pi SDK for JavaScript" to PiOS SDK list
+
+## PR Description suggestion
+
+This PR adds a JavaScript/Node.js SDK entry for Pi Platform backend integration.
+Repository includes wrappers for payment approval/completion/cancelation, incomplete payment listing, A2U payment creation, and user token verification.

package/README.md

@@ -0,0 +1,52 @@
+# executive-pi
+
+JavaScript SDK wrapper for Pi Platform API backend flows (U2A + A2U).
+
+Pi, Pi Network and the Pi logo are trademarks of the Pi Community Company.
+
+## Requirements
+
+- Node.js 18+
+- Pi Platform API key from Pi Developer Portal
+
+## Install
+
+```bash
+npm install executive-pi
+```
+
+## Quick Start
+
+```js
+import { PiJavascript } from 'executive-pi'
+
+const pi = new PiJavascript({
+  apiKey: process.env.PI_API_KEY,
+})
+
+const payment = await pi.getPayment('PAYMENT_ID')
+console.log(payment)
+```
+
+## API
+
+- `approvePayment(paymentId)`
+- `completePayment(paymentId, txid)`
+- `cancelPayment(paymentId)`
+- `getPayment(paymentId)`
+- `listIncompleteServerPayments()`
+- `createA2UPayment({ amount, memo, metadata, uid })`
+- `verifyUserAccessToken(accessToken)`
+
+## Run example
+
+```bash
+PI_API_KEY=your_key node examples/list-incomplete.js
+```
+
+## Test
+
+```bash
+npm test
+```
+

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "executive-pi",
+  "version": "0.1.0",
+  "description": "JavaScript SDK wrapper for Pi Platform API (A2U/U2A backend flow)",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE",
+    "LISTING.md"
+  ],
+  "scripts": {
+    "test": "node test/smoke.test.js"
+  },
+  "keywords": [
+    "pi",
+    "pi-network",
+    "sdk",
+    "payments",
+    "javascript"
+  ],
+  "author": "PI Executive",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/index.js

@@ -0,0 +1,129 @@
+const DEFAULT_BASE_URL = 'https://api.minepi.com/v2'
+
+function buildHeaders(apiKey, extraHeaders = {}) {
+  return {
+    Authorization: `Key ${apiKey}`,
+    'Content-Type': 'application/json',
+    ...extraHeaders,
+  }
+}
+
+async function parseJsonSafe(response) {
+  try {
+    return await response.json()
+  } catch {
+    return {}
+  }
+}
+
+export class PiApiError extends Error {
+  constructor(message, status, detail) {
+    super(message)
+    this.name = 'PiApiError'
+    this.status = status
+    this.detail = detail
+  }
+}
+
+export class PiJavascript {
+  constructor({ apiKey, baseUrl = DEFAULT_BASE_URL, fetchImpl = fetch } = {}) {
+    if (!apiKey) {
+      throw new Error('Missing apiKey')
+    }
+    if (typeof fetchImpl !== 'function') {
+      throw new Error('fetchImpl must be a function')
+    }
+
+    this.apiKey = apiKey
+    this.baseUrl = baseUrl.replace(/\/$/, '')
+    this.fetchImpl = fetchImpl
+  }
+
+  async request(path, { method = 'GET', body, headers } = {}) {
+    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method,
+      headers: buildHeaders(this.apiKey, headers),
+      body: body == null ? undefined : JSON.stringify(body),
+    })
+
+    const data = await parseJsonSafe(response)
+    if (!response.ok) {
+      throw new PiApiError(
+        data?.error_message || data?.message || data?.error || 'Pi API request failed',
+        response.status,
+        data,
+      )
+    }
+
+    return data
+  }
+
+  // U2A lifecycle
+  approvePayment(paymentId) {
+    if (!paymentId) throw new Error('paymentId is required')
+    return this.request(`/payments/${paymentId}/approve`, { method: 'POST', body: {} })
+  }
+
+  completePayment(paymentId, txid) {
+    if (!paymentId) throw new Error('paymentId is required')
+    if (!txid) throw new Error('txid is required')
+    return this.request(`/payments/${paymentId}/complete`, { method: 'POST', body: { txid } })
+  }
+
+  cancelPayment(paymentId) {
+    if (!paymentId) throw new Error('paymentId is required')
+    return this.request(`/payments/${paymentId}/cancel`, { method: 'POST', body: {} })
+  }
+
+  getPayment(paymentId) {
+    if (!paymentId) throw new Error('paymentId is required')
+    return this.request(`/payments/${paymentId}`, { method: 'GET' })
+  }
+
+  listIncompleteServerPayments() {
+    return this.request('/payments/incomplete_server_payments', { method: 'GET' })
+  }
+
+  // A2U
+  createA2UPayment({ amount, memo, metadata, uid }) {
+    if (amount == null) throw new Error('amount is required')
+    if (!uid) throw new Error('uid is required')
+
+    return this.request('/payments', {
+      method: 'POST',
+      body: {
+        payment: {
+          amount,
+          memo,
+          metadata,
+          uid,
+        },
+      },
+    })
+  }
+
+  // Verify user token with /me
+  async verifyUserAccessToken(accessToken) {
+    if (!accessToken) throw new Error('accessToken is required')
+
+    const response = await this.fetchImpl(`${this.baseUrl}/me`, {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+    })
+
+    const data = await parseJsonSafe(response)
+    if (!response.ok) {
+      throw new PiApiError(
+        data?.error_message || data?.message || data?.error || 'Pi /me verification failed',
+        response.status,
+        data,
+      )
+    }
+
+    return data
+  }
+}
+
+export default PiJavascript