@onesub/cli 0.1.1

package/README.md

@@ -0,0 +1,37 @@
+# @onesub/cli
+
+Scaffolds a ready-to-run [onesub](https://github.com/jeonghwanko/onesub) server project.
+
+```bash
+npx @onesub/cli init my-onesub-server
+cd my-onesub-server
+cp .env.example .env
+npm install
+npm run dev
+```
+
+Or full stack (Postgres + server) in one command:
+
+```bash
+docker compose up
+```
+
+## What it generates
+
+| File | Purpose |
+|------|---------|
+| `server.ts` | Express app with `createOneSubMiddleware()` wired up |
+| `.env.example` | Apple / Google / Postgres / admin placeholders |
+| `docker-compose.yml` | Postgres + server, schema auto-initialized from `@onesub/server/sql/schema.sql` |
+| `package.json`, `tsconfig.json`, `.gitignore`, `README.md` | Standard project shell |
+
+That's it. No prompts, no interactive questionnaire — same scaffold every time, tweak it yourself afterward.
+
+## Commands
+
+```
+onesub init [directory]   Scaffold into <directory> (default: .)
+onesub --help             Show help
+```
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * onesub CLI — scaffolds a starter server (+ optional Expo app) in a new or
+ * existing directory.
+ *
+ * Usage:
+ *   npx @onesub/cli init [directory]
+ *   npx @onesub/cli --help
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/index.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/**
+ * onesub CLI — scaffolds a starter server (+ optional Expo app) in a new or
+ * existing directory.
+ *
+ * Usage:
+ *   npx @onesub/cli init [directory]
+ *   npx @onesub/cli --help
+ */
+import { mkdir, writeFile, readdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const here = dirname(fileURLToPath(import.meta.url));
+// dist/index.js → packages/cli/templates
+const TEMPLATES_DIR = resolve(here, '..', 'templates');
+const HELP = `onesub — scaffold a receipt-validation server and paywall app
+
+Usage:
+  onesub init [directory]   Create a new onesub project in <directory> (default: .)
+  onesub --help             Show this help
+
+What 'init' creates:
+  server.ts                 Express server with createOneSubMiddleware() wired up
+  .env.example              Apple + Google credential placeholders
+  package.json              With @onesub/server as a dependency
+  docker-compose.yml        Postgres + server, schema auto-initialized
+  README.md                 Next-steps guide
+
+After init:
+  cd <directory>
+  cp .env.example .env      # fill in your credentials
+  npm install
+  npm start                 # http://localhost:4100
+`;
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        return { cmd: 'help', target: '.' };
+    }
+    if (args[0] !== 'init') {
+        return { cmd: 'unknown', target: args[0] ?? '' };
+    }
+    return { cmd: 'init', target: args[1] ?? '.' };
+}
+async function isEmpty(dir) {
+    if (!existsSync(dir))
+        return true;
+    const entries = await readdir(dir);
+    return entries.length === 0;
+}
+async function copyTemplate(relPath, destDir) {
+    const src = join(TEMPLATES_DIR, relPath);
+    const dst = join(destDir, relPath);
+    await mkdir(dirname(dst), { recursive: true });
+    const content = await readFile(src, 'utf8');
+    await writeFile(dst, content, 'utf8');
+    console.log(`  ${relPath}`);
+}
+async function init(target) {
+    const dir = resolve(target);
+    const empty = await isEmpty(dir);
+    if (!empty) {
+        console.error(`error: ${dir} is not empty. Pick a new directory or remove existing files.`);
+        process.exit(1);
+    }
+    await mkdir(dir, { recursive: true });
+    console.log(`\nScaffolding onesub server into ${dir}\n`);
+    const files = [
+        'package.json',
+        'server.ts',
+        'tsconfig.json',
+        '.env.example',
+        'docker-compose.yml',
+        'README.md',
+        '.gitignore',
+    ];
+    for (const f of files) {
+        await copyTemplate(f, dir);
+    }
+    console.log(`
+Done. Next steps:
+
+  cd ${target === '.' ? '.' : target}
+  cp .env.example .env    # fill in Apple / Google credentials
+  npm install
+  npm run dev             # http://localhost:4100
+
+Or with Docker (Postgres + server):
+
+  docker compose up
+
+Docs: https://github.com/jeonghwanko/onesub
+`);
+}
+async function main() {
+    const { cmd, target } = parseArgs(process.argv);
+    switch (cmd) {
+        case 'help':
+            console.log(HELP);
+            return;
+        case 'init':
+            await init(target);
+            return;
+        default:
+            console.error(`Unknown command: ${target}\n`);
+            console.error(HELP);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error('onesub cli failed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@onesub/cli",
+  "version": "0.1.1",
+  "description": "CLI scaffolding for onesub — `npx onesub init` bootstraps a server + Expo app.",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "onesub": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "onesub",
+    "cli",
+    "init",
+    "scaffolding",
+    "react-native-iap",
+    "in-app-purchase"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeonghwanko/onesub.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/jeonghwanko/onesub",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@onesub/shared": "0.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/templates/.env.example

@@ -0,0 +1,22 @@
+# ── Apple App Store ──────────────────────────────────────
+# From App Store Connect → Users and Access → Integrations → Keys
+APPLE_BUNDLE_ID=com.yourapp.id
+APPLE_SHARED_SECRET=your_shared_secret
+
+# ── Google Play ─────────────────────────────────────────
+# Service account JSON from Google Cloud Console (single-line)
+GOOGLE_PACKAGE_NAME=com.yourapp.id
+GOOGLE_SERVICE_ACCOUNT_KEY={"type":"service_account","project_id":"..."}
+# Optional: push endpoint URL for Pub/Sub JWT verification
+# GOOGLE_PUSH_AUDIENCE=https://api.yourapp.com/onesub/webhook/google
+
+# ── Database ────────────────────────────────────────────
+# Uncomment for Postgres; leave unset for in-memory (dev only)
+# DATABASE_URL=postgresql://onesub:onesub@localhost:5432/onesub
+
+# ── Admin (optional) ────────────────────────────────────
+# Enables /onesub/purchase/admin/* routes
+# ADMIN_SECRET=change-me
+
+# ── Server ──────────────────────────────────────────────
+PORT=4100

package/templates/README.md

@@ -0,0 +1,43 @@
+# my-onesub-server
+
+Scaffolded by [`npx @onesub/cli init`](https://github.com/jeonghwanko/onesub).
+
+## Run
+
+```bash
+cp .env.example .env   # fill in Apple / Google credentials
+npm install
+npm run dev            # http://localhost:4100
+```
+
+Or the full stack (Postgres + server) with Docker:
+
+```bash
+docker compose up
+```
+
+## What you got
+
+| File | What |
+|------|------|
+| `server.ts` | Express server with `createOneSubMiddleware()` wired up |
+| `.env.example` | Apple / Google / DB placeholders |
+| `docker-compose.yml` | Postgres + server, schema auto-initialized from `@onesub/server/sql/schema.sql` |
+
+## Endpoints mounted
+
+- `POST /onesub/validate` — subscription receipt
+- `GET  /onesub/status?userId=` — subscription state
+- `POST /onesub/webhook/apple` — App Store Server Notifications V2
+- `POST /onesub/webhook/google` — Google Play RTDN
+- `POST /onesub/purchase/validate` — one-time purchase (consumable / non-consumable)
+- `GET  /onesub/purchase/status?userId=` — list purchases
+- `POST /onesub/purchase/admin/*` — admin routes (if `ADMIN_SECRET` is set)
+
+## Next
+
+- Add your own auth middleware before `createOneSubMiddleware(...)` if `userId` should not be client-trusted
+- Install [`@jeonghwanko/onesub-sdk`](https://www.npmjs.com/package/@jeonghwanko/onesub-sdk) in your React Native app for the `useOneSub()` hook
+- Read [onesub docs](https://github.com/jeonghwanko/onesub)
+
+MIT.

package/templates/docker-compose.yml

@@ -0,0 +1,41 @@
+services:
+  db:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: onesub
+      POSTGRES_PASSWORD: onesub
+      POSTGRES_DB: onesub
+    ports:
+      - '5432:5432'
+    volumes:
+      - onesub-pgdata:/var/lib/postgresql/data
+      # Canonical schema shipped with @onesub/server at node_modules/@onesub/server/sql/schema.sql
+      - ./node_modules/@onesub/server/sql/schema.sql:/docker-entrypoint-initdb.d/10-onesub-schema.sql:ro
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U onesub -d onesub']
+      interval: 5s
+      timeout: 3s
+      retries: 10
+
+  server:
+    image: node:20-alpine
+    depends_on:
+      db:
+        condition: service_healthy
+    working_dir: /app
+    command: sh -c "npm install --no-audit --no-fund && npm run dev"
+    environment:
+      PORT: '4100'
+      DATABASE_URL: postgresql://onesub:onesub@db:5432/onesub
+      APPLE_BUNDLE_ID: ${APPLE_BUNDLE_ID:-}
+      APPLE_SHARED_SECRET: ${APPLE_SHARED_SECRET:-}
+      GOOGLE_PACKAGE_NAME: ${GOOGLE_PACKAGE_NAME:-}
+      GOOGLE_SERVICE_ACCOUNT_KEY: ${GOOGLE_SERVICE_ACCOUNT_KEY:-}
+    ports:
+      - '4100:4100'
+    volumes:
+      - .:/app
+
+volumes:
+  onesub-pgdata:

package/templates/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "my-onesub-server",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx server.ts",
+    "start": "tsx server.ts"
+  },
+  "dependencies": {
+    "@onesub/server": "^0.6.0",
+    "dotenv": "^16.4.5",
+    "express": "^4.19.2",
+    "pg": "^8.13.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.17.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/templates/server.ts

@@ -0,0 +1,45 @@
+import 'dotenv/config';
+import express from 'express';
+import {
+  createOneSubMiddleware,
+  InMemorySubscriptionStore,
+  InMemoryPurchaseStore,
+  PostgresSubscriptionStore,
+  PostgresPurchaseStore,
+} from '@onesub/server';
+
+const app = express();
+const port = parseInt(process.env.PORT ?? '4100', 10);
+
+// Pick stores based on whether DATABASE_URL is set.
+const dbUrl = process.env.DATABASE_URL;
+const store = dbUrl ? new PostgresSubscriptionStore(dbUrl) : new InMemorySubscriptionStore();
+const purchaseStore = dbUrl ? new PostgresPurchaseStore(dbUrl) : new InMemoryPurchaseStore();
+
+if (store instanceof PostgresSubscriptionStore) await store.initSchema();
+if (purchaseStore instanceof PostgresPurchaseStore) await purchaseStore.initSchema();
+
+app.use(
+  createOneSubMiddleware({
+    apple: process.env.APPLE_BUNDLE_ID
+      ? { bundleId: process.env.APPLE_BUNDLE_ID, sharedSecret: process.env.APPLE_SHARED_SECRET }
+      : undefined,
+    google: process.env.GOOGLE_PACKAGE_NAME
+      ? {
+          packageName: process.env.GOOGLE_PACKAGE_NAME,
+          serviceAccountKey: process.env.GOOGLE_SERVICE_ACCOUNT_KEY,
+          pushAudience: process.env.GOOGLE_PUSH_AUDIENCE,
+        }
+      : undefined,
+    database: { url: dbUrl ?? '' },
+    store,
+    purchaseStore,
+    adminSecret: process.env.ADMIN_SECRET,
+  }),
+);
+
+app.get('/health', (_req, res) => res.json({ ok: true }));
+
+app.listen(port, () => {
+  console.log(`[onesub] listening on http://localhost:${port}`);
+});

package/templates/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["server.ts"]
+}