@fabrika/control-contract 0.0.8 → 0.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fabrika/control-contract",
-	"version": "0.0.8",
+	"version": "0.0.9",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -24,7 +24,7 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"@fabrika/app": "^0.0.8",
-		"@fabrika/provider-contract": "^0.0.8"
+		"@fabrika/app": "^0.0.9",
+		"@fabrika/provider-contract": "^0.0.9"
 	}
 }

package/src/index.ts

@@ -81,6 +81,50 @@ export interface GitHubSourceConnectionConnectedDto extends GitHubSourceConnecti
 	readonly installation: GitHubSourceConnectionInstallationDto
 }
 
+export type GitHubSourceConnectionWorkflowDto = Exclude<GitHubSourceConnectionStatusDto, GitHubSourceConnectionConnectedDto>
+
+export const GITHUB_SOURCE_CONNECTION_DEFAULT_PAGE_SIZE = 50
+export const GITHUB_SOURCE_CONNECTION_MAX_PAGE_SIZE = 100
+export const GITHUB_SOURCE_CONNECTION_PAGE_CURSOR_MAX_LENGTH = 512
+
+export interface GitHubSourceConnectionListInput {
+	readonly cursor?: string
+	readonly limit?: number
+}
+
+export interface GitHubSourceConnectionListResponse {
+	readonly items: readonly GitHubSourceConnectionConnectedDto[]
+	readonly nextCursor: string | null
+	/** The one global non-connected workflow state, when present. */
+	readonly workflow: GitHubSourceConnectionWorkflowDto | null
+}
+
+export function decodeGitHubSourceConnectionListInput(value: unknown): GitHubSourceConnectionListInput {
+	if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+		throw new Error('source connection list input must be an object')
+	}
+	const unknownField = Object.keys(value).find((key) => key !== 'cursor' && key !== 'limit')
+	if (unknownField !== undefined) throw new Error('source connection list input contains an unknown field')
+	const cursorValue = Reflect.get(value, 'cursor')
+	if (
+		cursorValue !== undefined
+		&& (typeof cursorValue !== 'string' || cursorValue.length === 0 || cursorValue.length > GITHUB_SOURCE_CONNECTION_PAGE_CURSOR_MAX_LENGTH)
+	) {
+		throw new Error(`source connection list cursor must be a non-empty string of at most ${GITHUB_SOURCE_CONNECTION_PAGE_CURSOR_MAX_LENGTH} characters`)
+	}
+	const limitValue = Reflect.get(value, 'limit')
+	if (
+		limitValue !== undefined
+		&& (typeof limitValue !== 'number' || !Number.isSafeInteger(limitValue) || limitValue < 1 || limitValue > GITHUB_SOURCE_CONNECTION_MAX_PAGE_SIZE)
+	) {
+		throw new Error(`source connection list limit must be an integer from 1 to ${GITHUB_SOURCE_CONNECTION_MAX_PAGE_SIZE}`)
+	}
+	return {
+		...(cursorValue !== undefined ? { cursor: cursorValue } : {}),
+		...(limitValue !== undefined ? { limit: limitValue } : {}),
+	}
+}
+
 export interface GitHubSourceConnectionRepairRequiredDto extends GitHubSourceConnectionBaseDto {
 	readonly state: 'repair-required'
 	readonly connectionId: string
@@ -133,6 +177,7 @@ export interface AppDto {
 	workerDir: string | null
 	buildCmd: string | null
 	configPath: string | null
+	githubConnectionId?: string | null
 	githubInstallationId: number | null
 	createdAt: number
 }

package/src/rpc.ts

@@ -9,6 +9,8 @@ import type {
 	CursorList,
 	DeploymentNamespaceDetailDto,
 	DeploymentNamespaceListResponse,
+	GitHubSourceConnectionListInput,
+	GitHubSourceConnectionListResponse,
 	GitHubSourceConnectionStatusDto,
 	ListResponse,
 	PlanDeploymentNamespaceRequest,
@@ -103,6 +105,7 @@ export interface GitHubSourceConnectionInput {
 /** Provider-neutral admin seam. A statically composed provider implements these GitHub operations. */
 export interface GitHubSourceConnectionRpcContract {
 	status: RpcProcedure<void, GitHubSourceConnectionStatusDto>
+	list: RpcProcedure<GitHubSourceConnectionListInput, GitHubSourceConnectionListResponse>
 	start: RpcProcedure<StartGitHubSourceConnectionRequest, StartGitHubSourceConnectionResponse>
 	adoptExisting: RpcProcedure<void, GitHubSourceConnectionStatusDto>
 	verifyInstallation: RpcProcedure<GitHubSourceConnectionInput, GitHubSourceConnectionStatusDto>