@zavudev/sdk 0.55.0 → 0.56.0

package/resources/functions/git-link.d.mts

@@ -0,0 +1,295 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class GitLink extends APIResource {
+    /**
+     * The link and its last deploy. Never returns the webhook secret.
+     *
+     * @example
+     * ```ts
+     * const gitLink = await client.functions.gitLink.retrieve(
+     *   'functionId',
+     * );
+     * ```
+     */
+    retrieve(functionID: string, options?: RequestOptions): APIPromise<GitLinkRetrieveResponse>;
+    /**
+     * Change the branch, the root directory, or whether pushes deploy. Pass at least
+     * one field. `rootDir: null` clears the subdirectory.
+     *
+     * @example
+     * ```ts
+     * const gitLink = await client.functions.gitLink.update(
+     *   'functionId',
+     * );
+     * ```
+     */
+    update(functionID: string, body: GitLinkUpdateParams, options?: RequestOptions): APIPromise<GitLinkUpdateResponse>;
+    /**
+     * Fetch the linked branch and deploy it without waiting for a push. Returns
+     * immediately; follow the outcome with `GET /v1/functions/{functionId}/git-link`,
+     * whose `lastStatus` and `lastError` describe the run.
+     *
+     * @example
+     * ```ts
+     * const response = await client.functions.gitLink.deployNow(
+     *   'functionId',
+     * );
+     * ```
+     */
+    deployNow(functionID: string, options?: RequestOptions): APIPromise<GitLinkDeployNowResponse>;
+    /**
+     * Bind a repository to this function so every push to `branch` deploys it. A
+     * function holds at most one link; linking again returns 400.
+     *
+     * **The server decides how the link authenticates.** If the project has the Zavu
+     * GitHub App installed, the link uses that installation: private repositories work
+     * and there is nothing to configure in the repository. Otherwise it falls back to
+     * a manual link and the response carries a `webhookSecret` you add to the
+     * repository yourself. `connection` says which one you got.
+     *
+     * The repository is not checked against GitHub here, because it cannot be: an
+     * owner/repo that does not exist, or that the installation cannot see, is accepted
+     * and fails on the first deploy with a fetch error.
+     *
+     * @example
+     * ```ts
+     * const response = await client.functions.gitLink.link(
+     *   'functionId',
+     *   {
+     *     owner: 'acme',
+     *     repo: 'order-bot',
+     *     branch: 'main',
+     *   },
+     * );
+     * ```
+     */
+    link(functionID: string, body: GitLinkLinkParams, options?: RequestOptions): APIPromise<GitLinkLinkResponse>;
+    /**
+     * Remove the link. The function and its deployments stay. A manual webhook left in
+     * the repository stops being accepted, so remove it there too.
+     *
+     * @example
+     * ```ts
+     * await client.functions.gitLink.unlink('functionId');
+     * ```
+     */
+    unlink(functionID: string, options?: RequestOptions): APIPromise<void>;
+}
+export interface GitLinkRetrieveResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    link: GitLinkRetrieveResponse.Link;
+    /**
+     * Endpoint that receives GitHub's push deliveries. Only needed on a `manual` link,
+     * where you add it to the repository yourself.
+     */
+    webhookUrl: string;
+    /**
+     * Shared secret for the repository's webhook. **Returned only when creating a
+     * `manual` link, and only there** — every later read strips it, and re-linking
+     * mints a new one. Absent entirely on an `app` link, which needs no secret of its
+     * own.
+     */
+    webhookSecret?: string;
+}
+export declare namespace GitLinkRetrieveResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    interface Link {
+        id: string;
+        /**
+         * When false the link is kept and pushes are ignored.
+         */
+        autoDeploy: boolean;
+        /**
+         * Only pushes to this branch deploy.
+         */
+        branch: string;
+        /**
+         * How this link authenticates, decided by the server rather than by the caller.
+         *
+         * - `app`: the Zavu GitHub App is installed on the account. Pushes arrive on the
+         *   app's webhook and private repositories work. Nothing to configure in the
+         *   repository.
+         * - `manual`: no installation. The link carries its own secret and you add the
+         *   webhook to the repository yourself.
+         */
+        connection: 'app' | 'manual';
+        createdAt: string;
+        functionId: string;
+        owner: string;
+        provider: 'github';
+        repo: string;
+        updatedAt: string;
+        lastCommitMessage?: string | null;
+        lastCommitSha?: string | null;
+        lastDeployAt?: string | null;
+        /**
+         * Why the last deploy failed. Null otherwise.
+         */
+        lastError?: string | null;
+        lastStatus?: 'deploying' | 'deployed' | 'failed' | null;
+        /**
+         * Subdirectory holding the project, for monorepos. Null when the project is at the
+         * repository root.
+         */
+        rootDir?: string | null;
+    }
+}
+export interface GitLinkUpdateResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    link: GitLinkUpdateResponse.Link;
+    /**
+     * Endpoint that receives GitHub's push deliveries. Only needed on a `manual` link,
+     * where you add it to the repository yourself.
+     */
+    webhookUrl: string;
+    /**
+     * Shared secret for the repository's webhook. **Returned only when creating a
+     * `manual` link, and only there** — every later read strips it, and re-linking
+     * mints a new one. Absent entirely on an `app` link, which needs no secret of its
+     * own.
+     */
+    webhookSecret?: string;
+}
+export declare namespace GitLinkUpdateResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    interface Link {
+        id: string;
+        /**
+         * When false the link is kept and pushes are ignored.
+         */
+        autoDeploy: boolean;
+        /**
+         * Only pushes to this branch deploy.
+         */
+        branch: string;
+        /**
+         * How this link authenticates, decided by the server rather than by the caller.
+         *
+         * - `app`: the Zavu GitHub App is installed on the account. Pushes arrive on the
+         *   app's webhook and private repositories work. Nothing to configure in the
+         *   repository.
+         * - `manual`: no installation. The link carries its own secret and you add the
+         *   webhook to the repository yourself.
+         */
+        connection: 'app' | 'manual';
+        createdAt: string;
+        functionId: string;
+        owner: string;
+        provider: 'github';
+        repo: string;
+        updatedAt: string;
+        lastCommitMessage?: string | null;
+        lastCommitSha?: string | null;
+        lastDeployAt?: string | null;
+        /**
+         * Why the last deploy failed. Null otherwise.
+         */
+        lastError?: string | null;
+        lastStatus?: 'deploying' | 'deployed' | 'failed' | null;
+        /**
+         * Subdirectory holding the project, for monorepos. Null when the project is at the
+         * repository root.
+         */
+        rootDir?: string | null;
+    }
+}
+export interface GitLinkDeployNowResponse {
+    scheduled: boolean;
+}
+export interface GitLinkLinkResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    link: GitLinkLinkResponse.Link;
+    /**
+     * Endpoint that receives GitHub's push deliveries. Only needed on a `manual` link,
+     * where you add it to the repository yourself.
+     */
+    webhookUrl: string;
+    /**
+     * Shared secret for the repository's webhook. **Returned only when creating a
+     * `manual` link, and only there** — every later read strips it, and re-linking
+     * mints a new one. Absent entirely on an `app` link, which needs no secret of its
+     * own.
+     */
+    webhookSecret?: string;
+}
+export declare namespace GitLinkLinkResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    interface Link {
+        id: string;
+        /**
+         * When false the link is kept and pushes are ignored.
+         */
+        autoDeploy: boolean;
+        /**
+         * Only pushes to this branch deploy.
+         */
+        branch: string;
+        /**
+         * How this link authenticates, decided by the server rather than by the caller.
+         *
+         * - `app`: the Zavu GitHub App is installed on the account. Pushes arrive on the
+         *   app's webhook and private repositories work. Nothing to configure in the
+         *   repository.
+         * - `manual`: no installation. The link carries its own secret and you add the
+         *   webhook to the repository yourself.
+         */
+        connection: 'app' | 'manual';
+        createdAt: string;
+        functionId: string;
+        owner: string;
+        provider: 'github';
+        repo: string;
+        updatedAt: string;
+        lastCommitMessage?: string | null;
+        lastCommitSha?: string | null;
+        lastDeployAt?: string | null;
+        /**
+         * Why the last deploy failed. Null otherwise.
+         */
+        lastError?: string | null;
+        lastStatus?: 'deploying' | 'deployed' | 'failed' | null;
+        /**
+         * Subdirectory holding the project, for monorepos. Null when the project is at the
+         * repository root.
+         */
+        rootDir?: string | null;
+    }
+}
+export interface GitLinkUpdateParams {
+    autoDeploy?: boolean;
+    branch?: string;
+    rootDir?: string | null;
+}
+export interface GitLinkLinkParams {
+    owner: string;
+    repo: string;
+    autoDeploy?: boolean;
+    branch?: string;
+    /**
+     * Subdirectory holding the project, for monorepos.
+     */
+    rootDir?: string;
+}
+export declare namespace GitLink {
+    export { type GitLinkRetrieveResponse as GitLinkRetrieveResponse, type GitLinkUpdateResponse as GitLinkUpdateResponse, type GitLinkDeployNowResponse as GitLinkDeployNowResponse, type GitLinkLinkResponse as GitLinkLinkResponse, type GitLinkUpdateParams as GitLinkUpdateParams, type GitLinkLinkParams as GitLinkLinkParams, };
+}
+//# sourceMappingURL=git-link.d.mts.map

package/resources/functions/git-link.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-link.d.mts","sourceRoot":"","sources":["../../src/resources/functions/git-link.ts"],"names":[],"mappings":"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"}

package/resources/functions/git-link.d.ts

@@ -0,0 +1,295 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class GitLink extends APIResource {
+    /**
+     * The link and its last deploy. Never returns the webhook secret.
+     *
+     * @example
+     * ```ts
+     * const gitLink = await client.functions.gitLink.retrieve(
+     *   'functionId',
+     * );
+     * ```
+     */
+    retrieve(functionID: string, options?: RequestOptions): APIPromise<GitLinkRetrieveResponse>;
+    /**
+     * Change the branch, the root directory, or whether pushes deploy. Pass at least
+     * one field. `rootDir: null` clears the subdirectory.
+     *
+     * @example
+     * ```ts
+     * const gitLink = await client.functions.gitLink.update(
+     *   'functionId',
+     * );
+     * ```
+     */
+    update(functionID: string, body: GitLinkUpdateParams, options?: RequestOptions): APIPromise<GitLinkUpdateResponse>;
+    /**
+     * Fetch the linked branch and deploy it without waiting for a push. Returns
+     * immediately; follow the outcome with `GET /v1/functions/{functionId}/git-link`,
+     * whose `lastStatus` and `lastError` describe the run.
+     *
+     * @example
+     * ```ts
+     * const response = await client.functions.gitLink.deployNow(
+     *   'functionId',
+     * );
+     * ```
+     */
+    deployNow(functionID: string, options?: RequestOptions): APIPromise<GitLinkDeployNowResponse>;
+    /**
+     * Bind a repository to this function so every push to `branch` deploys it. A
+     * function holds at most one link; linking again returns 400.
+     *
+     * **The server decides how the link authenticates.** If the project has the Zavu
+     * GitHub App installed, the link uses that installation: private repositories work
+     * and there is nothing to configure in the repository. Otherwise it falls back to
+     * a manual link and the response carries a `webhookSecret` you add to the
+     * repository yourself. `connection` says which one you got.
+     *
+     * The repository is not checked against GitHub here, because it cannot be: an
+     * owner/repo that does not exist, or that the installation cannot see, is accepted
+     * and fails on the first deploy with a fetch error.
+     *
+     * @example
+     * ```ts
+     * const response = await client.functions.gitLink.link(
+     *   'functionId',
+     *   {
+     *     owner: 'acme',
+     *     repo: 'order-bot',
+     *     branch: 'main',
+     *   },
+     * );
+     * ```
+     */
+    link(functionID: string, body: GitLinkLinkParams, options?: RequestOptions): APIPromise<GitLinkLinkResponse>;
+    /**
+     * Remove the link. The function and its deployments stay. A manual webhook left in
+     * the repository stops being accepted, so remove it there too.
+     *
+     * @example
+     * ```ts
+     * await client.functions.gitLink.unlink('functionId');
+     * ```
+     */
+    unlink(functionID: string, options?: RequestOptions): APIPromise<void>;
+}
+export interface GitLinkRetrieveResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    link: GitLinkRetrieveResponse.Link;
+    /**
+     * Endpoint that receives GitHub's push deliveries. Only needed on a `manual` link,
+     * where you add it to the repository yourself.
+     */
+    webhookUrl: string;
+    /**
+     * Shared secret for the repository's webhook. **Returned only when creating a
+     * `manual` link, and only there** — every later read strips it, and re-linking
+     * mints a new one. Absent entirely on an `app` link, which needs no secret of its
+     * own.
+     */
+    webhookSecret?: string;
+}
+export declare namespace GitLinkRetrieveResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    interface Link {
+        id: string;
+        /**
+         * When false the link is kept and pushes are ignored.
+         */
+        autoDeploy: boolean;
+        /**
+         * Only pushes to this branch deploy.
+         */
+        branch: string;
+        /**
+         * How this link authenticates, decided by the server rather than by the caller.
+         *
+         * - `app`: the Zavu GitHub App is installed on the account. Pushes arrive on the
+         *   app's webhook and private repositories work. Nothing to configure in the
+         *   repository.
+         * - `manual`: no installation. The link carries its own secret and you add the
+         *   webhook to the repository yourself.
+         */
+        connection: 'app' | 'manual';
+        createdAt: string;
+        functionId: string;
+        owner: string;
+        provider: 'github';
+        repo: string;
+        updatedAt: string;
+        lastCommitMessage?: string | null;
+        lastCommitSha?: string | null;
+        lastDeployAt?: string | null;
+        /**
+         * Why the last deploy failed. Null otherwise.
+         */
+        lastError?: string | null;
+        lastStatus?: 'deploying' | 'deployed' | 'failed' | null;
+        /**
+         * Subdirectory holding the project, for monorepos. Null when the project is at the
+         * repository root.
+         */
+        rootDir?: string | null;
+    }
+}
+export interface GitLinkUpdateResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    link: GitLinkUpdateResponse.Link;
+    /**
+     * Endpoint that receives GitHub's push deliveries. Only needed on a `manual` link,
+     * where you add it to the repository yourself.
+     */
+    webhookUrl: string;
+    /**
+     * Shared secret for the repository's webhook. **Returned only when creating a
+     * `manual` link, and only there** — every later read strips it, and re-linking
+     * mints a new one. Absent entirely on an `app` link, which needs no secret of its
+     * own.
+     */
+    webhookSecret?: string;
+}
+export declare namespace GitLinkUpdateResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    interface Link {
+        id: string;
+        /**
+         * When false the link is kept and pushes are ignored.
+         */
+        autoDeploy: boolean;
+        /**
+         * Only pushes to this branch deploy.
+         */
+        branch: string;
+        /**
+         * How this link authenticates, decided by the server rather than by the caller.
+         *
+         * - `app`: the Zavu GitHub App is installed on the account. Pushes arrive on the
+         *   app's webhook and private repositories work. Nothing to configure in the
+         *   repository.
+         * - `manual`: no installation. The link carries its own secret and you add the
+         *   webhook to the repository yourself.
+         */
+        connection: 'app' | 'manual';
+        createdAt: string;
+        functionId: string;
+        owner: string;
+        provider: 'github';
+        repo: string;
+        updatedAt: string;
+        lastCommitMessage?: string | null;
+        lastCommitSha?: string | null;
+        lastDeployAt?: string | null;
+        /**
+         * Why the last deploy failed. Null otherwise.
+         */
+        lastError?: string | null;
+        lastStatus?: 'deploying' | 'deployed' | 'failed' | null;
+        /**
+         * Subdirectory holding the project, for monorepos. Null when the project is at the
+         * repository root.
+         */
+        rootDir?: string | null;
+    }
+}
+export interface GitLinkDeployNowResponse {
+    scheduled: boolean;
+}
+export interface GitLinkLinkResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    link: GitLinkLinkResponse.Link;
+    /**
+     * Endpoint that receives GitHub's push deliveries. Only needed on a `manual` link,
+     * where you add it to the repository yourself.
+     */
+    webhookUrl: string;
+    /**
+     * Shared secret for the repository's webhook. **Returned only when creating a
+     * `manual` link, and only there** — every later read strips it, and re-linking
+     * mints a new one. Absent entirely on an `app` link, which needs no secret of its
+     * own.
+     */
+    webhookSecret?: string;
+}
+export declare namespace GitLinkLinkResponse {
+    /**
+     * A GitHub repository bound to a function. A push to `branch` deploys the
+     * function. A function holds at most one link.
+     */
+    interface Link {
+        id: string;
+        /**
+         * When false the link is kept and pushes are ignored.
+         */
+        autoDeploy: boolean;
+        /**
+         * Only pushes to this branch deploy.
+         */
+        branch: string;
+        /**
+         * How this link authenticates, decided by the server rather than by the caller.
+         *
+         * - `app`: the Zavu GitHub App is installed on the account. Pushes arrive on the
+         *   app's webhook and private repositories work. Nothing to configure in the
+         *   repository.
+         * - `manual`: no installation. The link carries its own secret and you add the
+         *   webhook to the repository yourself.
+         */
+        connection: 'app' | 'manual';
+        createdAt: string;
+        functionId: string;
+        owner: string;
+        provider: 'github';
+        repo: string;
+        updatedAt: string;
+        lastCommitMessage?: string | null;
+        lastCommitSha?: string | null;
+        lastDeployAt?: string | null;
+        /**
+         * Why the last deploy failed. Null otherwise.
+         */
+        lastError?: string | null;
+        lastStatus?: 'deploying' | 'deployed' | 'failed' | null;
+        /**
+         * Subdirectory holding the project, for monorepos. Null when the project is at the
+         * repository root.
+         */
+        rootDir?: string | null;
+    }
+}
+export interface GitLinkUpdateParams {
+    autoDeploy?: boolean;
+    branch?: string;
+    rootDir?: string | null;
+}
+export interface GitLinkLinkParams {
+    owner: string;
+    repo: string;
+    autoDeploy?: boolean;
+    branch?: string;
+    /**
+     * Subdirectory holding the project, for monorepos.
+     */
+    rootDir?: string;
+}
+export declare namespace GitLink {
+    export { type GitLinkRetrieveResponse as GitLinkRetrieveResponse, type GitLinkUpdateResponse as GitLinkUpdateResponse, type GitLinkDeployNowResponse as GitLinkDeployNowResponse, type GitLinkLinkResponse as GitLinkLinkResponse, type GitLinkUpdateParams as GitLinkUpdateParams, type GitLinkLinkParams as GitLinkLinkParams, };
+}
+//# sourceMappingURL=git-link.d.ts.map

package/resources/functions/git-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-link.d.ts","sourceRoot":"","sources":["../../src/resources/functions/git-link.ts"],"names":[],"mappings":"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"}