@kinotic-ai/os-api 1.3.0 → 1.5.0

package/dist/index.cjs

@@ -57,8 +57,6 @@ __export(exports_src, {
   QueryDecorator: () => QueryDecorator,
   ProjectType: () => ProjectType,
   ProjectService: () => ProjectService,
-  ProjectGitHubRepoService: () => ProjectGitHubRepoService,
-  ProjectGitHubRepoLink: () => ProjectGitHubRepoLink,
   Project: () => Project,
   ProgressType: () => ProgressType,
   PageableC3Type: () => PageableC3Type,
@@ -80,7 +78,9 @@ __export(exports_src, {
   IamUserService: () => IamUserService,
   IamUser: () => IamUser,
   GroupLoggerLevelsDescriptor: () => GroupLoggerLevelsDescriptor,
-  GitHubInstallationToken: () => GitHubInstallationToken,
+  GitHubToken: () => GitHubToken,
+  GitHubRepoToken: () => GitHubRepoToken,
+  GitHubInstallCompletion: () => GitHubInstallCompletion,
   GitHubAppInstallationService: () => GitHubAppInstallationService,
   GitHubAppInstallation: () => GitHubAppInstallation,
   FlattenedDecorator: () => FlattenedDecorator,
@@ -90,7 +90,6 @@ __export(exports_src, {
   EntityDecorator: () => EntityDecorator,
   DiscriminatorDecorator: () => DiscriminatorDecorator,
   DataInsightsService: () => DataInsightsService,
-  AvailableRepo: () => AvailableRepo,
   AutoGeneratedIdDecorator: () => AutoGeneratedIdDecorator,
   AuthType: () => AuthType,
   ApplicationService: () => ApplicationService,
@@ -302,6 +301,10 @@ class Project {
   name;
   description;
   sourceOfTruth = null;
+  repoFullName;
+  repoId;
+  defaultBranch;
+  repoPrivate = true;
   updated = null;
   constructor(id, applicationId, name, description) {
     this.id = id;
@@ -451,41 +454,31 @@ class IamUser {
   created = null;
   updated = null;
 }
-// packages/os-api/src/api/model/github/AvailableRepo.ts
-class AvailableRepo {
-  repoId = "";
-  fullName = "";
-  defaultBranch = "";
-  privateRepo = false;
-}
 // packages/os-api/src/api/model/github/GitHubAppInstallation.ts
 class GitHubAppInstallation {
   id = null;
   organizationId = "";
-  githubInstallationId = "";
+  githubInstallationId = 0;
   accountLogin = "";
   accountType = "";
   suspendedAt = null;
   created = null;
   updated = null;
 }
-// packages/os-api/src/api/model/github/GitHubInstallationToken.ts
-class GitHubInstallationToken {
+// packages/os-api/src/api/model/github/GitHubToken.ts
+class GitHubToken {
   token = "";
   expiresAt = 0;
+}
+// packages/os-api/src/api/model/github/GitHubRepoToken.ts
+class GitHubRepoToken extends GitHubToken {
   cloneUrl = "";
   defaultBranch = "";
 }
-// packages/os-api/src/api/model/github/ProjectGitHubRepoLink.ts
-class ProjectGitHubRepoLink {
-  id = null;
-  projectId = "";
-  organizationId = "";
-  installationId = "";
-  repoFullName = "";
-  repoId = "";
-  defaultBranch = "";
-  updated = null;
+// packages/os-api/src/api/model/github/GitHubInstallCompletion.ts
+class GitHubInstallCompletion {
+  installation;
+  returnTo = null;
 }
 // packages/os-api/src/api/model/KinoticProjectConfig.ts
 class KinoticProjectConfig {
@@ -747,33 +740,16 @@ class GitHubAppInstallationService extends import_core9.CrudServiceProxy {
   constructor(kinotic) {
     super(kinotic.serviceProxy("org.kinotic.github.api.services.GitHubAppInstallationService"));
   }
-  startInstall() {
-    return this.serviceProxy.invoke("startInstall", []);
+  startInstall(returnTo) {
+    return this.serviceProxy.invoke("startInstall", [returnTo]);
+  }
+  completeInstall(installationId, state) {
+    return this.serviceProxy.invoke("completeInstall", [installationId, state]);
   }
   findForCurrentOrg() {
     return this.serviceProxy.invoke("findForCurrentOrg", []);
   }
 }
-// packages/os-api/src/api/services/IProjectGitHubRepoService.ts
-var import_core10 = require("@kinotic-ai/core");
-
-class ProjectGitHubRepoService extends import_core10.CrudServiceProxy {
-  constructor(kinotic) {
-    super(kinotic.serviceProxy("org.kinotic.github.api.services.ProjectGitHubRepoService"));
-  }
-  listAvailableRepos() {
-    return this.serviceProxy.invoke("listAvailableRepos", []);
-  }
-  linkProject(projectId, repoFullName) {
-    return this.serviceProxy.invoke("linkProject", [projectId, repoFullName]);
-  }
-  unlinkProject(projectId) {
-    return this.serviceProxy.invoke("unlinkProject", [projectId]);
-  }
-  findByProject(projectId) {
-    return this.serviceProxy.invoke("findByProject", [projectId]);
-  }
-}
 // packages/os-api/src/api/OsApiPlugin.ts
 var OsApiPlugin = {
   install(kinotic) {
@@ -789,8 +765,7 @@ var OsApiPlugin = {
       vmNodes: new VmNodeServiceProxy(kinotic),
       workloads: new WorkloadServiceProxy(kinotic),
       iamUsers: new IamUserService(kinotic),
-      githubAppInstallations: new GitHubAppInstallationService(kinotic),
-      githubRepoLinks: new ProjectGitHubRepoService(kinotic)
+      githubAppInstallations: new GitHubAppInstallationService(kinotic)
     };
   }
 };

package/dist/index.d.cts

@@ -198,6 +198,24 @@ declare class Project implements Identifiable3<string> {
 	*/
 	sourceOfTruth: ProjectType | null;
 	/**
+	* Full name ({@code owner/repo}) of the GitHub repository backing this project.
+	* Stamped at create time by the server-side repo provisioner.
+	*/
+	repoFullName: string;
+	/**
+	* GitHub's stable repository id. Survives renames on the GitHub side.
+	*/
+	repoId: number;
+	/**
+	* Default branch of the backing repository at the time it was provisioned.
+	*/
+	defaultBranch: string;
+	/**
+	* Visibility chosen for the backing repository at create time. The SPA sets
+	* this before save; the platform passes it through to GitHub.
+	*/
+	repoPrivate: boolean;
+	/**
 	* The date and time the project was updated.
 	*/
 	updated: number | null;
@@ -562,18 +580,6 @@ interface SignUpCompleteRequest {
 	token: string;
 	password: string;
 }
-/**
-* One row in the repo dropdown shown when linking a project. Carries just enough
-* info for the UI; a successful link round-trips through
-* {@link IProjectGitHubRepoService} which re-validates against GitHub before
-* persisting.
-*/
-declare class AvailableRepo {
-	repoId: string;
-	fullName: string;
-	defaultBranch: string;
-	privateRepo: boolean;
-}
 import { Identifiable as Identifiable9 } from "@kinotic-ai/core";
 /**
 * Persisted record of one GitHub App installation that a Kinotic Org has authorised.
@@ -584,7 +590,7 @@ import { Identifiable as Identifiable9 } from "@kinotic-ai/core";
 declare class GitHubAppInstallation implements Identifiable9<string> {
 	id: string | null;
 	organizationId: string;
-	githubInstallationId: string;
+	githubInstallationId: number;
 	accountLogin: string;
 	accountType: string;
 	suspendedAt: number | null;
@@ -592,37 +598,36 @@ declare class GitHubAppInstallation implements Identifiable9<string> {
 	updated: number | null;
 }
 /**
-* What worker nodes receive when they ask for clone credentials. The token is a
-* short-lived GitHub installation access token scoped to a single repository with
-* {@code contents:read} permission; {@code expiresAt} is the absolute UTC instant
-* (epoch milliseconds).
+* A short-lived GitHub installation access token. Mirrors the Java
+* {@code org.kinotic.github.api.model.GitHubToken}; {@code expiresAt} is the
+* absolute UTC instant (epoch milliseconds) at which GitHub will reject the token.
 */
-declare class GitHubInstallationToken {
-	/** Bearer token to send as {@code Authorization: Bearer <token>} on git over HTTPS. */
+declare class GitHubToken {
+	/** Bearer token to send as {@code Authorization: Bearer <token>}. */
 	token: string;
-	/** Absolute expiry (epoch milliseconds). Workers should not use the token beyond this point. */
+	/** Absolute expiry (epoch milliseconds). Do not use past this point. */
 	expiresAt: number;
-	/** {@code https://github.com/<owner>/<repo>.git} for the linked repo. */
+}
+/**
+* A {@link GitHubToken} bundled with the repository-clone metadata a worker needs
+* to {@code git clone} the project's backing repo. Returned by
+* {@code GitHubProjectRepoService.issueRepoToken}.
+*/
+declare class GitHubRepoToken extends GitHubToken {
+	/** {@code https://github.com/<owner>/<repo>.git} for the project's repo. */
 	cloneUrl: string;
-	/** Default branch on the linked repo (e.g. {@code main}). */
+	/** Default branch on the repo (e.g. {@code main}). */
 	defaultBranch: string;
 }
-import { Identifiable as Identifiable10 } from "@kinotic-ai/core";
 /**
-* Persisted link between a Kinotic Project and a single GitHub repository reachable
-* through an existing {@link GitHubAppInstallation}. Drives webhook dispatch
-* (delivery → project) and ref-creation auth (project → which repo, via which
-* installation).
+* Result of finalising a GitHub install round-trip. {@code returnTo} echoes what
+* the SPA staged when it called {@code startInstall(...)} and may carry query
+* params (e.g. {@code /projects?openNewProject=1}) so the destination page can
+* pick up where the user was.
 */
-declare class ProjectGitHubRepoLink implements Identifiable10<string> {
-	id: string | null;
-	projectId: string;
-	organizationId: string;
-	installationId: string;
-	repoFullName: string;
-	repoId: string;
-	defaultBranch: string;
-	updated: number | null;
+declare class GitHubInstallCompletion {
+	installation: GitHubAppInstallation;
+	returnTo: string | null;
 }
 /**
 * Configuration for a single entities path and its corresponding repository output.
@@ -1070,52 +1075,35 @@ declare class IamUserService extends CrudServiceProxy8<IamUser> implements IIamU
 import { CrudServiceProxy as CrudServiceProxy9, IKinotic as IKinotic12, ICrudServiceProxy as ICrudServiceProxy9 } from "@kinotic-ai/core";
 interface IGitHubAppInstallationService extends ICrudServiceProxy9<GitHubAppInstallation> {
 	/**
-	* Stages a single-use {@code state} token bound to the caller's organization in
-	* a cluster-wide store, then returns the GitHub install URL with that state
+	* Stages a single-use state token bound to the caller's organization plus the
+	* supplied returnTo, then returns the GitHub install URL with that state
 	* embedded. The SPA performs {@code window.location = url}.
-	* <p>
-	* Caller must be authenticated under {@code ORGANIZATION} scope; the org is read
-	* from the participant. The state expires after 10 minutes if unused.
+	*
+	* returnTo is echoed back from {@link completeInstall} and may carry query
+	* params (e.g. {@code /projects?openNewProject=1}) so the destination page
+	* can pick up where the user was.
 	*/
-	startInstall(): Promise<string>;
+	startInstall(returnTo: string | null): Promise<string>;
+	/**
+	* Finalises the install once GitHub has redirected the browser back to the SPA
+	* callback. Consumes the staged state, fetches the install details from GitHub,
+	* persists the {@link GitHubAppInstallation} row, and returns it along with the
+	* original intent and returnTo.
+	*/
+	completeInstall(installationId: number, state: string): Promise<GitHubInstallCompletion>;
 	/**
 	* Returns the (at-most-one) installation bound to the caller's organization, or
-	* {@code null} if GitHub is not yet linked. Drives the "linked / not linked"
-	* indicator in the org-settings UI.
+	* null if GitHub is not yet linked. Drives the "linked / not linked" indicator
+	* in the org-settings UI.
 	*/
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
 }
 declare class GitHubAppInstallationService extends CrudServiceProxy9<GitHubAppInstallation> implements IGitHubAppInstallationService {
 	constructor(kinotic: IKinotic12);
-	startInstall(): Promise<string>;
+	startInstall(returnTo: string | null): Promise<string>;
+	completeInstall(installationId: number, state: string): Promise<GitHubInstallCompletion>;
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
 }
-import { CrudServiceProxy as CrudServiceProxy10, IKinotic as IKinotic13, ICrudServiceProxy as ICrudServiceProxy10 } from "@kinotic-ai/core";
-interface IProjectGitHubRepoService extends ICrudServiceProxy10<ProjectGitHubRepoLink> {
-	/**
-	* Lists the repositories visible under the caller's organization's installation.
-	* Calls GitHub on every invocation; not cached because the org admin may have
-	* just toggled repo access.
-	*/
-	listAvailableRepos(): Promise<AvailableRepo[]>;
-	/**
-	* Creates or replaces the link for the given project. Validates that the chosen
-	* {@code repoFullName} is reachable through the org's installation before
-	* persisting.
-	*/
-	linkProject(projectId: string, repoFullName: string): Promise<ProjectGitHubRepoLink>;
-	/** Removes the link for the given project, if any. */
-	unlinkProject(projectId: string): Promise<void>;
-	/** Returns the link for the given project, or {@code null} when none exists. */
-	findByProject(projectId: string): Promise<ProjectGitHubRepoLink | null>;
-}
-declare class ProjectGitHubRepoService extends CrudServiceProxy10<ProjectGitHubRepoLink> implements IProjectGitHubRepoService {
-	constructor(kinotic: IKinotic13);
-	listAvailableRepos(): Promise<AvailableRepo[]>;
-	linkProject(projectId: string, repoFullName: string): Promise<ProjectGitHubRepoLink>;
-	unlinkProject(projectId: string): Promise<void>;
-	findByProject(projectId: string): Promise<ProjectGitHubRepoLink | null>;
-}
 import { KinoticPlugin } from "@kinotic-ai/core";
 interface IOsApiExtension {
 	applications: IApplicationService;
@@ -1130,10 +1118,9 @@ interface IOsApiExtension {
 	workloads: IWorkloadService;
 	iamUsers: IIamUserService;
 	githubAppInstallations: IGitHubAppInstallationService;
-	githubRepoLinks: IProjectGitHubRepoService;
 }
 declare const OsApiPlugin: KinoticPlugin<IOsApiExtension>;
 declare module "@kinotic-ai/core" {
 	interface KinoticSingleton extends IOsApiExtension {}
 }
-export { WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, ProjectGitHubRepoService, ProjectGitHubRepoLink, Project, ProgressType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InsightRequest, InsightProgress, IdDecorator, IamUserService, IamUser, IWorkloadService, IVmNodeService, IProjectService, IProjectGitHubRepoService, IOsApiExtension, IOrganizationService, INamedQueriesDefinitionService, IMigrationService, ILogManager, IIamUserService, IGitHubAppInstallationService, IEntityDefinitionService, IDataInsightsService, IApplicationService, GroupLoggerLevelsDescriptor, GitHubInstallationToken, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DataInsightsService, DataInsightsComponent, AvailableRepo, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };
+export { WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, Project, ProgressType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InsightRequest, InsightProgress, IdDecorator, IamUserService, IamUser, IWorkloadService, IVmNodeService, IProjectService, IOsApiExtension, IOrganizationService, INamedQueriesDefinitionService, IMigrationService, ILogManager, IIamUserService, IGitHubAppInstallationService, IEntityDefinitionService, IDataInsightsService, IApplicationService, GroupLoggerLevelsDescriptor, GitHubToken, GitHubRepoToken, GitHubInstallCompletion, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DataInsightsService, DataInsightsComponent, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };

package/dist/index.d.ts

@@ -198,6 +198,24 @@ declare class Project implements Identifiable3<string> {
 	*/
 	sourceOfTruth: ProjectType | null;
 	/**
+	* Full name ({@code owner/repo}) of the GitHub repository backing this project.
+	* Stamped at create time by the server-side repo provisioner.
+	*/
+	repoFullName: string;
+	/**
+	* GitHub's stable repository id. Survives renames on the GitHub side.
+	*/
+	repoId: number;
+	/**
+	* Default branch of the backing repository at the time it was provisioned.
+	*/
+	defaultBranch: string;
+	/**
+	* Visibility chosen for the backing repository at create time. The SPA sets
+	* this before save; the platform passes it through to GitHub.
+	*/
+	repoPrivate: boolean;
+	/**
 	* The date and time the project was updated.
 	*/
 	updated: number | null;
@@ -562,18 +580,6 @@ interface SignUpCompleteRequest {
 	token: string;
 	password: string;
 }
-/**
-* One row in the repo dropdown shown when linking a project. Carries just enough
-* info for the UI; a successful link round-trips through
-* {@link IProjectGitHubRepoService} which re-validates against GitHub before
-* persisting.
-*/
-declare class AvailableRepo {
-	repoId: string;
-	fullName: string;
-	defaultBranch: string;
-	privateRepo: boolean;
-}
 import { Identifiable as Identifiable9 } from "@kinotic-ai/core";
 /**
 * Persisted record of one GitHub App installation that a Kinotic Org has authorised.
@@ -584,7 +590,7 @@ import { Identifiable as Identifiable9 } from "@kinotic-ai/core";
 declare class GitHubAppInstallation implements Identifiable9<string> {
 	id: string | null;
 	organizationId: string;
-	githubInstallationId: string;
+	githubInstallationId: number;
 	accountLogin: string;
 	accountType: string;
 	suspendedAt: number | null;
@@ -592,37 +598,36 @@ declare class GitHubAppInstallation implements Identifiable9<string> {
 	updated: number | null;
 }
 /**
-* What worker nodes receive when they ask for clone credentials. The token is a
-* short-lived GitHub installation access token scoped to a single repository with
-* {@code contents:read} permission; {@code expiresAt} is the absolute UTC instant
-* (epoch milliseconds).
+* A short-lived GitHub installation access token. Mirrors the Java
+* {@code org.kinotic.github.api.model.GitHubToken}; {@code expiresAt} is the
+* absolute UTC instant (epoch milliseconds) at which GitHub will reject the token.
 */
-declare class GitHubInstallationToken {
-	/** Bearer token to send as {@code Authorization: Bearer <token>} on git over HTTPS. */
+declare class GitHubToken {
+	/** Bearer token to send as {@code Authorization: Bearer <token>}. */
 	token: string;
-	/** Absolute expiry (epoch milliseconds). Workers should not use the token beyond this point. */
+	/** Absolute expiry (epoch milliseconds). Do not use past this point. */
 	expiresAt: number;
-	/** {@code https://github.com/<owner>/<repo>.git} for the linked repo. */
+}
+/**
+* A {@link GitHubToken} bundled with the repository-clone metadata a worker needs
+* to {@code git clone} the project's backing repo. Returned by
+* {@code GitHubProjectRepoService.issueRepoToken}.
+*/
+declare class GitHubRepoToken extends GitHubToken {
+	/** {@code https://github.com/<owner>/<repo>.git} for the project's repo. */
 	cloneUrl: string;
-	/** Default branch on the linked repo (e.g. {@code main}). */
+	/** Default branch on the repo (e.g. {@code main}). */
 	defaultBranch: string;
 }
-import { Identifiable as Identifiable10 } from "@kinotic-ai/core";
 /**
-* Persisted link between a Kinotic Project and a single GitHub repository reachable
-* through an existing {@link GitHubAppInstallation}. Drives webhook dispatch
-* (delivery → project) and ref-creation auth (project → which repo, via which
-* installation).
+* Result of finalising a GitHub install round-trip. {@code returnTo} echoes what
+* the SPA staged when it called {@code startInstall(...)} and may carry query
+* params (e.g. {@code /projects?openNewProject=1}) so the destination page can
+* pick up where the user was.
 */
-declare class ProjectGitHubRepoLink implements Identifiable10<string> {
-	id: string | null;
-	projectId: string;
-	organizationId: string;
-	installationId: string;
-	repoFullName: string;
-	repoId: string;
-	defaultBranch: string;
-	updated: number | null;
+declare class GitHubInstallCompletion {
+	installation: GitHubAppInstallation;
+	returnTo: string | null;
 }
 /**
 * Configuration for a single entities path and its corresponding repository output.
@@ -1070,52 +1075,35 @@ declare class IamUserService extends CrudServiceProxy8<IamUser> implements IIamU
 import { CrudServiceProxy as CrudServiceProxy9, IKinotic as IKinotic12, ICrudServiceProxy as ICrudServiceProxy9 } from "@kinotic-ai/core";
 interface IGitHubAppInstallationService extends ICrudServiceProxy9<GitHubAppInstallation> {
 	/**
-	* Stages a single-use {@code state} token bound to the caller's organization in
-	* a cluster-wide store, then returns the GitHub install URL with that state
+	* Stages a single-use state token bound to the caller's organization plus the
+	* supplied returnTo, then returns the GitHub install URL with that state
 	* embedded. The SPA performs {@code window.location = url}.
-	* <p>
-	* Caller must be authenticated under {@code ORGANIZATION} scope; the org is read
-	* from the participant. The state expires after 10 minutes if unused.
+	*
+	* returnTo is echoed back from {@link completeInstall} and may carry query
+	* params (e.g. {@code /projects?openNewProject=1}) so the destination page
+	* can pick up where the user was.
 	*/
-	startInstall(): Promise<string>;
+	startInstall(returnTo: string | null): Promise<string>;
+	/**
+	* Finalises the install once GitHub has redirected the browser back to the SPA
+	* callback. Consumes the staged state, fetches the install details from GitHub,
+	* persists the {@link GitHubAppInstallation} row, and returns it along with the
+	* original intent and returnTo.
+	*/
+	completeInstall(installationId: number, state: string): Promise<GitHubInstallCompletion>;
 	/**
 	* Returns the (at-most-one) installation bound to the caller's organization, or
-	* {@code null} if GitHub is not yet linked. Drives the "linked / not linked"
-	* indicator in the org-settings UI.
+	* null if GitHub is not yet linked. Drives the "linked / not linked" indicator
+	* in the org-settings UI.
 	*/
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
 }
 declare class GitHubAppInstallationService extends CrudServiceProxy9<GitHubAppInstallation> implements IGitHubAppInstallationService {
 	constructor(kinotic: IKinotic12);
-	startInstall(): Promise<string>;
+	startInstall(returnTo: string | null): Promise<string>;
+	completeInstall(installationId: number, state: string): Promise<GitHubInstallCompletion>;
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
 }
-import { CrudServiceProxy as CrudServiceProxy10, IKinotic as IKinotic13, ICrudServiceProxy as ICrudServiceProxy10 } from "@kinotic-ai/core";
-interface IProjectGitHubRepoService extends ICrudServiceProxy10<ProjectGitHubRepoLink> {
-	/**
-	* Lists the repositories visible under the caller's organization's installation.
-	* Calls GitHub on every invocation; not cached because the org admin may have
-	* just toggled repo access.
-	*/
-	listAvailableRepos(): Promise<AvailableRepo[]>;
-	/**
-	* Creates or replaces the link for the given project. Validates that the chosen
-	* {@code repoFullName} is reachable through the org's installation before
-	* persisting.
-	*/
-	linkProject(projectId: string, repoFullName: string): Promise<ProjectGitHubRepoLink>;
-	/** Removes the link for the given project, if any. */
-	unlinkProject(projectId: string): Promise<void>;
-	/** Returns the link for the given project, or {@code null} when none exists. */
-	findByProject(projectId: string): Promise<ProjectGitHubRepoLink | null>;
-}
-declare class ProjectGitHubRepoService extends CrudServiceProxy10<ProjectGitHubRepoLink> implements IProjectGitHubRepoService {
-	constructor(kinotic: IKinotic13);
-	listAvailableRepos(): Promise<AvailableRepo[]>;
-	linkProject(projectId: string, repoFullName: string): Promise<ProjectGitHubRepoLink>;
-	unlinkProject(projectId: string): Promise<void>;
-	findByProject(projectId: string): Promise<ProjectGitHubRepoLink | null>;
-}
 import { KinoticPlugin } from "@kinotic-ai/core";
 interface IOsApiExtension {
 	applications: IApplicationService;
@@ -1130,10 +1118,9 @@ interface IOsApiExtension {
 	workloads: IWorkloadService;
 	iamUsers: IIamUserService;
 	githubAppInstallations: IGitHubAppInstallationService;
-	githubRepoLinks: IProjectGitHubRepoService;
 }
 declare const OsApiPlugin: KinoticPlugin<IOsApiExtension>;
 declare module "@kinotic-ai/core" {
 	interface KinoticSingleton extends IOsApiExtension {}
 }
-export { WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, ProjectGitHubRepoService, ProjectGitHubRepoLink, Project, ProgressType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InsightRequest, InsightProgress, IdDecorator, IamUserService, IamUser, IWorkloadService, IVmNodeService, IProjectService, IProjectGitHubRepoService, IOsApiExtension, IOrganizationService, INamedQueriesDefinitionService, IMigrationService, ILogManager, IIamUserService, IGitHubAppInstallationService, IEntityDefinitionService, IDataInsightsService, IApplicationService, GroupLoggerLevelsDescriptor, GitHubInstallationToken, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DataInsightsService, DataInsightsComponent, AvailableRepo, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };
+export { WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, Project, ProgressType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InsightRequest, InsightProgress, IdDecorator, IamUserService, IamUser, IWorkloadService, IVmNodeService, IProjectService, IOsApiExtension, IOrganizationService, INamedQueriesDefinitionService, IMigrationService, ILogManager, IIamUserService, IGitHubAppInstallationService, IEntityDefinitionService, IDataInsightsService, IApplicationService, GroupLoggerLevelsDescriptor, GitHubToken, GitHubRepoToken, GitHubInstallCompletion, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DataInsightsService, DataInsightsComponent, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };

package/dist/index.js

@@ -202,6 +202,10 @@ class Project {
   name;
   description;
   sourceOfTruth = null;
+  repoFullName;
+  repoId;
+  defaultBranch;
+  repoPrivate = true;
   updated = null;
   constructor(id, applicationId, name, description) {
     this.id = id;
@@ -351,41 +355,31 @@ class IamUser {
   created = null;
   updated = null;
 }
-// packages/os-api/src/api/model/github/AvailableRepo.ts
-class AvailableRepo {
-  repoId = "";
-  fullName = "";
-  defaultBranch = "";
-  privateRepo = false;
-}
 // packages/os-api/src/api/model/github/GitHubAppInstallation.ts
 class GitHubAppInstallation {
   id = null;
   organizationId = "";
-  githubInstallationId = "";
+  githubInstallationId = 0;
   accountLogin = "";
   accountType = "";
   suspendedAt = null;
   created = null;
   updated = null;
 }
-// packages/os-api/src/api/model/github/GitHubInstallationToken.ts
-class GitHubInstallationToken {
+// packages/os-api/src/api/model/github/GitHubToken.ts
+class GitHubToken {
   token = "";
   expiresAt = 0;
+}
+// packages/os-api/src/api/model/github/GitHubRepoToken.ts
+class GitHubRepoToken extends GitHubToken {
   cloneUrl = "";
   defaultBranch = "";
 }
-// packages/os-api/src/api/model/github/ProjectGitHubRepoLink.ts
-class ProjectGitHubRepoLink {
-  id = null;
-  projectId = "";
-  organizationId = "";
-  installationId = "";
-  repoFullName = "";
-  repoId = "";
-  defaultBranch = "";
-  updated = null;
+// packages/os-api/src/api/model/github/GitHubInstallCompletion.ts
+class GitHubInstallCompletion {
+  installation;
+  returnTo = null;
 }
 // packages/os-api/src/api/model/KinoticProjectConfig.ts
 class KinoticProjectConfig {
@@ -647,33 +641,16 @@ class GitHubAppInstallationService extends CrudServiceProxy9 {
   constructor(kinotic) {
     super(kinotic.serviceProxy("org.kinotic.github.api.services.GitHubAppInstallationService"));
   }
-  startInstall() {
-    return this.serviceProxy.invoke("startInstall", []);
+  startInstall(returnTo) {
+    return this.serviceProxy.invoke("startInstall", [returnTo]);
+  }
+  completeInstall(installationId, state) {
+    return this.serviceProxy.invoke("completeInstall", [installationId, state]);
   }
   findForCurrentOrg() {
     return this.serviceProxy.invoke("findForCurrentOrg", []);
   }
 }
-// packages/os-api/src/api/services/IProjectGitHubRepoService.ts
-import { CrudServiceProxy as CrudServiceProxy10 } from "@kinotic-ai/core";
-
-class ProjectGitHubRepoService extends CrudServiceProxy10 {
-  constructor(kinotic) {
-    super(kinotic.serviceProxy("org.kinotic.github.api.services.ProjectGitHubRepoService"));
-  }
-  listAvailableRepos() {
-    return this.serviceProxy.invoke("listAvailableRepos", []);
-  }
-  linkProject(projectId, repoFullName) {
-    return this.serviceProxy.invoke("linkProject", [projectId, repoFullName]);
-  }
-  unlinkProject(projectId) {
-    return this.serviceProxy.invoke("unlinkProject", [projectId]);
-  }
-  findByProject(projectId) {
-    return this.serviceProxy.invoke("findByProject", [projectId]);
-  }
-}
 // packages/os-api/src/api/OsApiPlugin.ts
 var OsApiPlugin = {
   install(kinotic) {
@@ -689,8 +666,7 @@ var OsApiPlugin = {
       vmNodes: new VmNodeServiceProxy(kinotic),
       workloads: new WorkloadServiceProxy(kinotic),
       iamUsers: new IamUserService(kinotic),
-      githubAppInstallations: new GitHubAppInstallationService(kinotic),
-      githubRepoLinks: new ProjectGitHubRepoService(kinotic)
+      githubAppInstallations: new GitHubAppInstallationService(kinotic)
     };
   }
 };
@@ -712,8 +688,6 @@ export {
   QueryDecorator,
   ProjectType,
   ProjectService,
-  ProjectGitHubRepoService,
-  ProjectGitHubRepoLink,
   Project,
   ProgressType,
   PageableC3Type,
@@ -735,7 +709,9 @@ export {
   IamUserService,
   IamUser,
   GroupLoggerLevelsDescriptor,
-  GitHubInstallationToken,
+  GitHubToken,
+  GitHubRepoToken,
+  GitHubInstallCompletion,
   GitHubAppInstallationService,
   GitHubAppInstallation,
   FlattenedDecorator,
@@ -745,7 +721,6 @@ export {
   EntityDecorator,
   DiscriminatorDecorator,
   DataInsightsService,
-  AvailableRepo,
   AutoGeneratedIdDecorator,
   AuthType,
   ApplicationService,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kinotic-ai/os-api",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "files": [
     "dist"
@@ -41,7 +41,7 @@
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@kinotic-ai/core": "1.2.1",
+    "@kinotic-ai/core": "1.2.2",
     "@types/node": "^25.3.2",
     "@vitest/coverage-v8": "^4.0.18",
     "@vitest/runner": "^4.0.18",