initial

startos/actions/suspendLicense.ts

@@ -0,0 +1,59 @@
+// Action: suspend an existing license (reversible).
+//
+// Unlike revoke (which is one-way), suspend temporarily blocks validation
+// and can be cleared with the "Unsuspend" action. Useful for payment
+// disputes where the outcome isn't yet known.
+
+import { sdk } from '../sdk'
+import { adminCall, LICENSING_URL } from '../utils'
+
+const input = sdk.InputSpec.of({
+  license_id: {
+    type: 'text',
+    name: 'License ID',
+    description: 'UUID of the license to suspend. Find via search-licenses action.',
+    required: true,
+    default: null,
+  },
+  reason: {
+    type: 'text',
+    name: 'Reason',
+    description: 'Stored for audit. E.g., "payment dispute pending".',
+    required: false,
+    default: null,
+  },
+})
+
+export const suspendLicense = sdk.Action.withInput(
+  'suspendLicense',
+  async ({ effects }) => ({
+    name: 'Suspend license',
+    description:
+      'Temporarily disable a license. Validation calls will fail with a ' +
+      '`suspended` status until you unsuspend. Use this for reversible ' +
+      'situations (e.g., payment disputes) instead of revoke.',
+    warning:
+      'Suspension takes effect on the next online validation. Clients with ' +
+      'cached results may continue running until their cache expires.',
+    allowedStatuses: 'only-running',
+    group: 'Licenses',
+    visibility: 'enabled',
+  }),
+  input,
+  async ({ effects, input: formInput }) => {
+    const store = await sdk.store.getOwn(effects, sdk.StorePath).const()
+    const resp = await adminCall(
+      LICENSING_URL,
+      store.admin_api_key,
+      `/v1/admin/licenses/${encodeURIComponent(formInput.license_id)}/suspend`,
+      {
+        method: 'POST',
+        body: JSON.stringify({ reason: formInput.reason ?? 'admin suspend' }),
+      },
+    )
+    if (!resp.ok) {
+      throw new Error(`Suspend failed: HTTP ${resp.status} — ${await resp.text()}`)
+    }
+    return { message: `Suspended license ${formInput.license_id}.` }
+  },
+)