@optima-chat/dev-skills 0.7.33 → 0.7.36

package/dist/bin/helpers/plugin/show.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runShow = runShow;
+const billing_http_1 = require("../billing-http");
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-plugin show --slug <slug> [options]
+
+Required:
+  --slug <slug>
+
+Optional:
+  --env stage|prod   (default: stage)
+
+Note: reads the public GET /api/plugins/:slug — shows isPaid, salesUrl, and
+descriptive fields, but NOT defaultForUser / status / trustLevel (public
+endpoint omits them). Returns 404 for non-ACTIVE plugins.`);
+        process.exit(0);
+    }
+    const out = { env: 'stage' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--slug':
+                out.slug = next;
+                i++;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.slug)
+        throw new Error('--slug required');
+    return out;
+}
+async function runShow(argv) {
+    const args = parseArgs(argv);
+    (0, billing_http_1.validateEnv)(args.env);
+    const res = await (0, billing_http_1.callSkills)(args.env, 'GET', `/api/plugins/${encodeURIComponent(args.slug)}`);
+    console.log(JSON.stringify(res.body, null, 2));
+}

package/dist/bin/helpers/plugin.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const show_1 = require("./plugin/show");
+const set_paid_1 = require("./plugin/set-paid");
+const set_default_1 = require("./plugin/set-default");
+function printHelp() {
+    console.log(`Usage: optima-plugin <subcommand> [options]
+
+Subcommands:
+  show          Show a plugin's marketplace state (isPaid, salesUrl, ... ACTIVE plugins only)
+  set-paid      Flip a plugin's isPaid flag (the user-facing paid/free gate)
+  set-default   Flip a plugin's defaultForUser flag
+
+Run 'optima-plugin <subcommand> --help' for subcommand-specific options.`);
+}
+async function main() {
+    const [, , subcommand, ...rest] = process.argv;
+    if (!subcommand || subcommand === '-h' || subcommand === '--help') {
+        printHelp();
+        process.exit(0);
+    }
+    switch (subcommand) {
+        case 'show':
+            await (0, show_1.runShow)(rest);
+            break;
+        case 'set-paid':
+            await (0, set_paid_1.runSetPaid)(rest);
+            break;
+        case 'set-default':
+            await (0, set_default_1.runSetDefault)(rest);
+            break;
+        default:
+            console.error(`Unknown subcommand: ${subcommand}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main().catch((err) => { console.error(err.message); process.exit(1); });

package/dist/bin/helpers/product/add-channel.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAddChannel = runAddChannel;
+const billing_http_1 = require("../billing-http");
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-product add-channel --key <productKey> --provider STRIPE --stripe-price-id <price_xxx> --price-cents N --currency USD [options]
+
+Required:
+  --key <productKey>
+  --provider STRIPE                v1 CLI accepts only STRIPE (schema supports more)
+  --stripe-price-id <price_xxx>    Pre-created in Stripe Dashboard; wire-mapped to externalProductId
+  --price-cents N                  MUST be > 0; should match Stripe Price's unit_amount (NOT verified)
+  --currency USD                   Should match Stripe Price's currency (NOT verified)
+
+Optional:
+  --enabled true|false             default: true
+  --metadata '<json>'
+  --env stage|prod                 (default: stage)`);
+        process.exit(0);
+    }
+    const out = { env: 'stage' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--key':
+                out.key = next;
+                i++;
+                break;
+            case '--provider':
+                out.provider = next;
+                i++;
+                break;
+            case '--stripe-price-id':
+                out.stripePriceId = next;
+                i++;
+                break;
+            case '--price-cents':
+                out.priceCents = parseInt(next, 10);
+                i++;
+                break;
+            case '--currency':
+                out.currency = next;
+                i++;
+                break;
+            case '--enabled':
+                out.enabled = next === 'true';
+                i++;
+                break;
+            case '--metadata':
+                out.metadata = JSON.parse(next);
+                i++;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.key)
+        throw new Error('--key required');
+    if (!out.provider)
+        throw new Error('--provider required');
+    if (out.provider !== 'STRIPE')
+        throw new Error(`v1 CLI accepts only --provider STRIPE (got ${out.provider})`);
+    if (!out.stripePriceId)
+        throw new Error('--stripe-price-id required');
+    if (out.priceCents === undefined || !Number.isFinite(out.priceCents))
+        throw new Error('--price-cents required (integer)');
+    if (out.priceCents <= 0)
+        throw new Error('--price-cents must be > 0');
+    if (!out.currency)
+        throw new Error('--currency required');
+    return out;
+}
+async function runAddChannel(argv) {
+    const args = parseArgs(argv);
+    (0, billing_http_1.validateEnv)(args.env);
+    const body = {
+        provider: args.provider,
+        externalProductId: args.stripePriceId,
+        priceCents: args.priceCents,
+        currency: args.currency,
+    };
+    if (args.enabled !== undefined)
+        body.enabled = args.enabled;
+    if (args.metadata !== undefined)
+        body.metadata = args.metadata;
+    console.log(`\n💳 Adding ${args.provider} channel to ${args.key} on ${args.env.toUpperCase()}...`);
+    const res = await (0, billing_http_1.callBilling)(args.env, 'POST', `/api/billing/admin/products/${encodeURIComponent(args.key)}/channels`, body);
+    console.log(`✓ Created Channel (HTTP ${res.status}):`);
+    console.log(JSON.stringify(res.body, null, 2));
+}

package/dist/bin/helpers/product/create.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCreate = runCreate;
+const billing_http_1 = require("../billing-http");
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-product create --key <productKey> --plugins <slug1,slug2,...> --type <ProductType> [options]
+
+Required:
+  --key <productKey>             Unique slug
+  --plugins <slug1,slug2,...>    Comma-separated, >=1 plugin slug
+  --type <ProductType>           Only ONE_SHOT_SKILL accepted by v1 CLI policy
+
+Optional:
+  --name "..."                   Convenience flag, folded into metadata.name
+  --description "..."            Convenience flag, folded into metadata.description
+  --refund-window-days N
+  --refund-prorate-max-days N
+  --bundled-plan-id <planId>     (joint with --bundled-duration-days)
+  --bundled-duration-days N
+  --revoke-bundled-on-refund true|false
+  --metadata '<json>'            JSON object stored in product.metadata
+  --env stage|prod               (default: stage)`);
+        process.exit(0);
+    }
+    const out = { env: 'stage', revokeBundledOnRefund: undefined };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--key':
+                out.key = next;
+                i++;
+                break;
+            case '--plugins':
+                out.plugins = next.split(',').map((s) => s.trim()).filter(Boolean);
+                i++;
+                break;
+            case '--type':
+                out.type = next;
+                i++;
+                break;
+            case '--name':
+                out.name = next;
+                i++;
+                break;
+            case '--description':
+                out.description = next;
+                i++;
+                break;
+            case '--refund-window-days':
+                out.refundWindowDays = parseInt(next, 10);
+                i++;
+                break;
+            case '--refund-prorate-max-days':
+                out.refundProrateMaxDays = parseInt(next, 10);
+                i++;
+                break;
+            case '--bundled-plan-id':
+                out.bundledPlanId = next;
+                i++;
+                break;
+            case '--bundled-duration-days':
+                out.bundledDurationDays = parseInt(next, 10);
+                i++;
+                break;
+            case '--revoke-bundled-on-refund':
+                out.revokeBundledOnRefund = next === 'true';
+                i++;
+                break;
+            case '--metadata':
+                out.metadata = JSON.parse(next);
+                i++;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.key)
+        throw new Error('--key required');
+    if (!out.plugins || out.plugins.length === 0)
+        throw new Error('--plugins required (>=1 slug)');
+    if (!out.type)
+        throw new Error('--type required');
+    if (out.type !== 'ONE_SHOT_SKILL') {
+        throw new Error(`v1 CLI accepts only --type ONE_SHOT_SKILL (got ${out.type}). See spec §5.1.`);
+    }
+    if ((out.bundledPlanId == null) !== (out.bundledDurationDays == null)) {
+        throw new Error('--bundled-plan-id and --bundled-duration-days must be set together');
+    }
+    return out;
+}
+async function runCreate(argv) {
+    const args = parseArgs(argv);
+    (0, billing_http_1.validateEnv)(args.env);
+    const body = {
+        productKey: args.key,
+        type: args.type,
+        pluginSlugs: args.plugins,
+    };
+    if (args.name !== undefined)
+        body.name = args.name;
+    if (args.description !== undefined)
+        body.description = args.description;
+    if (args.refundWindowDays !== undefined)
+        body.refundWindowDays = args.refundWindowDays;
+    if (args.refundProrateMaxDays !== undefined)
+        body.refundProrateMaxDays = args.refundProrateMaxDays;
+    if (args.bundledPlanId !== undefined)
+        body.bundledPlanId = args.bundledPlanId;
+    if (args.bundledDurationDays !== undefined)
+        body.bundledDurationDays = args.bundledDurationDays;
+    if (args.revokeBundledOnRefund !== undefined)
+        body.revokeBundledOnRefund = args.revokeBundledOnRefund;
+    if (args.metadata !== undefined)
+        body.metadata = args.metadata;
+    console.log(`\n🎁 Creating product ${args.key} (${args.plugins.length} plugin(s)) on ${args.env.toUpperCase()}...`);
+    const res = await (0, billing_http_1.callBilling)(args.env, 'POST', '/api/billing/admin/products', body);
+    console.log(`✓ Created Product (HTTP ${res.status}):`);
+    console.log(JSON.stringify(res.body, null, 2));
+}

package/dist/bin/helpers/product/show.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runShow = runShow;
+const billing_http_1 = require("../billing-http");
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-product show --key <productKey> [options]
+
+Required:
+  --key <productKey>
+
+Optional:
+  --env stage|prod                 (default: stage)
+
+Note: returns the bare Product row only — productPlugins and channels arrays
+are NOT included (billing's GET /api/internal/products/:key is a plain
+findUnique with no include). To inspect channels/plugins today, query the DB
+directly via optima-query-db. Tracked as follow-up in spec §7.`);
+        process.exit(0);
+    }
+    const out = { env: 'stage' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--key':
+                out.key = next;
+                i++;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.key)
+        throw new Error('--key required');
+    return out;
+}
+async function runShow(argv) {
+    const args = parseArgs(argv);
+    (0, billing_http_1.validateEnv)(args.env);
+    const res = await (0, billing_http_1.callBilling)(args.env, 'GET', `/api/internal/products/${encodeURIComponent(args.key)}`);
+    console.log(JSON.stringify(res.body, null, 2));
+}

package/dist/bin/helpers/product/toggle-channel.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runToggleChannel = runToggleChannel;
+const billing_http_1 = require("../billing-http");
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-product toggle-channel --key <productKey> --provider STRIPE --enabled true|false [options]
+
+Required:
+  --key <productKey>
+  --provider STRIPE                v1 CLI accepts only STRIPE
+  --enabled true|false
+
+Optional:
+  --env stage|prod                 (default: stage)`);
+        process.exit(0);
+    }
+    const out = { env: 'stage' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--key':
+                out.key = next;
+                i++;
+                break;
+            case '--provider':
+                out.provider = next;
+                i++;
+                break;
+            case '--enabled':
+                if (next !== 'true' && next !== 'false')
+                    throw new Error('--enabled must be true or false');
+                out.enabled = next === 'true';
+                i++;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.key)
+        throw new Error('--key required');
+    if (!out.provider)
+        throw new Error('--provider required');
+    if (out.provider !== 'STRIPE')
+        throw new Error(`v1 CLI accepts only --provider STRIPE (got ${out.provider})`);
+    if (out.enabled === undefined)
+        throw new Error('--enabled required');
+    return out;
+}
+async function runToggleChannel(argv) {
+    const args = parseArgs(argv);
+    (0, billing_http_1.validateEnv)(args.env);
+    console.log(`\n🔁 Setting ${args.provider} channel enabled=${args.enabled} on ${args.key} (${args.env.toUpperCase()})...`);
+    const res = await (0, billing_http_1.callBilling)(args.env, 'PATCH', `/api/billing/admin/products/${encodeURIComponent(args.key)}/channels/${args.provider}`, { enabled: args.enabled });
+    console.log(`✓ Channel updated (HTTP ${res.status}):`);
+    console.log(JSON.stringify(res.body, null, 2));
+}

package/dist/bin/helpers/product/update.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUpdate = runUpdate;
+const billing_http_1 = require("../billing-http");
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-product update --key <productKey> [options]
+
+Required:
+  --key <productKey>
+
+Optional (PATCH — only included fields are updated):
+  --refund-window-days N | null
+  --refund-prorate-max-days N | null
+  --bundled-plan-id <planId> | null    (joint with --bundled-duration-days)
+  --bundled-duration-days N | null
+  --revoke-bundled-on-refund true|false
+  --metadata '<json>'                   FULL REPLACE — Prisma does not deep-merge JSON
+  --env stage|prod                      (default: stage)
+
+Note: productKey, type, and pluginSlugs are immutable post-create. To change plugin
+membership, create a new Product with a new key.`);
+        process.exit(0);
+    }
+    const out = { env: 'stage' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        const parseNullable = (v) => v === 'null' ? null : parseInt(v, 10);
+        switch (a) {
+            case '--key':
+                out.key = next;
+                i++;
+                break;
+            case '--refund-window-days':
+                out.refundWindowDays = parseNullable(next);
+                i++;
+                break;
+            case '--refund-prorate-max-days':
+                out.refundProrateMaxDays = parseNullable(next);
+                i++;
+                break;
+            case '--bundled-plan-id':
+                out.bundledPlanId = next === 'null' ? null : next;
+                i++;
+                break;
+            case '--bundled-duration-days':
+                out.bundledDurationDays = parseNullable(next);
+                i++;
+                break;
+            case '--revoke-bundled-on-refund':
+                out.revokeBundledOnRefund = next === 'true';
+                i++;
+                break;
+            case '--metadata':
+                out.metadata = JSON.parse(next);
+                i++;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.key)
+        throw new Error('--key required');
+    return out;
+}
+async function runUpdate(argv) {
+    const args = parseArgs(argv);
+    (0, billing_http_1.validateEnv)(args.env);
+    const body = {};
+    if (args.refundWindowDays !== undefined)
+        body.refundWindowDays = args.refundWindowDays;
+    if (args.refundProrateMaxDays !== undefined)
+        body.refundProrateMaxDays = args.refundProrateMaxDays;
+    if (args.bundledPlanId !== undefined)
+        body.bundledPlanId = args.bundledPlanId;
+    if (args.bundledDurationDays !== undefined)
+        body.bundledDurationDays = args.bundledDurationDays;
+    if (args.revokeBundledOnRefund !== undefined)
+        body.revokeBundledOnRefund = args.revokeBundledOnRefund;
+    if (args.metadata !== undefined)
+        body.metadata = args.metadata;
+    if (Object.keys(body).length === 0)
+        throw new Error('At least one updatable field must be passed');
+    console.log(`\n✏️  Updating product ${args.key} on ${args.env.toUpperCase()}...`);
+    const res = await (0, billing_http_1.callBilling)(args.env, 'PATCH', `/api/billing/admin/products/${encodeURIComponent(args.key)}`, body);
+    console.log(`✓ Updated Product (HTTP ${res.status}):`);
+    console.log(JSON.stringify(res.body, null, 2));
+}

package/dist/bin/helpers/product.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const create_1 = require("./product/create");
+const update_1 = require("./product/update");
+const add_channel_1 = require("./product/add-channel");
+const toggle_channel_1 = require("./product/toggle-channel");
+const show_1 = require("./product/show");
+const SUBCOMMANDS = ['create', 'update', 'add-channel', 'toggle-channel', 'show'];
+function printHelp() {
+    console.log(`Usage: optima-product <subcommand> [options]
+
+Subcommands:
+  create           Create a Product bundling 1+ plugin slugs
+  update           Patch refund policy / metadata on an existing Product
+  add-channel      Attach a payment channel (Stripe Price ID) to a Product
+  toggle-channel   Enable/disable an existing channel
+  show             Show a Product's bare row (note: does NOT include plugins/channels)
+
+Run 'optima-product <subcommand> --help' for subcommand-specific options.`);
+}
+async function main() {
+    const [, , subcommand, ...rest] = process.argv;
+    if (!subcommand || subcommand === '-h' || subcommand === '--help') {
+        printHelp();
+        process.exit(0);
+    }
+    switch (subcommand) {
+        case 'create':
+            await (0, create_1.runCreate)(rest);
+            break;
+        case 'update':
+            await (0, update_1.runUpdate)(rest);
+            break;
+        case 'add-channel':
+            await (0, add_channel_1.runAddChannel)(rest);
+            break;
+        case 'toggle-channel':
+            await (0, toggle_channel_1.runToggleChannel)(rest);
+            break;
+        case 'show':
+            await (0, show_1.runShow)(rest);
+            break;
+        default:
+            console.error(`Unknown subcommand: ${subcommand}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+});