declastruct-github 1.0.0

package/dist/domain.operations/branch/getBranches.integration.test.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_fns_1 = require("test-fns");
+const getSampleGithubContext_1 = require("../../.test/assets/getSampleGithubContext");
+const getSampleRepo_1 = require("../../.test/assets/getSampleRepo");
+const getBranches_1 = require("./getBranches");
+const log = console;
+describe('getBranches', () => {
+    const context = { log, ...(0, getSampleGithubContext_1.getSampleGithubContext)() };
+    (0, test_fns_1.given)('a live example repo with branches', () => {
+        (0, test_fns_1.then)('we should be able to list its branches', async () => {
+            const sampleRepo = (0, getSampleRepo_1.getSampleRepo)({
+                owner: 'ehmpathy',
+                name: 'declastruct-github-demo',
+            });
+            const branches = await (0, getBranches_1.getBranches)({
+                where: {
+                    repo: {
+                        owner: sampleRepo.owner,
+                        name: sampleRepo.name,
+                    },
+                },
+            }, context);
+            console.log(branches);
+            expect(branches).toBeDefined();
+            expect(Array.isArray(branches)).toBe(true);
+            expect(branches.length).toBeGreaterThan(0);
+            // verify first branch has expected shape
+            const firstBranch = branches[0];
+            expect(firstBranch?.name).toBeDefined();
+            expect(firstBranch?.commit?.sha).toBeDefined();
+            expect(firstBranch?.repo).toEqual({
+                owner: sampleRepo.owner,
+                name: sampleRepo.name,
+            });
+            expect(typeof firstBranch?.protected).toBe('boolean');
+        });
+    });
+});
+//# sourceMappingURL=getBranches.integration.test.js.map

package/dist/domain.operations/branch/getBranches.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBranches.integration.test.js","sourceRoot":"","sources":["../../../src/domain.operations/branch/getBranches.integration.test.ts"],"names":[],"mappings":";;AAAA,uCAAuC;AAEvC,sFAAmF;AACnF,oEAAiE;AACjE,+CAA4C;AAE5C,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAA,+CAAsB,GAAE,EAAE,CAAC;IAErD,IAAA,gBAAK,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC9C,IAAA,eAAI,EAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;gBAC/B,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,yBAAyB;aAChC,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAW,EAChC;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE;wBACJ,KAAK,EAAE,UAAU,CAAC,KAAK;wBACvB,IAAI,EAAE,UAAU,CAAC,IAAI;qBACtB;iBACF;aACF,EACD,OAAO,CACR,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAE3C,yCAAyC;YACzC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC/C,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC;gBAChC,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,IAAI,EAAE,UAAU,CAAC,IAAI;aACtB,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,WAAW,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/domain.operations/branch/getBranches.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBranches = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const getGithubClient_1 = require("../../access/sdks/getGithubClient");
+const castToDeclaredGithubBranch_1 = require("./castToDeclaredGithubBranch");
+/**
+ * .what = lists GitHub branches for a repository
+ * .why = retrieves multiple branches from GitHub API for declarative management
+ */
+const getBranches = async (input, context) => {
+    // get cached GitHub client
+    const github = (0, getGithubClient_1.getGithubClient)({}, context);
+    // execute the GitHub API call
+    try {
+        const response = await github.repos.listBranches({
+            owner: input.where.repo.owner,
+            repo: input.where.repo.name,
+            page: input.page?.range?.until.page,
+            per_page: input.page?.limit,
+        });
+        const branches = response.data ?? [];
+        return branches.map((branch) => (0, castToDeclaredGithubBranch_1.castToDeclaredGithubBranch)({ branch, repo: input.where.repo }));
+    }
+    catch (error) {
+        if (!(error instanceof Error))
+            throw error;
+        // throw helpful error for all failures
+        throw new helpful_errors_1.HelpfulError('github.getBranches error', { cause: error });
+    }
+};
+exports.getBranches = getBranches;
+//# sourceMappingURL=getBranches.js.map

package/dist/domain.operations/branch/getBranches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBranches.js","sourceRoot":"","sources":["../../../src/domain.operations/branch/getBranches.ts"],"names":[],"mappings":";;;AACA,mDAA8C;AAI9C,uEAAoE;AAIpE,6EAA0E;AAE1E;;;GAGG;AACI,MAAM,WAAW,GAAG,KAAK,EAC9B,KAQC,EACD,OAA6C,EACC,EAAE;IAChD,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAA,iCAAe,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE5C,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;YAC/C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;YAC7B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI;YACnC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK;SAC5B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7B,IAAA,uDAA0B,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAC/D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QAE3C,uCAAuC;QACvC,MAAM,IAAI,6BAAY,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC,CAAC;AAlCW,QAAA,WAAW,eAkCtB"}

package/dist/domain.operations/branch/setBranch.d.ts

@@ -0,0 +1,12 @@
+import { HasMetadata, PickOne } from 'type-fns';
+import { VisualogicContext } from 'visualogic';
+import { ContextGithubApi } from '../../domain.objects/ContextGithubApi';
+import { DeclaredGithubBranch } from '../../domain.objects/DeclaredGithubBranch';
+/**
+ * .what = sets a GitHub branch: upsert or finsert
+ * .why = enables declarative creation and updates of branches following declastruct patterns
+ */
+export declare const setBranch: (input: PickOne<{
+    finsert: DeclaredGithubBranch;
+    upsert: DeclaredGithubBranch;
+}>, context: ContextGithubApi & VisualogicContext) => Promise<HasMetadata<DeclaredGithubBranch>>;

package/dist/domain.operations/branch/setBranch.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain.operations/branch/setBranch.integration.test.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const getSampleGithubContext_1 = require("../../.test/assets/getSampleGithubContext");
+const getSampleRepo_1 = require("../../.test/assets/getSampleRepo");
+const getBranch_1 = require("./getBranch");
+const setBranch_1 = require("./setBranch");
+const log = console;
+describe('setBranch', () => {
+    const context = { log, ...(0, getSampleGithubContext_1.getSampleGithubContext)() };
+    describe('live tests', () => {
+        it('should create a new branch with explicit commit.sha', async () => {
+            const sampleRepo = (0, getSampleRepo_1.getSampleRepo)({
+                owner: 'ehmpathy',
+                name: 'declastruct-github-demo',
+            });
+            // Get a commit SHA from the demo repo's main branch
+            const demoRepoBranch = (await (0, getBranch_1.getBranch)({
+                by: {
+                    unique: {
+                        repo: { owner: 'ehmpathy', name: 'declastruct-github-demo' },
+                        name: 'main',
+                    },
+                },
+            }, context)) ??
+                helpful_errors_1.UnexpectedCodePathError.throw('demo repo branch not found', {
+                    sampleRepo,
+                });
+            const branchName = `test-branch-${Date.now()}`;
+            const result = await (0, setBranch_1.setBranch)({
+                finsert: {
+                    repo: {
+                        owner: sampleRepo.owner,
+                        name: sampleRepo.name,
+                    },
+                    name: branchName,
+                    commit: { sha: demoRepoBranch.commit.sha },
+                },
+            }, context);
+            expect(result).toBeDefined();
+            expect(result.name).toBe(branchName);
+            expect(result.commit?.sha).toBe(demoRepoBranch.commit.sha);
+        });
+        it('should return existing branch for finsert', async () => {
+            // Use the main declastruct-github repo which we know exists
+            const sampleRepo = (0, getSampleRepo_1.getSampleRepo)({
+                owner: 'ehmpathy',
+                name: 'declastruct-github',
+            });
+            const result = await (0, setBranch_1.setBranch)({
+                finsert: {
+                    repo: {
+                        owner: sampleRepo.owner,
+                        name: sampleRepo.name,
+                    },
+                    name: 'main',
+                },
+            }, context);
+            expect(result).toBeDefined();
+            expect(result.name).toBe('main');
+            expect(result.commit?.sha).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=setBranch.integration.test.js.map

package/dist/domain.operations/branch/setBranch.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setBranch.integration.test.js","sourceRoot":"","sources":["../../../src/domain.operations/branch/setBranch.integration.test.ts"],"names":[],"mappings":";;AAAA,mDAAyD;AAEzD,sFAAmF;AACnF,oEAAiE;AACjE,2CAAwC;AACxC,2CAAwC;AAExC,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAA,+CAAsB,GAAE,EAAE,CAAC;IAErD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;gBAC/B,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,yBAAyB;aAChC,CAAC,CAAC;YAEH,oDAAoD;YACpD,MAAM,cAAc,GAClB,CAAC,MAAM,IAAA,qBAAS,EACd;gBACE,EAAE,EAAE;oBACF,MAAM,EAAE;wBACN,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,yBAAyB,EAAE;wBAC5D,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,EACD,OAAO,CACR,CAAC;gBACF,wCAAuB,CAAC,KAAK,CAAC,4BAA4B,EAAE;oBAC1D,UAAU;iBACX,CAAC,CAAC;YAEL,MAAM,UAAU,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAE/C,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAS,EAC5B;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE;wBACJ,KAAK,EAAE,UAAU,CAAC,KAAK;wBACvB,IAAI,EAAE,UAAU,CAAC,IAAI;qBACtB;oBACD,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,CAAC,MAAO,CAAC,GAAG,EAAE;iBAC5C;aACF,EACD,OAAO,CACR,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,MAAO,CAAC,GAAG,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,4DAA4D;YAC5D,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;gBAC/B,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,oBAAoB;aAC3B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAS,EAC5B;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE;wBACJ,KAAK,EAAE,UAAU,CAAC,KAAK;wBACvB,IAAI,EAAE,UAAU,CAAC,IAAI;qBACtB;oBACD,IAAI,EAAE,MAAM;iBACb;aACF,EACD,OAAO,CACR,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/domain.operations/branch/setBranch.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setBranch = void 0;
+const as_procedure_1 = require("as-procedure");
+const helpful_errors_1 = require("helpful-errors");
+const getGithubClient_1 = require("../../access/sdks/getGithubClient");
+const getBranch_1 = require("./getBranch");
+const getBranchCommitShaByRepoDefault_1 = require("./getBranchCommitShaByRepoDefault");
+/**
+ * .what = sets a GitHub branch: upsert or finsert
+ * .why = enables declarative creation and updates of branches following declastruct patterns
+ */
+exports.setBranch = (0, as_procedure_1.asProcedure)(async (input, context) => {
+    const desired = input.finsert ?? input.upsert;
+    // get cached GitHub client
+    const github = (0, getGithubClient_1.getGithubClient)({}, context);
+    // check whether branch already exists
+    const before = await (0, getBranch_1.getBranch)({
+        by: {
+            unique: {
+                repo: desired.repo,
+                name: desired.name,
+            },
+        },
+    }, context);
+    // if it's a finsert and had a before, then return that
+    if (before && input.finsert)
+        return before;
+    // if its an upsert and had a before but no commit.sha change, return existing
+    if (before && input.upsert && !desired.commit?.sha)
+        return before;
+    if (before && input.upsert && desired.commit?.sha === before.commit?.sha)
+        return before;
+    // if its an upsert with a commit.sha change, update the branch
+    if (before && input.upsert && desired.commit?.sha) {
+        try {
+            await github.git.updateRef({
+                owner: desired.repo.owner,
+                repo: desired.repo.name,
+                ref: `heads/${desired.name}`,
+                sha: desired.commit.sha,
+                force: false, // don't force update - fail if not fast-forward
+            });
+            // fetch the updated branch to return full metadata
+            return ((await (0, getBranch_1.getBranch)({
+                by: {
+                    unique: {
+                        repo: desired.repo,
+                        name: desired.name,
+                    },
+                },
+            }, context)) ??
+                helpful_errors_1.UnexpectedCodePathError.throw('updated branch not found', {
+                    name: desired.name,
+                }));
+        }
+        catch (error) {
+            if (!(error instanceof Error))
+                throw error;
+            throw new helpful_errors_1.HelpfulError('github.setBranch.update error', {
+                cause: error,
+            });
+        }
+    }
+    // otherwise, create it
+    try {
+        // determine commit SHA to create branch from
+        const commitSha = desired.commit?.sha ??
+            (await (0, getBranchCommitShaByRepoDefault_1.getBranchCommitShaByRepoDefault)({
+                repo: desired.repo,
+            }, context));
+        // create the branch using git refs API
+        await github.git.createRef({
+            owner: desired.repo.owner,
+            repo: desired.repo.name,
+            ref: `refs/heads/${desired.name}`,
+            sha: commitSha,
+        });
+        // fetch the created branch to return full metadata
+        return ((await (0, getBranch_1.getBranch)({
+            by: {
+                unique: {
+                    repo: desired.repo,
+                    name: desired.name,
+                },
+            },
+        }, context)) ??
+            helpful_errors_1.UnexpectedCodePathError.throw('created branch not found', {
+                name: desired.name,
+            }));
+    }
+    catch (error) {
+        if (!(error instanceof Error))
+            throw error;
+        throw new helpful_errors_1.HelpfulError('github.setBranch.create error', {
+            cause: error,
+        });
+    }
+});
+//# sourceMappingURL=setBranch.js.map

package/dist/domain.operations/branch/setBranch.js.map

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

package/dist/domain.operations/branch/setBranch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain.operations/branch/setBranch.test.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const getBranchModule = __importStar(require("./getBranch"));
+const setBranch_1 = require("./setBranch");
+jest.mock('@octokit/rest', () => ({
+    Octokit: jest.fn(),
+}));
+jest.mock('./getBranch');
+const mockCreateRef = jest.fn();
+const mockGet = jest.fn();
+const { Octokit } = jest.requireMock('@octokit/rest');
+Octokit.mockImplementation(() => ({
+    git: {
+        createRef: mockCreateRef,
+    },
+    repos: {
+        get: mockGet,
+    },
+}));
+const context = {
+    github: { token: 'test-token' },
+    log: console,
+};
+const branchSample = {
+    repo: {
+        owner: 'test-owner',
+        name: 'test-repo',
+    },
+    name: 'test-branch',
+    commit: { sha: 'abc123' },
+};
+describe('setBranch', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it('returns early for finsert if branch already exists (before)', async () => {
+        const before = {
+            ...branchSample,
+            commit: { sha: 'abc123' },
+            protected: false,
+        };
+        getBranchModule.getBranch.mockResolvedValue(before);
+        const result = await (0, setBranch_1.setBranch)({ finsert: branchSample }, context);
+        expect(result).toBe(before);
+        expect(getBranchModule.getBranch).toHaveBeenCalled();
+        expect(mockCreateRef).not.toHaveBeenCalled();
+    });
+    it('returns existing for upsert if branch exists and no commit.sha change', async () => {
+        const before = {
+            ...branchSample,
+            commit: { sha: 'abc123' },
+            protected: false,
+        };
+        getBranchModule.getBranch.mockResolvedValue(before);
+        const result = await (0, setBranch_1.setBranch)({ upsert: branchSample }, context);
+        expect(result).toBe(before);
+        expect(getBranchModule.getBranch).toHaveBeenCalled();
+        expect(mockCreateRef).not.toHaveBeenCalled();
+    });
+    it('creates branch with specified commit.sha', async () => {
+        const branchWithCommit = {
+            ...branchSample,
+            commit: { sha: 'specifiedSha123' },
+        };
+        // first getBranch call returns null (branch doesn't exist)
+        // second getBranch call returns created branch
+        getBranchModule.getBranch
+            .mockResolvedValueOnce(null)
+            .mockResolvedValueOnce({
+            ...branchSample,
+            commit: { sha: 'specifiedSha123' },
+            protected: false,
+        });
+        mockCreateRef.mockResolvedValue({ data: {} });
+        const result = await (0, setBranch_1.setBranch)({ finsert: branchWithCommit }, context);
+        expect(mockCreateRef).toHaveBeenCalledWith({
+            owner: 'test-owner',
+            repo: 'test-repo',
+            ref: 'refs/heads/test-branch',
+            sha: 'specifiedSha123',
+        });
+        expect(result.commit?.sha).toBe('specifiedSha123');
+    });
+    it('creates branch from default branch if commit.sha not specified', async () => {
+        const branchWithoutCommit = {
+            repo: {
+                owner: 'test-owner',
+                name: 'test-repo',
+            },
+            name: 'test-branch',
+        };
+        // first getBranch call returns null (branch doesn't exist)
+        // second getBranch call returns default branch
+        // third getBranch call returns created branch
+        getBranchModule.getBranch
+            .mockResolvedValueOnce(null)
+            .mockResolvedValueOnce({
+            ...branchSample,
+            name: 'main',
+            commit: { sha: 'defaultSha456' },
+            protected: false,
+        })
+            .mockResolvedValueOnce({
+            ...branchSample,
+            commit: { sha: 'defaultSha456' },
+            protected: false,
+        });
+        mockGet.mockResolvedValue({
+            data: {
+                default_branch: 'main',
+            },
+        });
+        mockCreateRef.mockResolvedValue({ data: {} });
+        const result = await (0, setBranch_1.setBranch)({ finsert: branchWithoutCommit }, context);
+        expect(mockGet).toHaveBeenCalledWith({
+            owner: 'test-owner',
+            repo: 'test-repo',
+        });
+        expect(mockCreateRef).toHaveBeenCalledWith({
+            owner: 'test-owner',
+            repo: 'test-repo',
+            ref: 'refs/heads/test-branch',
+            sha: 'defaultSha456',
+        });
+        expect(result.commit?.sha).toBe('defaultSha456');
+    });
+});
+//# sourceMappingURL=setBranch.test.js.map

package/dist/domain.operations/branch/setBranch.test.js.map

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

package/dist/domain.operations/branchProtection/castToDeclaredGithubBranchProtection.d.ts

@@ -0,0 +1,14 @@
+import { Endpoints } from '@octokit/types';
+import { RefByUnique } from 'domain-objects';
+import { HasMetadata } from 'type-fns';
+import { DeclaredGithubBranch } from '../../domain.objects/DeclaredGithubBranch';
+import { DeclaredGithubBranchProtection } from '../../domain.objects/DeclaredGithubBranchProtection';
+export type GithubBranchProtectionResponse = Endpoints['GET /repos/{owner}/{repo}/branches/{branch}/protection']['response']['data'];
+/**
+ * .what = casts GitHub API branch protection response to DeclaredGithubBranchProtection
+ * .why = transforms external API shape to our branch protection domain model with type safety and validation
+ */
+export declare const castToDeclaredGithubBranchProtection: (input: {
+    response: GithubBranchProtectionResponse;
+    branch: RefByUnique<typeof DeclaredGithubBranch>;
+}) => HasMetadata<DeclaredGithubBranchProtection>;

package/dist/domain.operations/branchProtection/castToDeclaredGithubBranchProtection.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castToDeclaredGithubBranchProtection = void 0;
+const domain_objects_1 = require("domain-objects");
+const DeclaredGithubBranch_1 = require("../../domain.objects/DeclaredGithubBranch");
+const DeclaredGithubBranchProtection_1 = require("../../domain.objects/DeclaredGithubBranchProtection");
+/**
+ * .what = casts GitHub API branch protection response to DeclaredGithubBranchProtection
+ * .why = transforms external API shape to our branch protection domain model with type safety and validation
+ */
+const castToDeclaredGithubBranchProtection = (input) => {
+    return DeclaredGithubBranchProtection_1.DeclaredGithubBranchProtection.as({
+        branch: input.branch instanceof DeclaredGithubBranch_1.DeclaredGithubBranch
+            ? (0, domain_objects_1.refByUnique)(input.branch)
+            : input.branch,
+        enforceAdmins: input.response.enforce_admins?.enabled,
+        allowsDeletions: input.response.allow_deletions?.enabled,
+        allowsForcePushes: input.response.allow_force_pushes?.enabled,
+        requireLinearHistory: input.response.required_linear_history?.enabled,
+        blockCreations: input.response.block_creations?.enabled,
+        lockBranch: input.response.lock_branch?.enabled,
+        allowForkSyncing: input.response.allow_fork_syncing?.enabled,
+        requiredStatusChecks: input.response.required_status_checks
+            ? {
+                strict: input.response.required_status_checks.strict ?? false,
+                contexts: input.response.required_status_checks.contexts ?? [],
+            }
+            : null,
+        requiredPullRequestReviews: input.response.required_pull_request_reviews
+            ? {
+                dismissStaleReviews: input.response.required_pull_request_reviews.dismiss_stale_reviews,
+                requireCodeOwnerReviews: input.response.required_pull_request_reviews
+                    .require_code_owner_reviews,
+                requiredApprovingReviewCount: input.response.required_pull_request_reviews
+                    .required_approving_review_count,
+                dismissalRestrictions: input.response.required_pull_request_reviews
+                    .dismissal_restrictions
+                    ? {
+                        users: input.response.required_pull_request_reviews.dismissal_restrictions.users?.map((u) => u.login) ?? [],
+                        teams: input.response.required_pull_request_reviews.dismissal_restrictions.teams?.map((t) => t.slug) ?? [],
+                        apps: input.response.required_pull_request_reviews.dismissal_restrictions.apps
+                            ?.map((a) => a?.slug)
+                            .filter((s) => !!s) ?? [],
+                    }
+                    : undefined,
+            }
+            : null,
+        restrictions: input.response.restrictions
+            ? {
+                users: input.response.restrictions.users
+                    ?.map((u) => u.login)
+                    .filter((l) => !!l) ?? [],
+                teams: input.response.restrictions.teams
+                    ?.map((t) => t.slug)
+                    .filter((s) => !!s) ?? [],
+                apps: input.response.restrictions.apps
+                    ?.map((a) => a?.slug)
+                    .filter((s) => !!s) ?? [],
+            }
+            : null,
+        requiredSignatures: input.response.required_signatures?.enabled,
+        requiredConversationResolution: input.response.required_conversation_resolution?.enabled,
+    });
+};
+exports.castToDeclaredGithubBranchProtection = castToDeclaredGithubBranchProtection;
+//# sourceMappingURL=castToDeclaredGithubBranchProtection.js.map

package/dist/domain.operations/branchProtection/castToDeclaredGithubBranchProtection.js.map

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

package/dist/domain.operations/branchProtection/getBranchProtection.d.ts

@@ -0,0 +1,14 @@
+import { RefByUnique } from 'domain-objects';
+import { HasMetadata, PickOne } from 'type-fns';
+import { VisualogicContext } from 'visualogic';
+import { ContextGithubApi } from '../../domain.objects/ContextGithubApi';
+import { DeclaredGithubBranchProtection } from '../../domain.objects/DeclaredGithubBranchProtection';
+/**
+ * .what = gets a GitHub branch's protection rules
+ * .why = retrieves current protection state from GitHub API for declarative management
+ */
+export declare const getBranchProtection: (input: {
+    by: PickOne<{
+        unique: RefByUnique<typeof DeclaredGithubBranchProtection>;
+    }>;
+}, context: ContextGithubApi & VisualogicContext) => Promise<HasMetadata<DeclaredGithubBranchProtection> | null>;

package/dist/domain.operations/branchProtection/getBranchProtection.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain.operations/branchProtection/getBranchProtection.integration.test.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_fns_1 = require("test-fns");
+const getSampleGithubContext_1 = require("../../.test/assets/getSampleGithubContext");
+const getSampleRepo_1 = require("../../.test/assets/getSampleRepo");
+const getBranchProtection_1 = require("./getBranchProtection");
+const log = console;
+describe('getBranchProtection', () => {
+    const context = { log, ...(0, getSampleGithubContext_1.getSampleGithubContext)() };
+    (0, test_fns_1.given)('a protected branch exists', () => {
+        (0, test_fns_1.then)('we should be able to get its protection rules', async () => {
+            const sampleRepo = (0, getSampleRepo_1.getSampleRepo)({
+                owner: 'ehmpathy',
+                name: 'declastruct-github-demo',
+            });
+            const protection = await (0, getBranchProtection_1.getBranchProtection)({
+                by: {
+                    unique: {
+                        branch: {
+                            repo: {
+                                owner: sampleRepo.owner,
+                                name: sampleRepo.name,
+                            },
+                            name: 'main',
+                        },
+                    },
+                },
+            }, context);
+            console.log(protection);
+            // May be null if branch has no protection
+            if (protection) {
+                expect(protection.branch.repo.owner).toBe(sampleRepo.owner);
+                expect(protection.branch.repo.name).toBe(sampleRepo.name);
+                expect(protection.branch.name).toBe('main');
+            }
+        });
+    });
+    (0, test_fns_1.given)('an unprotected branch', () => {
+        (0, test_fns_1.then)('it should return null', async () => {
+            const sampleRepo = (0, getSampleRepo_1.getSampleRepo)({
+                owner: 'ehmpathy',
+                name: 'declastruct-github-demo',
+            });
+            // Try to get protection for a branch that likely doesn't have protection
+            const protection = await (0, getBranchProtection_1.getBranchProtection)({
+                by: {
+                    unique: {
+                        branch: {
+                            repo: {
+                                owner: sampleRepo.owner,
+                                name: sampleRepo.name,
+                            },
+                            name: 'test-branch-unprotected-99999',
+                        },
+                    },
+                },
+            }, context);
+            // Should return null for non-existent branch or unprotected branch
+            expect(protection).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=getBranchProtection.integration.test.js.map

package/dist/domain.operations/branchProtection/getBranchProtection.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBranchProtection.integration.test.js","sourceRoot":"","sources":["../../../src/domain.operations/branchProtection/getBranchProtection.integration.test.ts"],"names":[],"mappings":";;AAAA,uCAAuC;AAEvC,sFAAmF;AACnF,oEAAiE;AACjE,+DAA4D;AAE5D,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAA,+CAAsB,GAAE,EAAE,CAAC;IAErD,IAAA,gBAAK,EAAC,2BAA2B,EAAE,GAAG,EAAE;QACtC,IAAA,eAAI,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;gBAC/B,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,yBAAyB;aAChC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,MAAM,IAAA,yCAAmB,EAC1C;gBACE,EAAE,EAAE;oBACF,MAAM,EAAE;wBACN,MAAM,EAAE;4BACN,IAAI,EAAE;gCACJ,KAAK,EAAE,UAAU,CAAC,KAAK;gCACvB,IAAI,EAAE,UAAU,CAAC,IAAI;6BACtB;4BACD,IAAI,EAAE,MAAM;yBACb;qBACF;iBACF;aACF,EACD,OAAO,CACR,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACxB,0CAA0C;YAC1C,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC5D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC1D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,uBAAuB,EAAE,GAAG,EAAE;QAClC,IAAA,eAAI,EAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;gBAC/B,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,yBAAyB;aAChC,CAAC,CAAC;YAEH,yEAAyE;YACzE,MAAM,UAAU,GAAG,MAAM,IAAA,yCAAmB,EAC1C;gBACE,EAAE,EAAE;oBACF,MAAM,EAAE;wBACN,MAAM,EAAE;4BACN,IAAI,EAAE;gCACJ,KAAK,EAAE,UAAU,CAAC,KAAK;gCACvB,IAAI,EAAE,UAAU,CAAC,IAAI;6BACtB;4BACD,IAAI,EAAE,+BAA+B;yBACtC;qBACF;iBACF;aACF,EACD,OAAO,CACR,CAAC;YAEF,mEAAmE;YACnE,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}