@tarkahq/sdk 0.0.0-stage → 0.3.0

package/dist/cjs/generated/tarka/provisioning/v1/source_builds.d.ts

@@ -0,0 +1,291 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "tarka.provisioning.v1";
+/**
+ * Copyright 2026 Tarka
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * GitHub authorization is human-only, organization-admin scoped and one-use.
+ * The returned URL uses PKCE. No GitHub credential is returned by any RPC.
+ */
+export interface StartGitHubSourceAuthorizationRequest {
+    orgId: string;
+}
+export interface GitHubSourceAuthorization {
+    id: string;
+    authorizationUrl: string;
+    expiresAt: Date | undefined;
+}
+export interface ListGitHubSourceInstallationsRequest {
+    orgId: string;
+    authorizationId: string;
+}
+export interface GitHubSourceInstallation {
+    id: bigint;
+    account: string;
+}
+export interface ListGitHubSourceInstallationsResponse {
+    installations: GitHubSourceInstallation[];
+    installationUrl: string;
+}
+export interface ListGitHubSourceRepositoriesRequest {
+    orgId: string;
+    authorizationId: string;
+    installationId: bigint;
+}
+/** Metadata is the intersection of the authorizing user's and App's access. */
+export interface GitHubSourceRepository {
+    id: bigint;
+    fullName: string;
+    defaultBranch: string;
+    private: boolean;
+}
+export interface ListGitHubSourceRepositoriesResponse {
+    repositories: GitHubSourceRepository[];
+}
+export interface ConnectGitHubSourceRequest {
+    orgId: string;
+    authorizationId: string;
+    installationId: bigint;
+    repositoryIds: bigint[];
+}
+export interface SourceRepository {
+    id: string;
+    fullName: string;
+    defaultBranch: string;
+    status: string;
+}
+export interface SourceConnection {
+    id: string;
+    provider: string;
+    status: string;
+    repositories: SourceRepository[];
+}
+export interface ListSourceConnectionsRequest {
+    orgId: string;
+}
+export interface ListSourceConnectionsResponse {
+    connections: SourceConnection[];
+}
+export interface DisconnectSourceConnectionRequest {
+    orgId: string;
+    connectionId: string;
+}
+/** Connect an already owned Hosted Git resource. No clone credential is supplied. */
+export interface ConnectHostedGitSourceRequest {
+    orgId: string;
+    repositoryId: string;
+}
+/**
+ * Paths are local to the source archive. Builds are linux/amd64; no remote
+ * contexts, forwarded secrets, SSH, privileged entitlements or shared caches.
+ */
+export interface SourceBuildService {
+    name: string;
+    context: string;
+    dockerfile: string;
+}
+export interface SourceBuildConfig {
+    services: SourceBuildService[];
+    /** Repository-relative Compose file. Empty for legacy manually configured builds. */
+    composePath: string;
+}
+export interface GetSourceCapabilitiesRequest {
+    orgId: string;
+}
+export interface GetSourceCapabilitiesResponse {
+    githubConnections: boolean;
+    hostedGitConnections: boolean;
+    builds: boolean;
+}
+/**
+ * Resolve a branch once and inspect its Compose file without executing source.
+ * Empty compose_path discovers compose.yaml, compose.yml, docker-compose.yaml,
+ * then docker-compose.yml. A preview neither starts a build nor creates a host.
+ */
+export interface PreviewSourceRequest {
+    orgId: string;
+    repositoryId: string;
+    branch: string;
+    composePath: string;
+}
+export interface PreviewSourceResponse {
+    repositoryId: string;
+    branch: string;
+    commitSha: string;
+    composePath: string;
+    composeYaml: string;
+    config: SourceBuildConfig | undefined;
+}
+/**
+ * Produce a complete Compose revision using only the successful build's
+ * immutable images. The ordinary host quote/apply flow still grants consent.
+ */
+export interface PrepareSourceDeploymentRequest {
+    orgId: string;
+    buildId: string;
+}
+export interface PrepareSourceDeploymentResponse {
+    composeYaml: string;
+    commitSha: string;
+    images: {
+        [key: string]: string;
+    };
+}
+export interface PrepareSourceDeploymentResponse_ImagesEntry {
+    key: string;
+    value: string;
+}
+/**
+ * Creating a target does not create a host or grant price/deployment consent.
+ * Set auto_build explicitly to build future pushes to this exact branch.
+ */
+export interface PutSourceTargetRequest {
+    orgId: string;
+    name: string;
+    repositoryId: string;
+    branch: string;
+    config: SourceBuildConfig | undefined;
+    autoBuild: boolean;
+    /** Required for an existing target; prevents stale configuration replacement. */
+    expectedVersion: string;
+}
+export interface SourceTarget {
+    id: string;
+    name: string;
+    repositoryId: string;
+    branch: string;
+    config: SourceBuildConfig | undefined;
+    autoBuild: boolean;
+    version: string;
+}
+export interface ListSourceTargetsRequest {
+    orgId: string;
+}
+export interface ListSourceTargetsResponse {
+    targets: SourceTarget[];
+}
+/**
+ * An immutable commit must belong to the configured repository. The backend
+ * verifies source access again when fetching. Idempotency keys are org scoped.
+ */
+export interface StartSourceBuildRequest {
+    orgId: string;
+    targetId: string;
+    commitSha: string;
+    idempotencyKey: string;
+}
+export interface GetSourceBuildRequest {
+    orgId: string;
+    buildId: string;
+}
+export interface CancelSourceBuildRequest {
+    orgId: string;
+    buildId: string;
+}
+export interface ListSourceBuildsRequest {
+    orgId: string;
+    targetId: string;
+}
+export interface ListSourceBuildsResponse {
+    builds: SourceBuild[];
+}
+export interface SourceBuild {
+    id: string;
+    targetId: string;
+    commitSha: string;
+    branch: string;
+    /** queued, fetching, building, publishing, scanning, succeeded, failed, cancelled. */
+    status: string;
+    cancelRequested: boolean;
+    errorCode: string;
+    /** Complete immutable per-service image references, usable by ordinary host apply. */
+    images: {
+        [key: string]: string;
+    };
+    createdAt: Date | undefined;
+    startedAt: Date | undefined;
+    finishedAt: Date | undefined;
+    /** Included allowance only; monetary cost is zero while this policy is active. */
+    allowanceConsumed: boolean;
+}
+export interface SourceBuild_ImagesEntry {
+    key: string;
+    value: string;
+}
+export interface GetSourceBuildLogsRequest {
+    orgId: string;
+    buildId: string;
+    /** Zero for the first page, otherwise the next_sequence returned previously. */
+    fromSequence: bigint;
+}
+export interface SourceBuildLogChunk {
+    sequence: bigint;
+    text: string;
+}
+/**
+ * Logs are customer-controlled text: render as escaped plain text, never HTML.
+ * At most 256 KiB per response, 10 MiB per build and seven days retention.
+ */
+export interface GetSourceBuildLogsResponse {
+    chunks: SourceBuildLogChunk[];
+    nextSequence: bigint;
+    truncated: boolean;
+}
+export declare const StartGitHubSourceAuthorizationRequest: MessageFns<StartGitHubSourceAuthorizationRequest>;
+export declare const GitHubSourceAuthorization: MessageFns<GitHubSourceAuthorization>;
+export declare const ListGitHubSourceInstallationsRequest: MessageFns<ListGitHubSourceInstallationsRequest>;
+export declare const GitHubSourceInstallation: MessageFns<GitHubSourceInstallation>;
+export declare const ListGitHubSourceInstallationsResponse: MessageFns<ListGitHubSourceInstallationsResponse>;
+export declare const ListGitHubSourceRepositoriesRequest: MessageFns<ListGitHubSourceRepositoriesRequest>;
+export declare const GitHubSourceRepository: MessageFns<GitHubSourceRepository>;
+export declare const ListGitHubSourceRepositoriesResponse: MessageFns<ListGitHubSourceRepositoriesResponse>;
+export declare const ConnectGitHubSourceRequest: MessageFns<ConnectGitHubSourceRequest>;
+export declare const SourceRepository: MessageFns<SourceRepository>;
+export declare const SourceConnection: MessageFns<SourceConnection>;
+export declare const ListSourceConnectionsRequest: MessageFns<ListSourceConnectionsRequest>;
+export declare const ListSourceConnectionsResponse: MessageFns<ListSourceConnectionsResponse>;
+export declare const DisconnectSourceConnectionRequest: MessageFns<DisconnectSourceConnectionRequest>;
+export declare const ConnectHostedGitSourceRequest: MessageFns<ConnectHostedGitSourceRequest>;
+export declare const SourceBuildService: MessageFns<SourceBuildService>;
+export declare const SourceBuildConfig: MessageFns<SourceBuildConfig>;
+export declare const GetSourceCapabilitiesRequest: MessageFns<GetSourceCapabilitiesRequest>;
+export declare const GetSourceCapabilitiesResponse: MessageFns<GetSourceCapabilitiesResponse>;
+export declare const PreviewSourceRequest: MessageFns<PreviewSourceRequest>;
+export declare const PreviewSourceResponse: MessageFns<PreviewSourceResponse>;
+export declare const PrepareSourceDeploymentRequest: MessageFns<PrepareSourceDeploymentRequest>;
+export declare const PrepareSourceDeploymentResponse: MessageFns<PrepareSourceDeploymentResponse>;
+export declare const PrepareSourceDeploymentResponse_ImagesEntry: MessageFns<PrepareSourceDeploymentResponse_ImagesEntry>;
+export declare const PutSourceTargetRequest: MessageFns<PutSourceTargetRequest>;
+export declare const SourceTarget: MessageFns<SourceTarget>;
+export declare const ListSourceTargetsRequest: MessageFns<ListSourceTargetsRequest>;
+export declare const ListSourceTargetsResponse: MessageFns<ListSourceTargetsResponse>;
+export declare const StartSourceBuildRequest: MessageFns<StartSourceBuildRequest>;
+export declare const GetSourceBuildRequest: MessageFns<GetSourceBuildRequest>;
+export declare const CancelSourceBuildRequest: MessageFns<CancelSourceBuildRequest>;
+export declare const ListSourceBuildsRequest: MessageFns<ListSourceBuildsRequest>;
+export declare const ListSourceBuildsResponse: MessageFns<ListSourceBuildsResponse>;
+export declare const SourceBuild: MessageFns<SourceBuild>;
+export declare const SourceBuild_ImagesEntry: MessageFns<SourceBuild_ImagesEntry>;
+export declare const GetSourceBuildLogsRequest: MessageFns<GetSourceBuildLogsRequest>;
+export declare const SourceBuildLogChunk: MessageFns<SourceBuildLogChunk>;
+export declare const GetSourceBuildLogsResponse: MessageFns<GetSourceBuildLogsResponse>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    $case: string;
+    value: unknown;
+} ? {
+    $case: T["$case"];
+    value?: DeepPartial<T["value"]>;
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create(base?: DeepPartial<T>): T;
+    fromPartial(object: DeepPartial<T>): T;
+}
+export {};