initial

2026-04-22 17:46:43 -05:00
commit 432250bffc
41 changed files with 2223 additions and 0 deletions
@@ -0,0 +1,148 @@
+// Action: create a license policy (reusable template) for a product.
+//
+// Policies let the operator capture "when someone buys this product, issue a
+// license with these defaults" (duration, grace period, entitlements, seat
+// cap, trial flag). A policy slugged `default` is used automatically by the
+// normal purchase flow.
+
+import { sdk } from '../sdk'
+import { adminCall, LICENSING_URL } from '../utils'
+
+const input = sdk.InputSpec.of({
+  product_slug: {
+    type: 'text',
+    name: 'Product slug',
+    description: 'The product this policy applies to.',
+    required: true,
+    default: null,
+  },
+  slug: {
+    type: 'text',
+    name: 'Policy slug',
+    description:
+      'URL-safe name, e.g., "default", "annual", "trial". ' +
+      'Use "default" for the one consumed by the public purchase flow.',
+    required: true,
+    default: null,
+    patterns: [{ regex: '^[a-z0-9-]{2,40}$', description: 'lowercase letters, digits, and dashes' }],
+  },
+  name: {
+    type: 'text',
+    name: 'Display name',
+    description: 'Shown in admin listings. E.g., "Annual subscription".',
+    required: true,
+    default: null,
+  },
+  duration_seconds: {
+    type: 'number',
+    name: 'Duration (seconds)',
+    description: '0 = perpetual. 31536000 = one year. 7776000 = 90 days.',
+    required: true,
+    default: 0,
+    min: 0,
+    max: null,
+    integer: true,
+  },
+  grace_seconds: {
+    type: 'number',
+    name: 'Grace period (seconds)',
+    description:
+      'After expiry, how long a cached validation remains honoured ' +
+      'before the client must reach the server again. 0 = no grace.',
+    required: true,
+    default: 0,
+    min: 0,
+    max: null,
+    integer: true,
+  },
+  max_machines: {
+    type: 'number',
+    name: 'Max machines',
+    description: '0 = unlimited, 1 = single-seat, n>1 = multi-seat cap.',
+    required: true,
+    default: 1,
+    min: 0,
+    max: null,
+    integer: true,
+  },
+  is_trial: {
+    type: 'toggle',
+    name: 'Trial policy',
+    description: 'Mark issued keys as trial (sets the TRIAL flag in the payload).',
+    default: false,
+  },
+  entitlements: {
+    type: 'text',
+    name: 'Entitlements',
+    description:
+      'Comma-separated list of feature slugs embedded in the license key. ' +
+      'E.g., "pro,multi-device". Leave blank for none.',
+    required: false,
+    default: null,
+  },
+  price_sats_override: {
+    type: 'number',
+    name: 'Price override (sats, optional)',
+    description:
+      "Override the product's default price for licenses issued under this " +
+      'policy. Leave at -1 to use the product price.',
+    required: true,
+    default: -1,
+    min: -1,
+    max: null,
+    integer: true,
+  },
+})
+
+export const createPolicy = sdk.Action.withInput(
+  'createPolicy',
+  async ({ effects }) => ({
+    name: 'Create policy',
+    description:
+      'Add a reusable license template to a product. The public purchase ' +
+      'flow picks up the policy slugged "default"; other policies are used ' +
+      'by the admin "Issue license manually" action.',
+    warning: null,
+    allowedStatuses: 'only-running',
+    group: 'Policies',
+    visibility: 'enabled',
+  }),
+  input,
+  async ({ effects, input: formInput }) => {
+    const store = await sdk.store.getOwn(effects, sdk.StorePath).const()
+    const entitlements = (formInput.entitlements ?? '')
+      .split(',')
+      .map((s) => s.trim())
+      .filter((s) => s.length > 0)
+    const body: Record<string, unknown> = {
+      product_slug: formInput.product_slug,
+      name: formInput.name,
+      slug: formInput.slug,
+      duration_seconds: formInput.duration_seconds,
+      grace_seconds: formInput.grace_seconds,
+      max_machines: formInput.max_machines,
+      is_trial: formInput.is_trial,
+      entitlements,
+      metadata: {},
+    }
+    if (formInput.price_sats_override >= 0) {
+      body.price_sats_override = formInput.price_sats_override
+    }
+
+    const resp = await adminCall(LICENSING_URL, store.admin_api_key, '/v1/admin/policies', {
+      method: 'POST',
+      body: JSON.stringify(body),
+    })
+    if (!resp.ok) {
+      throw new Error(`Create policy failed: HTTP ${resp.status} — ${await resp.text()}`)
+    }
+    const policy = (await resp.json()) as { id: string; slug: string; name: string }
+    return {
+      message:
+        `Created policy '${policy.slug}' (id ${policy.id}).\n` +
+        (formInput.slug === 'default'
+          ? 'Because the slug is "default", this policy will be used by the public purchase flow.'
+          : 'Use this slug when calling "Issue license manually".'),
+    }
+  },
+)