@graph8/sdk 0.13.1 → 0.15.0

package/dist/react.d.ts

@@ -1552,6 +1552,8 @@ declare const createInboxClient: (apiKey: string, apiUrl?: string) => {
 };
 
 interface Deal {
+    /** Canonical CRM revision returned by a conditional update. */
+    revision?: number | null;
     id: string | null;
     name: string | null;
     description: string | null;
@@ -1616,6 +1618,8 @@ interface DealCreateParams {
     allow_duplicate?: boolean;
 }
 interface DealUpdateParams {
+    /** Require this current CRM revision; a stale edit returns HTTP 409. */
+    expected_revision?: number;
     name?: string;
     description?: string;
     amount?: number;
@@ -1741,6 +1745,7 @@ declare const createDealsClient: (apiKey: string, apiUrl?: string) => {
     }>;
 };
 
+type CustomObjectIcon = "box" | "briefcase" | "building" | "calendar" | "flag" | "folder" | "globe" | "heart" | "layers" | "package" | "target" | "users";
 /** A custom object type in your workspace — a record type you define. */
 interface CustomObject {
     /** Stable API slug, e.g. `invoices`. */
@@ -1750,6 +1755,28 @@ interface CustomObject {
     /** True for object types graph8 ships; system objects cannot be deleted. */
     is_system: boolean;
     is_archived: boolean;
+    /** Presentation settings may be absent on older servers. */
+    description?: string | null;
+    icon?: string | null;
+    display_attribute_slug?: string | null;
+}
+/** Native schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObject {
+    slug: string;
+    singular_noun: string;
+    plural_noun: string;
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+}
+/** Omitted labels/state are preserved. The API slug is immutable. */
+interface UpdateCustomObject {
+    singular_noun?: string;
+    plural_noun?: string;
+    is_archived?: boolean;
+    /** Omit to preserve; null clears the setting. */
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+    display_attribute_slug?: string | null;
 }
 /**
  * One attribute on a custom object, and the rules its values must satisfy.
@@ -1762,6 +1789,15 @@ interface CustomObject {
  */
 interface CustomObjectAttribute {
     slug: string;
+    /** Customer-facing label. Display metadata is absent on older servers. */
+    title?: string;
+    description?: string | null;
+    /** Display order; ties are ordered by slug. */
+    sort_order?: number;
+    /** Protected system field rather than a customer-defined field. */
+    is_system?: boolean;
+    /** Archive state; absent on older servers. */
+    is_archived?: boolean;
     attribute_type: string;
     is_required: boolean;
     /** No two ACTIVE records may hold the same value. A collision returns 409. */
@@ -1774,6 +1810,24 @@ interface CustomObjectAttribute {
     /** Type-specific configuration, e.g. the allowed options for a `select`. */
     config: Record<string, unknown>;
 }
+/** Schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObjectAttribute {
+    slug: string;
+    title: string;
+    attribute_type: "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference";
+    description?: string | null;
+    is_required?: boolean;
+    is_unique?: boolean;
+    is_multiselect?: boolean;
+    is_default_value_enabled?: boolean;
+    default_value?: unknown;
+    config?: Record<string, unknown>;
+    sort_order?: number;
+}
+/** Omitted fields are preserved; explicit null can clear the configured default. */
+type UpdateCustomObjectAttribute = Partial<Omit<CreateCustomObjectAttribute, "slug" | "attribute_type">> & {
+    is_archived?: boolean;
+};
 /** One record, with its currently active attribute values. */
 interface CustomObjectRecord {
     id: string;
@@ -1804,6 +1858,29 @@ interface CustomObjectHistory {
     record_id: string;
     entries: CustomObjectHistoryEntry[];
 }
+interface CustomObjectMutation {
+    id: string;
+    action: "created" | "updated" | "archived" | "restored";
+    occurred_at: string;
+    revision: number;
+    actor_id: string | null;
+    actor_type: "user" | "api" | "app" | "integration" | "system";
+    source: string;
+    app_id: string | null;
+    changes: Record<string, {
+        before_present: boolean;
+        before: unknown;
+        after_present: boolean;
+        after: unknown;
+    }>;
+    was_archived: boolean;
+    is_archived: boolean;
+}
+interface CustomObjectMutations {
+    record_id: string;
+    entries: CustomObjectMutation[];
+    next_cursor: string | null;
+}
 interface ListRecordsParams {
     page?: number;
     /** 1-200, default 50. */
@@ -1868,16 +1945,33 @@ interface ObjectPagination {
  */
 declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
     /** List the custom object types in your workspace. */
-    list(): Promise<{
+    list(params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObject[];
     }>;
+    /** Create a native custom object. Requires objects:manage and Admin access. */
+    create(input: CreateCustomObject): Promise<CustomObject>;
+    /** Rename, archive or restore an object while preserving its slug and data. */
+    update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+    /** Archive the object without deleting records; restore with update({ is_archived: false }). */
+    archive(objectSlug: string): Promise<CustomObject>;
     /** Fetch one object type by slug. */
     get(objectSlug: string): Promise<CustomObject>;
     /** The object's attributes — the schema its records must satisfy. */
-    listAttributes(objectSlug: string): Promise<{
+    listAttributes(objectSlug: string, params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObjectAttribute[];
     }>;
-    /** Paginated records with their current values. Archived records are excluded. */
+    /** Create a field using the same schema rules as the customer UI. */
+    createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Edit or restore a field; its type and slug are immutable. */
+    updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Archive without deleting values; restore with updateAttribute({ is_archived: false }). */
+    archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
+    /** Paginated custom records or canonical deals with current values and revisions.
+     * Deal totals and related references respect current record access. */
     listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
         data: CustomObjectRecord[];
         pagination?: ObjectPagination;
@@ -1888,18 +1982,28 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * unique attribute is a 409.
      */
     createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
-    /** Fetch one record with its currently active values. */
+    /** Match a unique single-value key, creating or updating while preserving omitted fields. */
+    upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+        expectedRevision?: number;
+    }): Promise<CustomObjectRecord>;
+    /** Fetch one custom record, canonical contact/company, or deal by its stable graph8 ID.
+     * Deals retain their UUIDs and expose company, primary-contact and contact_ids references only
+     * when permitted. Generic deal mutations are not yet supported.
+     */
     getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
     /**
      * Update a record. PARTIAL: only the attributes you send are touched, so
      * required attributes you omit are left alone rather than reported missing.
      * Sending an explicit `null` CLEARS that attribute.
      *
-     * Values are versioned rather than overwritten, so the previous value stays
-     * readable through `history`.
+     * Custom values retain generations through `history`. Canonical contacts and
+     * companies require expectedRevision from a fresh read and expose recorded
+     * mutations through `changes`. They do not yet support appendValues/removeValues.
      */
     updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
         expectedRevision?: number;
+        appendValues?: Record<string, unknown[]>;
+        removeValues?: Record<string, unknown[]>;
     }): Promise<CustomObjectRecord>;
     /**
      * Archive a record. It leaves listings, stays readable by id, and keeps its
@@ -1913,6 +2017,280 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * null is the value currently in force.
      */
     history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+    /** Recorded custom-record or canonical contact/company mutations. Pass next_cursor to continue.
+     * Canonical history respects current access/privacy; archived records and older
+     * unrecorded writes are not reconstructed. Store unavailability returns 503.
+     */
+    changes(objectSlug: string, recordId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CustomObjectMutations>;
+};
+
+/**
+ * Hosted app platform — deployments, domains, secrets, source and logs (M9 J14).
+ *
+ * WHAT WAS MISSING. `apps.ts` covered creating an app and reading its installs,
+ * usage and limit. Everything that actually SHIPS one -- binding a source,
+ * queueing a deployment, promoting it, attaching a hostname, reading why a build
+ * failed -- had no client at all. That is why the build portal is read-only: not
+ * because the routes are absent, but because nothing typed reached them.
+ *
+ * EVERY RESPONSE ON THIS SURFACE IS WRAPPED as `{data, pagination}`, and
+ * `pagination` is always null here -- none of these routes paginate. The helpers
+ * below unwrap `data` so callers work with the record, except where the list IS
+ * the answer.
+ *
+ * DELIBERATELY ABSENT, and each for a reason:
+ *
+ *   * `POST /apps/{id}/deployments/{id}/status` -- authenticated with the build
+ *     CONTROLLER credential, not a builder's API key. An SDK method for it would
+ *     imply a customer can move their own deployment through the state machine.
+ *   * `GET /app-platform/tls-authorize` -- Caddy's on-demand-TLS ask hook. Public,
+ *     unauthenticated, returns a bare 200 or 404 with no body. It is edge
+ *     plumbing, not a customer API.
+ */
+/** The six frozen values. Not widened to `string`: a client that switches on the
+ *  status should get a compile error when a new state is added. */
+type DeploymentStatus = "queued" | "building" | "promoting" | "deployed" | "failed" | "rolled_back";
+type DomainVerificationStatus = "pending" | "verified" | "failed" | "revoked";
+type SourceProvider = "github" | "gitlab" | "bitbucket";
+type SchemaVersionStatus = "draft" | "published" | "deprecated";
+interface Deployment {
+    deployment_id: string;
+    app_id: string;
+    /** One of `DeploymentStatus`. Typed as the union, but the server sends a plain
+     *  string -- treat an unrecognised value as forward compatibility, not an error. */
+    status: DeploymentStatus;
+    source_ref: string | null;
+    image_digest: string | null;
+    schema_version_id: string | null;
+    /** Sanitized at the WRITE. One line. The detail is in `logs()`. */
+    last_error_sanitized: string | null;
+    created_at: string | null;
+    deployed_at: string | null;
+    build_started_at: string | null;
+    build_finished_at: string | null;
+    /** Measured `building` -> `promoting`, NOT to `deployed`: `deployed` is reached
+     *  after traffic is taken, so measuring to it would count the promotion too. */
+    build_seconds: number | null;
+}
+interface CreateDeploymentParams {
+    /** A COMMIT-ish, never a branch name. A branch moves, so a deployment recorded
+     *  against one cannot answer "what is running right now" a week later. The
+     *  server enforces length only -- this convention is the caller's to keep. */
+    source_ref: string;
+    /** Pins the custom-object schema this build expects, so a rollback restores the
+     *  matching schema and not merely the matching image. */
+    schema_version_id?: string;
+}
+interface AppDomain {
+    domain_id: string;
+    app_id: string;
+    /** The canonical normalized form -- lowercased, trailing dot stripped, IDNA
+     *  encoded. NOT what you submitted. */
+    hostname: string;
+    status: DomainVerificationStatus;
+    verification_token: string | null;
+    created_at: string | null;
+    verified_at: string | null;
+}
+interface DomainVerificationInstructions {
+    domain: AppDomain;
+    record_type: "TXT";
+    record_name: string;
+    record_value: string;
+}
+interface AppSecretMetadata {
+    secret_key: string;
+    /** A POINTER into your secret manager, never the secret. graph8 has no column
+     *  for a value and cannot grow one. */
+    provider_ref: string | null;
+    created_at: string | null;
+    rotated_at: string | null;
+}
+interface AppSourceParams {
+    repo_url: string;
+    provider: SourceProvider;
+    default_branch?: string;
+    credential_ref?: string;
+}
+interface SchemaVersion {
+    schema_version_id: string;
+    app_id: string;
+    version: number;
+    digest: string;
+    status: SchemaVersionStatus;
+    manifest: Record<string, unknown>;
+    created_at: string | null;
+    published_at: string | null;
+    deprecated_at: string | null;
+}
+interface ContainerLog {
+    pod: string;
+    container: string;
+    /** `init` steps run to completion before the pod's containers start. A build is
+     *  four init steps (fetch, scan-source, build, scan-image) then one container
+     *  (push), so this is how you tell which step you are looking at. */
+    kind: "init" | "container";
+    text: string;
+    /** The tail hit the per-container byte cap. Earlier output exists and was not
+     *  returned. */
+    truncated: boolean;
+}
+interface AppLogs {
+    app_id: string;
+    /** Set for build logs; null for the running app's logs. */
+    deployment_id: string | null;
+    namespace: string;
+    tail_lines: number;
+    /**
+     * Always true, and it means only that graph8's credential patterns ran.
+     * It is NOT a claim the output is safe to publish: these are your own build and
+     * application logs, and an application can print a secret in a shape no pattern
+     * matches.
+     */
+    redacted: boolean;
+    containers: ContainerLog[];
+}
+declare const createAppPlatformClient: (apiKey: string, apiUrl?: string) => {
+    /**
+     * Bind the repository an app builds from.
+     *
+     * `repo_url` must be fetchable -- `https://`, `ssh://` or `git@`, with no
+     * whitespace. A `file://` or bare path is refused with 422, because a build
+     * that can read the builder's filesystem is a build that can read ours.
+     *
+     * `credential_ref` is a POINTER into your secret manager, not a token.
+     */
+    setSource(appId: string, params: AppSourceParams): Promise<Record<string, unknown>>;
+    /** Unbind the source. Returns the full app with every source field null. */
+    clearSource(appId: string): Promise<Record<string, unknown>>;
+    /** Every deployment for this app, newest first. Never 404s for an app with none. */
+    listDeployments(appId: string): Promise<{
+        data: Deployment[];
+    }>;
+    /**
+     * Queue a deployment. Returns `201` with `status: "queued"` -- nothing builds
+     * as a side effect of this call; the build controller picks it up.
+     *
+     * NOT idempotent: two identical calls create two deployments.
+     */
+    deploy(appId: string, params: CreateDeploymentParams): Promise<Deployment>;
+    /** Fetch one deployment. The polling endpoint for a build loop. */
+    getDeployment(appId: string, deploymentId: string): Promise<Deployment>;
+    /**
+     * The deployment currently serving traffic, or `null`.
+     *
+     * `null` is a real answer with a 200, not a 404: "this app has never shipped"
+     * is information, while a 404 would read as "no such app".
+     */
+    activeDeployment(appId: string): Promise<Deployment | null>;
+    /**
+     * Promote a built deployment to serve traffic. Anything it displaces moves to
+     * `rolled_back` in the same transaction, so there is never a moment with two
+     * live deployments.
+     *
+     * `409` when the state machine forbids it -- a deployment cannot become
+     * `deployed` without having been built, and a `failed` one cannot be revived.
+     * A retry is a new deployment, not a resurrection.
+     */
+    promote(appId: string, deploymentId: string, imageDigest: string): Promise<Deployment>;
+    /** Roll back a deployment that is currently serving. Only a `deployed` one may be. */
+    rollback(appId: string, deploymentId: string): Promise<Deployment>;
+    /**
+     * Why a build failed. Returns every step of the build pod in the order
+     * Kubernetes runs them; a step that has not started yet is omitted rather
+     * than returned empty.
+     *
+     * An empty `containers` list is not an error -- build pods are reaped an hour
+     * after they finish, so logs for an older deployment are genuinely gone.
+     * `last_error_sanitized` on the deployment is what survives.
+     *
+     * `503` means graph8 could not reach the cluster, which is deliberately
+     * different from an empty `200`: one means we could not look, the other means
+     * your build produced no output.
+     */
+    deploymentLogs(appId: string, deploymentId: string, tailLines?: number): Promise<AppLogs>;
+    /**
+     * What the running app is printing. The app's own pods only -- the per-app
+     * egress proxy shares the namespace and is deliberately excluded.
+     *
+     * Empty until a deployment reaches `deployed`.
+     */
+    logs(appId: string, tailLines?: number): Promise<AppLogs>;
+    /** Every hostname claimed for this app, whatever its verification state. */
+    listDomains(appId: string): Promise<{
+        data: AppDomain[];
+    }>;
+    /**
+     * Claim a hostname and get the TXT record that proves you own it.
+     *
+     * Returns `201`, and the domain is NESTED at `data.domain` -- this is the one
+     * route on the surface whose payload is not the record itself. Hostnames are
+     * globally unique, so a host another app holds is refused.
+     */
+    claimDomain(appId: string, hostname: string): Promise<DomainVerificationInstructions>;
+    /**
+     * Check DNS for the TXT record and advance the domain to `verified`.
+     *
+     * Idempotent: verifying an already-verified domain re-checks and stays
+     * verified, so it is safe to re-run after a DNS change. Send no body -- the
+     * record in DNS is the payload.
+     */
+    verifyDomain(appId: string, hostname: string): Promise<AppDomain>;
+    /**
+     * Release a claimed hostname.
+     *
+     * A HARD delete. Hostnames are globally unique, so a row left behind in any
+     * status keeps the host burned for every other builder. Releasing one you
+     * already released is a `404`, because after the first call the claim
+     * genuinely does not exist.
+     *
+     * Returns the NORMALIZED hostname, which may differ from what you passed.
+     */
+    releaseDomain(appId: string, hostname: string): Promise<{
+        hostname: string;
+        released: boolean;
+    }>;
+    /**
+     * Which secrets this app declares, and when each was last rotated.
+     *
+     * NEVER returns a value. graph8 stores a POINTER into your secret manager and
+     * has no column for the secret itself.
+     */
+    listSecrets(appId: string): Promise<{
+        data: AppSecretMetadata[];
+    }>;
+    /**
+     * Declare a secret, or rotate the pointer to it.
+     *
+     * `providerRef` is a REFERENCE, and the server rejects anything that looks
+     * like a credential -- a value starting `bearer `, `sk-`, `ghp_`, `xox` and
+     * friends is a 422. That refusal is the feature: it catches the mistake of
+     * pasting the secret where its address belongs.
+     */
+    putSecret(appId: string, secretKey: string, providerRef?: string): Promise<AppSecretMetadata>;
+    /** Undeclare a secret. A key the app never declared is a 404, so a typo is
+     *  never reported as a successful removal. */
+    deleteSecret(appId: string, secretKey: string): Promise<{
+        secret_key: string;
+        removed: boolean;
+    }>;
+    /**
+     * Publish a custom-object schema version. Returns `201`.
+     *
+     * Takes only the `objects` list, not a whole `graph8.app.yaml`: the rest of
+     * that file is app metadata the control plane already holds, and accepting it
+     * here would create a second place for it to disagree.
+     */
+    publishSchemaVersion(appId: string, objects: unknown[]): Promise<{
+        version: SchemaVersion;
+    }>;
+    /** Every schema version this app has published. Empty array, never 404. */
+    listSchemaVersions(appId: string): Promise<{
+        data: SchemaVersion[];
+    }>;
 };
 
 /**
@@ -2515,7 +2893,7 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
 type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 interface WebhookEventPayload {
@@ -2523,7 +2901,7 @@ interface WebhookEventPayload {
     timestamp: string;
     data: Record<string, unknown>;
     org_id: string;
-    /** Stable per-delivery id (present once the backend adds it; for consumer dedup). */
+    /** Stable event ID for consumer deduplication; delivery ID is in X-Studio-Delivery-Id. */
     id?: string;
 }
 interface ConstructEventOptions {
@@ -2542,7 +2920,7 @@ declare const createWebhooksClient: (_apiKey: string, apiUrl?: string) => {
     /** Base URL the webhook subscription API lives under. */
     baseUrl: string;
     /** Known event types (for autocomplete / validation). */
-    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
     /** Verify an incoming webhook's HMAC signature and return the parsed event. */
     constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
 };
@@ -3499,6 +3877,7 @@ declare const useG8: () => {
         _tasks: ReturnType<typeof createTasksClient> | null;
         _fields: ReturnType<typeof createFieldsClient> | null;
         _apps: ReturnType<typeof createAppsClient> | null;
+        _appPlatform: ReturnType<typeof createAppPlatformClient> | null;
         _objects: ReturnType<typeof createObjectsClient> | null;
         _deals: ReturnType<typeof createDealsClient> | null;
         _inbox: ReturnType<typeof createInboxClient> | null;
@@ -3648,7 +4027,7 @@ declare const useG8: () => {
         };
         get webhooks(): {
             baseUrl: string;
-            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
             constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
         };
         get contacts(): {
@@ -3772,26 +4151,82 @@ declare const useG8: () => {
             usage(appId: string, period?: string): Promise<AppUsageSummary>;
             getLimit(appId: string): Promise<AppLimit | null>;
         };
+        get appPlatform(): {
+            setSource(appId: string, params: AppSourceParams): Promise<Record<string, unknown>>;
+            clearSource(appId: string): Promise<Record<string, unknown>>;
+            listDeployments(appId: string): Promise<{
+                data: Deployment[];
+            }>;
+            deploy(appId: string, params: CreateDeploymentParams): Promise<Deployment>;
+            getDeployment(appId: string, deploymentId: string): Promise<Deployment>;
+            activeDeployment(appId: string): Promise<Deployment | null>;
+            promote(appId: string, deploymentId: string, imageDigest: string): Promise<Deployment>;
+            rollback(appId: string, deploymentId: string): Promise<Deployment>;
+            deploymentLogs(appId: string, deploymentId: string, tailLines?: number): Promise<AppLogs>;
+            logs(appId: string, tailLines?: number): Promise<AppLogs>;
+            listDomains(appId: string): Promise<{
+                data: AppDomain[];
+            }>;
+            claimDomain(appId: string, hostname: string): Promise<DomainVerificationInstructions>;
+            verifyDomain(appId: string, hostname: string): Promise<AppDomain>;
+            releaseDomain(appId: string, hostname: string): Promise<{
+                hostname: string;
+                released: boolean;
+            }>;
+            listSecrets(appId: string): Promise<{
+                data: AppSecretMetadata[];
+            }>;
+            putSecret(appId: string, secretKey: string, providerRef?: string): Promise<AppSecretMetadata>;
+            deleteSecret(appId: string, secretKey: string): Promise<{
+                secret_key: string;
+                removed: boolean;
+            }>;
+            publishSchemaVersion(appId: string, objects: unknown[]): Promise<{
+                version: SchemaVersion;
+            }>;
+            listSchemaVersions(appId: string): Promise<{
+                data: SchemaVersion[];
+            }>;
+        };
         get objects(): {
-            list(): Promise<{
+            list(params?: {
+                include_archived?: boolean;
+            }): Promise<{
                 data: CustomObject[];
             }>;
+            create(input: CreateCustomObject): Promise<CustomObject>;
+            update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+            archive(objectSlug: string): Promise<CustomObject>;
             get(objectSlug: string): Promise<CustomObject>;
-            listAttributes(objectSlug: string): Promise<{
+            listAttributes(objectSlug: string, params?: {
+                include_archived?: boolean;
+            }): Promise<{
                 data: CustomObjectAttribute[];
             }>;
+            createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+            updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+            archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
             listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
                 data: CustomObjectRecord[];
                 pagination?: ObjectPagination;
             }>;
             createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
+            upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+                expectedRevision?: number;
+            }): Promise<CustomObjectRecord>;
             getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
                 expectedRevision?: number;
+                appendValues?: Record<string, unknown[]>;
+                removeValues?: Record<string, unknown[]>;
             }): Promise<CustomObjectRecord>;
             archiveRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             restoreRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+            changes(objectSlug: string, recordId: string, options?: {
+                limit?: number;
+                cursor?: string;
+            }): Promise<CustomObjectMutations>;
         };
         get deals(): {
             pipelines(): Promise<{