@foss.global/codefeed 1.9.0 → 1.10.0

package/.smartconfig.json

@@ -5,7 +5,7 @@
       "githost": "code.foss.global",
       "gitscope": "foss.global",
       "gitrepo": "codefeed",
-      "description": "The @foss.global/codefeed module is designed for generating feeds from Gitea repositories, enhancing development workflows by processing commit data and repository activities.",
+      "description": "The @foss.global/codefeed module generates commit/activity feeds from forge providers including Gitea and GitManager.",
       "npmPackagename": "@foss.global/codefeed",
       "license": "MIT",
       "projectDomain": "foss.global",

package/changelog.md

@@ -0,0 +1,168 @@
+# Changelog
+
+## 2026-07-20 - 1.10.0
+
+### Features
+
+- add a default-deny GitManager public read client (public-api)
+  - Map GitManager repositories, organizations, trees, files, commits, diffs, tags, releases, activity, and language summaries into the shared public request response models.
+  - Require an authoritative public-repository predicate unless all managed repositories are explicitly declared public.
+  - Bound query, commit, release, language scan, and concurrency work while validating repository, path, URL, and commit inputs.
+
+### Maintenance
+
+- adopt `@foss.global/interfaces` 0.4 and `@foss.global/gitmanager` 0.4, publish the changelog, and update policy-eligible tooling versions (tooling)
+
+## 2026-06-23 - 1.9.0
+
+### Features
+
+- add GitManager provider adapter (gitmanager-provider)
+  - Add CodeFeedGitManagerProvider for repositories, commits, tags, and changelog content from @foss.global/gitmanager.
+  - Export the provider options and completeness error for GitManager-backed feeds.
+  - Propagate provider completeness errors to avoid silently returning incomplete bounded listings.
+  - Document GitManager usage and add provider coverage tests.
+
+## 2026-06-23 - 1.8.0
+
+### Features
+
+- add provider abstraction and shared interfaces integration
+  - Consume `@foss.global/interfaces` for the canonical codefeed commit result contract.
+  - Add `ICodeFeedProvider` for alternate read backends while preserving the default Gitea behavior.
+  - Lazy-load npm registry checks and migrate tests to deterministic `@git.zone/tstest` coverage.
+
+### Fixes
+
+- migrate project metadata to smartconfig (tooling)
+  - migrate project metadata from npmextra.json to .smartconfig.json
+  - include .smartconfig.json in published package files instead of npmextra.json
+  - update development build tooling dependencies and Node.js type definitions
+  - remove unused TypeScript path configuration
+
+## 2025-09-14 - 1.7.2 - fix(core)
+Stabilize pagination, tag mapping, changelog parsing, and HTTP retry/backoff; add tests and caching improvements
+
+- Handle paginated orgs, repos, commits, and tags to avoid missing pages.
+- Map tags to commit SHAs and extract version strings from tag names for changelog lookup and optional npm publish detection.
+- Discover and parse repository CHANGELOG files from multiple candidate paths to extract per-version entries.
+- Implement retries with exponential backoff for 429/5xx and network errors in fetchFunction.
+- Add in-memory caching with window trimming, stable sorting, and optional tagged-only filtering.
+- Include tests: mocked pagination & tag mapping test and integration test scaffolding using @push.rocks/tapbundle.
+
+## 2025-04-25 - 1.7.1 - fix(CodeFeed)
+Improve commit fetching concurrency and add tagged-only commit filtering along with updated documentation and tests
+
+- Updated readme examples to clarify default and options usage, including caching and tagged-only filtering
+- Increased non-exclusive concurrency from 5 to 20 in fetchAllCommitsFromInstance
+- Added tagged-only filtering logic for both cached and non-cached commit results
+- Modified tests to enable tagged-only mode and require npm check
+
+## 2025-04-25 - 1.7.0 - feat(core)
+Enhance commit fetching with caching, concurrency improvements, and dependency upgrades
+
+- Updated development dependencies (@git.zone/tsbuild, @git.zone/tsbundle, @git.zone/tstest, @push.rocks/tapbundle, @types/node) and dependency versions
+- Introduced optional caching options (enableCache, cacheWindowMs, enableNpmCheck) in the CodeFeed constructor to optimize commit retrieval
+- Refactored commit fetching to use AsyncExecutionStack for controlled concurrency and improved performance
+- Removed deprecated ts/codefeed.plugins.ts in favor of a consolidated plugins.ts module
+
+## 2024-12-16 - 1.6.5 - fix(CodeFeed)
+Fixed timestamp initialization and commit fetching timeframe
+
+- Updated the lastRunTimestamp initialization default period from 24 hours to 7 days in CodeFeed constructor.
+- Modified commit fetching logic to consider commits from the last 7 days instead of 24 hours in fetchRecentCommitsForRepo.
+
+## 2024-12-14 - 1.6.4 - fix(core)
+Refactor fetch logic to use a unified fetchFunction for API calls
+
+- Consolidated API request logic in the CodeFeed class to use fetchFunction for improved maintainability.
+
+## 2024-12-14 - 1.6.3 - fix(codefeed)
+Refactor and fix formatting issues in the CodeFeed module
+
+- Refactored various method format and spacing.
+- Fixed error handling formatting for readability.
+- Improved consistency in JSON handling for API responses.
+
+## 2024-12-14 - 1.6.2 - fix(core)
+Fix sorting order of tagged commits by timestamp
+
+- Fixed the sorting order of commits to be by timestamp in descending order after filtering for tagged commits.
+
+## 2024-12-14 - 1.6.1 - fix(docs)
+Updated project metadata and expanded documentation for installation and usage.
+
+- Updated description and keywords in package.json and npmextra.json.
+- Significant expansion of the README.md with detailed installation, usage, and feature instructions.
+
+## 2024-12-14 - 1.6.0 - feat(core)
+Add changelog fetching and parsing functionality
+
+- Implemented loadChangelogFromRepo to directly load the changelog from a Gitea repository.
+- Introduced parsing functionality to extract specific version details from the loaded changelog.
+- Updated CodeFeed class to utilize the changelog for version verification and commit processing.
+
+## 2024-12-14 - 1.5.3 - fix(core)
+Fix filtering logic for returning only tagged commits
+
+- Ensure `allCommits` is filtered to only include commits with 'tagged' status before returning.
+
+## 2024-12-14 - 1.5.2 - fix(core)
+Ensure stability of core functionalities.
+
+
+## 2024-12-14 - 1.5.1 - fix(core)
+Refine logging format in CodeFeed class
+
+- Modified console log format in fetchAllCommitsFromInstance method for better readability.
+
+## 2024-12-14 - 1.5.0 - feat(core)
+Refactor TypeScript interfaces and improve module exports
+
+- Moved TypeScript interfaces to a dedicated file (ts/interfaces/index.ts).
+- Updated import/export structure to improve code readability and maintainability.
+- Enhanced the package.json to utilize a module exports field for better resolution.
+
+## 2024-12-13 - 1.4.1 - fix(core)
+Corrected log formatting for commit information output in CodeFeed
+
+- Fixed formatting issue in commit log output within the CodeFeed class to ensure proper display of timestamps.
+
+## 2024-12-13 - 1.4.0 - feat(CodeFeed)
+Enhance commit results with human-readable time
+
+- Integrated smarttime plugin to calculate and format timestamps into human-readable time.
+- Updated dependencies in package.json to include smarttime and adjusted versions for existing packages.
+- Improved fetchAllCommitsFromInstance method to display formatted time ago information for each commit.
+
+## 2024-12-13 - 1.3.0 - feat(core)
+Export CommitResult interface for external use.
+
+- Changed CommitResult from a local interface to an exported interface, allowing for external usage and integration.
+
+## 2024-12-13 - 1.2.1 - fix(core)
+No changes detected
+
+
+## 2024-12-13 - 1.2.0 - feat(core)
+Add organization-level activity fetching and RSS parsing
+
+- Integrated smartxml package for XML parsing.
+- Implemented fetching of all organizations within a Gitea instance.
+- Added functionality to check new activities in organization RSS feeds.
+- Enhanced fetching logic to include repository commits and tags.
+
+## 2024-12-13 - 1.1.0 - feat(core)
+Add tracking of commits published on npm
+
+- Introduced a check for published commits on npm using smartnpm.
+- Enhanced fetchAllCommitsFromInstance to include 'publishedOnNpm' status in results.
+
+## 2024-12-13 - 1.0.2 - fix(core)
+Improve error handling in fetchRecentCommitsForRepo method
+
+- Refined the console error message for better clarity.
+- Updated the fetchRecentCommitsForRepo method to stop fetching when encountering a commit older than 24 hours.
+
+## 2024-12-13 - 1.0.1 - initial release
+Initial release of the project

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@foss.global/codefeed',
-    version: '1.9.0',
+    version: '1.10.0',
     description: 'The @foss.global/codefeed module generates commit/activity feeds from forge providers including Gitea and GitManager.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVIQUF1SDtDQUNySSxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVIQUF1SDtDQUNySSxDQUFBIn0=

package/dist_ts/classes.gitmanagerpublicclient.d.ts

@@ -0,0 +1,62 @@
+import * as plugins from './plugins.js';
+export interface IGitManagerPublicReadClientOptions {
+    gitManager: plugins.TGitManager;
+    publicBaseUrl?: string;
+    smartHttpBaseUrl?: string;
+    sshBaseUrl?: string;
+    allowAllRepositories?: boolean;
+    isRepositoryPublic?: (repositoryArg: plugins.TGitManagerRepositoryInfo) => Promise<boolean>;
+    organizationMetadata?: (orgArg: string) => Promise<Partial<plugins.fossInterfaces.IPublicOrg> | undefined>;
+    repositoryMetadata?: (repositoryArg: plugins.TGitManagerRepositoryInfo) => Promise<Partial<plugins.fossInterfaces.IPublicRepo> | undefined>;
+    newsProvider?: (limitArg: number) => Promise<plugins.fossInterfaces.IPublicNewsItem[]>;
+    maxCommits?: number;
+    maxReleases?: number;
+    maxLanguageFiles?: number;
+    maxConcurrency?: number;
+}
+export declare class GitManagerPublicReadClient {
+    private readonly gitManager;
+    private readonly publicBaseUrl;
+    private readonly smartHttpBaseUrl;
+    private readonly sshBaseUrl;
+    private readonly allowAllRepositories;
+    private readonly isRepositoryPublic?;
+    private readonly organizationMetadata?;
+    private readonly repositoryMetadata?;
+    private readonly newsProvider?;
+    private readonly maxCommits;
+    private readonly maxReleases;
+    private readonly maxLanguageFiles;
+    private readonly maxConcurrency;
+    constructor(optionsArg: IGitManagerPublicReadClientOptions);
+    getOverview(queryArg?: string): Promise<plugins.fossInterfaces.IReq_PublicOverview['response']>;
+    getOrg(orgArg: string): Promise<plugins.fossInterfaces.IReq_PublicOrg['response']>;
+    getRepo(orgArg: string, repoArg: string, pathArg?: string, _issueNumberArg?: number): Promise<plugins.fossInterfaces.IReq_PublicRepo['response']>;
+    getFile(orgArg: string, repoArg: string, pathArg: string): Promise<plugins.fossInterfaces.IReq_PublicFile['response']>;
+    getCommits(orgArg: string, repoArg: string, shaArg?: string): Promise<plugins.fossInterfaces.IReq_PublicCommits['response']>;
+    private listVisibleRepositories;
+    private findVisibleRepository;
+    private mapOrganizations;
+    private mapRepository;
+    private getCommitFeed;
+    private mapCommit;
+    private getCommitDetail;
+    private mapContent;
+    private mapRelease;
+    private mapActivity;
+    private readReadme;
+    private scanLanguages;
+    private getStats;
+    private getPrimaryLanguage;
+    private languageForPath;
+    private getActivityKind;
+    private mapDiffStatus;
+    private repoPathUrl;
+    private stableId;
+    private normalizeBaseUrl;
+    private validateSlug;
+    private validatePath;
+    private validateLimit;
+    private withFallback;
+    private mapWithConcurrency;
+}