@fuzdev/fuz_gitops 0.57.0

package/dist/operations.d.ts

@@ -0,0 +1,409 @@
+/**
+ * Operations interfaces for dependency injection.
+ *
+ * This is the core pattern enabling testability without mocks.
+ * All side effects (git, npm, fs, process) are abstracted into interfaces.
+ *
+ * **Design principles:**
+ * - All operations accept a single `options` object parameter
+ * - All fallible operations return `Result` from `@fuzdev/fuz_util`
+ * - Never throw `Error` in operations - return `Result` with `ok: false`
+ * - Use `null` for expected "not found" cases (not errors)
+ * - Include `log?: Logger` in options where logging is useful
+ *
+ * **Production usage:**
+ * ```typescript
+ * import {default_gitops_operations} from './operations_defaults.js';
+ * const result = await ops.git.current_branch_name({cwd: '/path'});
+ * if (!result.ok) {
+ *   throw new TaskError(result.message);
+ * }
+ * const branch = result.value;
+ * ```
+ *
+ * **Test usage:**
+ * ```typescript
+ * const mock_ops = create_mock_operations();
+ * const result = await publish_repos(repos, {...options, ops: mock_ops});
+ * // Assert on result without any real git/npm calls
+ * ```
+ *
+ * See `operations_defaults.ts` for real implementations.
+ * See test files (*.test.ts) for mock implementations.
+ */
+import type { Result } from '@fuzdev/fuz_util/result.js';
+import type { Logger } from '@fuzdev/fuz_util/log.js';
+import type { SpawnOptions } from 'node:child_process';
+import type { LocalRepo } from './local_repo.js';
+import type { ChangesetInfo } from './changeset_reader.js';
+import type { BumpType } from './semver.js';
+import type { PreflightOptions, PreflightResult } from './preflight_checks.js';
+import type { WaitOptions } from './npm_registry.js';
+/**
+ * Changeset operations for reading and predicting versions from `.changeset/*.md` files.
+ */
+export interface ChangesetOperations {
+    /**
+     * Checks if a repo has any changeset files.
+     * Returns true if changesets exist, false if none found.
+     */
+    has_changesets: (options: {
+        repo: LocalRepo;
+    }) => Promise<Result<{
+        value: boolean;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Reads all changeset files from a repo.
+     * Returns array of changeset info, or error if reading fails.
+     */
+    read_changesets: (options: {
+        repo: LocalRepo;
+        log?: Logger;
+    }) => Promise<Result<{
+        value: Array<ChangesetInfo>;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Predicts the next version based on changesets.
+     * Returns null if no changesets found (expected, not an error).
+     * Returns error Result if changesets exist but can't be read/parsed.
+     */
+    predict_next_version: (options: {
+        repo: LocalRepo;
+        log?: Logger;
+    }) => Promise<Result<{
+        version: string;
+        bump_type: BumpType;
+    }, {
+        message: string;
+    }> | null>;
+}
+/**
+ * Git operations for branch management, commits, tags, and workspace state.
+ * All operations return `Result` instead of throwing errors.
+ */
+export interface GitOperations {
+    /**
+     * Gets the current branch name.
+     */
+    current_branch_name: (options?: {
+        cwd?: string;
+    }) => Promise<Result<{
+        value: string;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Gets the current commit hash.
+     */
+    current_commit_hash: (options?: {
+        branch?: string;
+        cwd?: string;
+    }) => Promise<Result<{
+        value: string;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Checks if the workspace is clean (no uncommitted changes).
+     */
+    check_clean_workspace: (options?: {
+        cwd?: string;
+    }) => Promise<Result<{
+        value: boolean;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Checks out a branch.
+     */
+    checkout: (options: {
+        branch: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Pulls changes from remote.
+     */
+    pull: (options?: {
+        origin?: string;
+        branch?: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Switches to a branch, optionally pulling.
+     */
+    switch_branch: (options: {
+        branch: string;
+        pull?: boolean;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Checks if a remote exists.
+     */
+    has_remote: (options?: {
+        remote?: string;
+        cwd?: string;
+    }) => Promise<Result<{
+        value: boolean;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Stages files for commit.
+     */
+    add: (options: {
+        files: string | Array<string>;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Creates a commit.
+     */
+    commit: (options: {
+        message: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Stages files and creates a commit.
+     */
+    add_and_commit: (options: {
+        files: string | Array<string>;
+        message: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Checks if there are any uncommitted changes.
+     */
+    has_changes: (options?: {
+        cwd?: string;
+    }) => Promise<Result<{
+        value: boolean;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Gets a list of changed files.
+     */
+    get_changed_files: (options?: {
+        cwd?: string;
+    }) => Promise<Result<{
+        value: Array<string>;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Creates a git tag.
+     */
+    tag: (options: {
+        tag_name: string;
+        message?: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Pushes a tag to remote.
+     */
+    push_tag: (options: {
+        tag_name: string;
+        origin?: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Stashes uncommitted changes.
+     */
+    stash: (options?: {
+        message?: string;
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Pops the most recent stash.
+     */
+    stash_pop: (options?: {
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Checks if a specific file changed between two commits.
+     */
+    has_file_changed: (options: {
+        from_commit: string;
+        to_commit: string;
+        file_path: string;
+        cwd?: string;
+    }) => Promise<Result<{
+        value: boolean;
+    }, {
+        message: string;
+    }>>;
+}
+/**
+ * Process spawning operations for running shell commands.
+ */
+export interface ProcessOperations {
+    /**
+     * Spawns a child process and waits for completion.
+     */
+    spawn: (options: {
+        cmd: string;
+        args: Array<string>;
+        spawn_options?: SpawnOptions;
+    }) => Promise<Result<{
+        stdout?: string;
+        stderr?: string;
+    }, {
+        message: string;
+        stderr?: string;
+    }>>;
+}
+/**
+ * Build operations for validating packages compile before publishing.
+ */
+export interface BuildOperations {
+    /**
+     * Builds a package using gro build.
+     */
+    build_package: (options: {
+        repo: LocalRepo;
+        log?: Logger;
+    }) => Promise<Result<object, {
+        message: string;
+        output?: string;
+    }>>;
+}
+/**
+ * NPM registry operations for package availability checks and authentication.
+ * Includes exponential backoff for waiting on package propagation.
+ */
+export interface NpmOperations {
+    /**
+     * Waits for a package version to be available on NPM.
+     * Uses exponential backoff with configurable timeout.
+     */
+    wait_for_package: (options: {
+        pkg: string;
+        version: string;
+        wait_options?: WaitOptions;
+        log?: Logger;
+    }) => Promise<Result<object, {
+        message: string;
+        timeout?: boolean;
+    }>>;
+    /**
+     * Checks if a package version is available on NPM.
+     */
+    check_package_available: (options: {
+        pkg: string;
+        version: string;
+        log?: Logger;
+    }) => Promise<Result<{
+        value: boolean;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Checks npm authentication status.
+     */
+    check_auth: () => Promise<Result<{
+        username: string;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Checks if npm registry is reachable.
+     */
+    check_registry: () => Promise<Result<object, {
+        message: string;
+    }>>;
+    /**
+     * Installs npm dependencies.
+     */
+    install: (options?: {
+        cwd?: string;
+    }) => Promise<Result<object, {
+        message: string;
+        stderr?: string;
+    }>>;
+    /**
+     * Cleans the npm cache.
+     * Uses `npm cache clean --force` to clear stale cache entries.
+     */
+    cache_clean: () => Promise<Result<object, {
+        message: string;
+    }>>;
+}
+/**
+ * Preflight validation operations to ensure repos are ready for publishing.
+ * Validates workspace state, branches, builds, and npm authentication.
+ */
+export interface PreflightOperations {
+    /**
+     * Runs preflight validation checks before publishing.
+     */
+    run_preflight_checks: (options: {
+        repos: Array<LocalRepo>;
+        preflight_options: PreflightOptions;
+        git_ops?: GitOperations;
+        npm_ops?: NpmOperations;
+        build_ops?: BuildOperations;
+        changeset_ops?: ChangesetOperations;
+    }) => Promise<PreflightResult>;
+}
+/**
+ * File system operations for reading and writing files.
+ */
+export interface FsOperations {
+    /**
+     * Reads a file from the file system.
+     */
+    readFile: (options: {
+        path: string;
+        encoding: BufferEncoding;
+    }) => Promise<Result<{
+        value: string;
+    }, {
+        message: string;
+    }>>;
+    /**
+     * Writes a file to the file system.
+     */
+    writeFile: (options: {
+        path: string;
+        content: string;
+    }) => Promise<Result<object, {
+        message: string;
+    }>>;
+}
+/**
+ * Combined operations interface grouping all gitops functionality.
+ * This is the main interface injected into publishing and validation workflows.
+ */
+export interface GitopsOperations {
+    changeset: ChangesetOperations;
+    git: GitOperations;
+    process: ProcessOperations;
+    npm: NpmOperations;
+    preflight: PreflightOperations;
+    fs: FsOperations;
+    build: BuildOperations;
+}
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

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

package/dist/operations.js

@@ -0,0 +1,34 @@
+/**
+ * Operations interfaces for dependency injection.
+ *
+ * This is the core pattern enabling testability without mocks.
+ * All side effects (git, npm, fs, process) are abstracted into interfaces.
+ *
+ * **Design principles:**
+ * - All operations accept a single `options` object parameter
+ * - All fallible operations return `Result` from `@fuzdev/fuz_util`
+ * - Never throw `Error` in operations - return `Result` with `ok: false`
+ * - Use `null` for expected "not found" cases (not errors)
+ * - Include `log?: Logger` in options where logging is useful
+ *
+ * **Production usage:**
+ * ```typescript
+ * import {default_gitops_operations} from './operations_defaults.js';
+ * const result = await ops.git.current_branch_name({cwd: '/path'});
+ * if (!result.ok) {
+ *   throw new TaskError(result.message);
+ * }
+ * const branch = result.value;
+ * ```
+ *
+ * **Test usage:**
+ * ```typescript
+ * const mock_ops = create_mock_operations();
+ * const result = await publish_repos(repos, {...options, ops: mock_ops});
+ * // Assert on result without any real git/npm calls
+ * ```
+ *
+ * See `operations_defaults.ts` for real implementations.
+ * See test files (*.test.ts) for mock implementations.
+ */
+export {};

package/dist/operations_defaults.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Production implementations of operations interfaces.
+ *
+ * Provides real git, npm, fs, and build operations for production use.
+ * For interface definitions and dependency injection pattern, see `operations.ts`.
+ */
+import type { ChangesetOperations, GitOperations, ProcessOperations, NpmOperations, PreflightOperations, FsOperations, BuildOperations, GitopsOperations } from './operations.js';
+export declare const default_changeset_operations: ChangesetOperations;
+export declare const default_git_operations: GitOperations;
+export declare const default_process_operations: ProcessOperations;
+export declare const default_npm_operations: NpmOperations;
+export declare const default_preflight_operations: PreflightOperations;
+export declare const default_fs_operations: FsOperations;
+export declare const default_build_operations: BuildOperations;
+/**
+ * Combined default operations for all gitops functionality.
+ */
+export declare const default_gitops_operations: GitopsOperations;
+//# sourceMappingURL=operations_defaults.d.ts.map

package/dist/operations_defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations_defaults.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations_defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,4BAA4B,EAAE,mBAuB1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aA+FpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,iBAsBxC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAqEpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,mBAI1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAUnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmBtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAQvC,CAAC"}