@chisquare-tech/origine-ngx-apps-code 0.2.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chisquare-tech/origine-ngx-apps-code",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Origine's Code module screens: repositories, files, commits, branches, pull requests and review, repository settings.",
   "repository": {
     "type": "git",

package/types/chisquare-tech-origine-ngx-apps-code.d.ts

@@ -54,6 +54,8 @@ interface Repo {
     empty: boolean;
     capabilities: string[];
     readOnly?: boolean;
+    /** The caller's collaborator permission on this repository (read, write or maintain), if any. */
+    collaborator?: string;
     createdAt?: string;
 }
 interface GitPerson {
@@ -175,6 +177,52 @@ interface Ref {
     merged: boolean;
     canDelete: boolean;
 }
+/** A repository collaborator (DEV-06): access beyond the project role, for one repository. */
+interface Collaborator {
+    repoId: string;
+    userId: string;
+    permission: 'read' | 'write' | 'maintain';
+    projectRole: string;
+    addedBy: string;
+    createdAt: string;
+}
+/** A file on a release (DEV-15). */
+interface ReleaseAsset {
+    id: string;
+    releaseId: string;
+    name: string;
+    size: number;
+    mediaType: string;
+    createdBy: string;
+    createdAt: string;
+}
+/** A release: a tag with a title, Markdown notes and files; a draft until published. */
+interface Release {
+    id: string;
+    repoId: string;
+    tag: string;
+    targetSha: string;
+    short: string;
+    title: string;
+    notes: string;
+    draft: boolean;
+    prerelease: boolean;
+    latest: boolean;
+    createdBy: string;
+    createdAt: string;
+    publishedAt: string | null;
+    version: number;
+    assets: ReleaseAsset[];
+}
+interface ReleaseInput {
+    tag?: string;
+    target?: string;
+    title?: string;
+    notes?: string;
+    draft?: boolean;
+    prerelease?: boolean;
+    version?: number;
+}
 interface Protection {
     id: string;
     repoId: string;
@@ -374,6 +422,21 @@ declare class CodeApi {
     }): Observable<FileDiff>;
     compare(project: string, name: string, base: string, head: string): Observable<Comparison>;
     refs(project: string, name: string, kind?: 'branch' | 'tag', q?: string): Observable<Ref[]>;
+    collaborators(project: string, name: string): Observable<Collaborator[]>;
+    setCollaborator(project: string, name: string, userId: string, permission: string): Observable<Collaborator>;
+    removeCollaborator(project: string, name: string, userId: string): Observable<unknown>;
+    createTag(project: string, name: string, tag: string, target: string): Observable<Ref>;
+    deleteTag(project: string, name: string, tag: string): Observable<unknown>;
+    releases(project: string, name: string): Observable<Release[]>;
+    createRelease(project: string, name: string, r: ReleaseInput): Observable<Release>;
+    updateRelease(project: string, name: string, id: string, r: ReleaseInput): Observable<Release>;
+    deleteRelease(project: string, name: string, id: string, deleteTag: boolean): Observable<unknown>;
+    /** Notes drafted from the done issues and merged pull requests since the previous release. */
+    releaseNotes(project: string, name: string, target: string, tag?: string): Observable<string>;
+    addAsset(project: string, name: string, id: string, file: File): Observable<ReleaseAsset>;
+    /** A release file's bytes (the download needs the session, so no plain link works). */
+    assetBlob(project: string, name: string, id: string, asset: string): Observable<globalThis.Blob>;
+    deleteAsset(project: string, name: string, id: string, asset: string): Observable<unknown>;
     createBranch(project: string, name: string, branch: string, from: string): Observable<unknown>;
     deleteBranch(project: string, name: string, branch: string): Observable<unknown>;
     deleteMerged(project: string, name: string): Observable<{
@@ -475,6 +538,8 @@ declare abstract class RepoPage {
     protected readonly people: _angular_core.Signal<People>;
     protected readonly canWrite: _angular_core.Signal<boolean>;
     protected readonly canAdmin: _angular_core.Signal<boolean>;
+    /** Repository settings short of a rename, the visibility and deletion: Maintainers, and maintain collaborators. */
+    protected readonly canMaintain: _angular_core.Signal<boolean>;
     protected readonly canProtect: _angular_core.Signal<boolean>;
     constructor();
     /** Called with the repository once it has loaded (and again after it changes). */
@@ -821,7 +886,7 @@ declare class PullsPage {
 }
 
 type Tab = 'conversation' | 'commits' | 'files' | 'checks';
-interface Event {
+interface Event$1 {
     at: string;
     kind: 'comment' | 'review' | 'thread';
     who: string;
@@ -883,7 +948,7 @@ declare class PullPage extends RepoPage {
         label: string;
         colour: string;
     }[]>;
-    protected readonly events: _angular_core.Signal<Event[]>;
+    protected readonly events: _angular_core.Signal<Event$1[]>;
     constructor();
     protected onRepo(_: Repo): void;
     protected md(s: string): string;
@@ -957,6 +1022,18 @@ declare class RepoSettingsPage extends RepoPage {
         hint: string;
     }[];
     constructor();
+    protected readonly collabs: _angular_core.WritableSignal<Collaborator[]>;
+    protected readonly perms: {
+        id: string;
+        label: string;
+    }[];
+    protected readonly addable: _angular_core.Signal<_chisquare_tech_origine_ngx_apps_code.CodePerson[]>;
+    protected newCollab: string;
+    protected newPerm: string;
+    protected roleLabel(r: string): string;
+    private loadCollabs;
+    protected setCollab(userId: string, permission: string, adding?: boolean): void;
+    protected removeCollab(userId: string): void;
     protected onRepo(r: Repo): void;
     protected go(s: Section): void;
     protected max0(n: number): number;
@@ -975,5 +1052,51 @@ declare class RepoSettingsPage extends RepoPage {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RepoSettingsPage, "o-code-settings", never, {}, {}, never, never, true, never>;
 }
 
-export { BranchesPage, CodeApi, CodeHost, CommitPage, CommitsPage, CurrentRepo, CurrentRepoPage, DiffView, FilePage, NewRepoPage, People, PullPage, PullsPage, RefPicker, RepoHomePage, RepoPage, RepoSettingsPage, ReposPage, TOKEN_CSS, ago, apiMessage, checkDot, copy, dayLabel, initials, langColour, pair, shortDate, size };
-export type { BlameHunk, Blob, CheckStatus, CodePerson, CodeProject, Commit, CommitDetail, Comparison, DiffHunk, DiffLine, Entry, FileChange, FileDiff, Gate, GateRow, GitPerson, Language, LineComment, NewComment, PRComment, Protection, Pull, PullBrief, Ref, Repo, Review, ReviewBrief, SplitRow, Thread, ThreadReply, Timeline, Tree };
+interface Draft {
+    id?: string;
+    version?: number;
+    tag: string;
+    newTag: boolean;
+    target: string;
+    title: string;
+    notes: string;
+    prerelease: boolean;
+    draft: boolean;
+}
+declare class ReleasesPage extends RepoPage {
+    protected readonly releases: _angular_core.WritableSignal<Release[]>;
+    protected readonly tags: _angular_core.WritableSignal<Ref[]>;
+    protected readonly loaded: _angular_core.WritableSignal<boolean>;
+    protected readonly tagging: _angular_core.WritableSignal<boolean>;
+    protected readonly draft: _angular_core.WritableSignal<Draft | null>;
+    protected readonly busy: _angular_core.WritableSignal<boolean>;
+    protected readonly confirming: _angular_core.WritableSignal<string>;
+    protected readonly freeTags: _angular_core.Signal<Ref[]>;
+    protected readonly ago: (s?: string) => string;
+    protected tagName: string;
+    protected tagFrom: string;
+    protected alsoTag: boolean;
+    protected onRepo(r: Repo): void;
+    protected md(s: string): string;
+    protected used(tag: string): boolean;
+    private load;
+    private run;
+    protected createTag(): void;
+    protected removeTag(t: Ref): void;
+    protected startRelease(): void;
+    protected setTag(d: Draft, tag: string): void;
+    protected generate(d: Draft): void;
+    protected edit(r: Release): void;
+    protected save(d: Draft, asDraft: boolean): void;
+    protected remove(rel: Release): void;
+    protected upload(rel: Release, ev: Event): void;
+    protected removeAsset(rel: Release, id: string): void;
+    protected download(rel: Release, id: string, filename: string): void;
+    protected archive(rel: Release, format: 'zip' | 'tar.gz'): void;
+    private save_;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReleasesPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReleasesPage, "o-code-releases", never, {}, {}, never, never, true, never>;
+}
+
+export { BranchesPage, CodeApi, CodeHost, CommitPage, CommitsPage, CurrentRepo, CurrentRepoPage, DiffView, FilePage, NewRepoPage, People, PullPage, PullsPage, RefPicker, ReleasesPage, RepoHomePage, RepoPage, RepoSettingsPage, ReposPage, TOKEN_CSS, ago, apiMessage, checkDot, copy, dayLabel, initials, langColour, pair, shortDate, size };
+export type { BlameHunk, Blob, CheckStatus, CodePerson, CodeProject, Collaborator, Commit, CommitDetail, Comparison, DiffHunk, DiffLine, Entry, FileChange, FileDiff, Gate, GateRow, GitPerson, Language, LineComment, NewComment, PRComment, Protection, Pull, PullBrief, Ref, Release, ReleaseAsset, ReleaseInput, Repo, Review, ReviewBrief, SplitRow, Thread, ThreadReply, Timeline, Tree };