add force option

Author: tarqd

TESTING.md

@@ -86,6 +86,7 @@ jobs:
           access-token: ${{ secrets.LAUNCHDARKLY_TOKEN }}
           repo: ${{ github.repository }}
           branch: ${{ github.ref_name }}
+          force: true  # Optional: force delete even on non-branch events
 ```
 
 ## 4. API Testing
@@ -99,7 +100,25 @@ curl -X POST https://app.launchdarkly.com/api/v2/code-refs/repositories/your-rep
      -d '["branch-to-delete"]'
 ```
 
-## 5. Test Scenarios
+## 5. Force Option
+
+The `force` option allows you to delete LaunchDarkly branches even when the GitHub event is not a branch delete event:
+
+- **Default behavior**: Only runs on branch delete events (`ref_type: "branch"`)
+- **With `force: true`**: Runs on any delete event (tags, branches, etc.)
+- **Use case**: Useful for cleanup workflows or manual branch deletion
+
+Example:
+```yaml
+- name: Force Delete Branch
+  uses: ./ 
+  with:
+    access-token: ${{ secrets.LAUNCHDARKLY_TOKEN }}
+    branch: "feature-branch"
+    force: true
+```
+
+## 6. Test Scenarios
 
 The test suite covers:
 
@@ -121,7 +140,7 @@ The test suite covers:
 - Network timeouts
 - Exponential backoff
 
-## 6. Debugging
+## 7. Debugging
 
 ### Enable Debug Logging
 
@@ -140,7 +159,7 @@ The action logs detailed information about:
 - Error messages
 - Retry attempts
 
-## 7. Continuous Integration
+## 8. Continuous Integration
 
 The action includes:
 - **Linting** with ESLint

__tests__/integration.test.ts

@@ -1,7 +1,7 @@
 import * as core from '@actions/core';
 import * as github from '@actions/github';
 import nock from 'nock';
-import { deleteBranch } from '../src/index';
+import { deleteBranch, run } from '../src/index';
 
 // Mock the modules
 jest.mock('@actions/core');
@@ -63,4 +63,122 @@ describe('GitHub Action Integration', () => {
 
     expect(scope.isDone()).toBe(true);
   });
+});
+
+describe('run function', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    nock.cleanAll();
+    
+    // Reset environment
+    delete process.env.GITHUB_REPOSITORY;
+    delete process.env.NODE_ENV;
+    
+    // Mock core.getInput
+    (core.getInput as jest.Mock).mockImplementation((name: string) => {
+      const inputs: Record<string, string> = {
+        'access-token': 'test-token',
+        'repo': 'test-repo',
+        'branch': 'test-branch',
+        'base-uri': 'https://app.launchdarkly.com',
+        'force': 'false'
+      };
+      return inputs[name] || '';
+    });
+    
+    // Mock core.getBooleanInput
+    (core.getBooleanInput as jest.Mock).mockImplementation((name: string) => {
+      const inputs: Record<string, boolean> = {
+        'force': false
+      };
+      return inputs[name] || false;
+    });
+    
+    // Mock github context
+    (github.context as any) = {
+      eventName: 'delete',
+      payload: {
+        ref_type: 'branch',
+        ref: 'test-branch',
+        repository: {
+          name: 'test-repo'
+        }
+      }
+    };
+  });
+
+  afterEach(() => {
+    nock.cleanAll();
+  });
+
+  it('should skip non-branch delete events by default', async () => {
+    (github.context as any).payload.ref_type = 'tag';
+    
+    await run();
+    
+    expect(core.info).toHaveBeenCalledWith('Skipping non-branch delete event (ref_type=tag). Use force: true to override.');
+    expect(core.setFailed).not.toHaveBeenCalled();
+  });
+
+  it('should proceed with non-branch delete events when force-delete is true', async () => {
+    (github.context as any).payload.ref_type = 'tag';
+    (core.getBooleanInput as jest.Mock).mockReturnValue(true);
+    
+    const scope = nock('https://app.launchdarkly.com')
+      .post('/api/v2/code-refs/repositories/test-repo/branch-delete-tasks')
+      .reply(200, { success: true });
+
+    await run();
+    
+    expect(core.info).toHaveBeenCalledWith("Deleting LaunchDarkly Code Refs branch 'test-branch' in repo 'test-repo'...");
+    expect(core.info).toHaveBeenCalledWith('✅ LaunchDarkly Code Refs branch delete queued successfully.');
+    expect(scope.isDone()).toBe(true);
+  });
+
+  it('should proceed with branch delete events normally', async () => {
+    (github.context as any).payload.ref_type = 'branch';
+    
+    const scope = nock('https://app.launchdarkly.com')
+      .post('/api/v2/code-refs/repositories/test-repo/branch-delete-tasks')
+      .reply(200, { success: true });
+
+    await run();
+    
+    expect(core.info).toHaveBeenCalledWith("Deleting LaunchDarkly Code Refs branch 'test-branch' in repo 'test-repo'...");
+    expect(core.info).toHaveBeenCalledWith('✅ LaunchDarkly Code Refs branch delete queued successfully.');
+    expect(scope.isDone()).toBe(true);
+  });
+
+  it('should handle missing repository key', async () => {
+    (core.getInput as jest.Mock).mockImplementation((name: string) => {
+      const inputs: Record<string, string> = {
+        'access-token': 'test-token',
+        'branch': 'test-branch'
+      };
+      return inputs[name] || '';
+    });
+    
+    (github.context as any).payload.repository = null;
+    delete process.env.GITHUB_REPOSITORY;
+
+    await run();
+    
+    expect(core.setFailed).toHaveBeenCalledWith('Action failed: Repository key not found');
+  });
+
+  it('should handle missing branch ref', async () => {
+    (core.getInput as jest.Mock).mockImplementation((name: string) => {
+      const inputs: Record<string, string> = {
+        'access-token': 'test-token',
+        'repo': 'test-repo'
+      };
+      return inputs[name] || '';
+    });
+    
+    (github.context as any).payload.ref = null;
+
+    await run();
+    
+    expect(core.setFailed).toHaveBeenCalledWith('Action failed: Branch ref not found');
+  });
 });

action.yml

@@ -19,6 +19,10 @@ inputs:
     description: 'LaunchDarkly base URI (defaults to https://app.launchdarkly.com)'
     required: false
     default: 'https://app.launchdarkly.com'
+  force:
+    description: 'Force delete even when not triggered by a branch delete event (defaults to false)'
+    required: false
+    default: 'false'
 
 runs:
   using: 'node20'

src/index.ts

@@ -84,6 +84,7 @@ export async function run() {
   try {
     const token = core.getInput("access-token", { required: true });
     const baseUri = core.getInput("base-uri") || "https://app.launchdarkly.com";
+    const forceDelete = core.getBooleanInput("force");
     const ghRepoName =
       github.context?.payload?.repository?.name || process.env.GITHUB_REPOSITORY?.split("/")?.[1];
     const repoKey = core.getInput("repo") || ghRepoName;
@@ -94,8 +95,8 @@ export async function run() {
 
     if (!repoKey) throw new Error("Repository key not found");
     if (!ref) throw new Error("Branch ref not found");
-    if (github.context.eventName === "delete" && refType && refType !== "branch") {
-      core.info(`Skipping non-branch delete event (ref_type=${refType})`);
+    if (github.context.eventName === "delete" && refType && refType !== "branch" && !forceDelete) {
+      core.info(`Skipping non-branch delete event (ref_type=${refType}). Use force: true to override.`);
       return;
     }