Google Calendar

Use the @bijection/connectors/google-calendar entrypoint to declare Google Calendar resources.

Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. Source build and package availability.

Resources and modes

Resource	Mode	Description
Calendar	`incremental`	incremental

Declare a resource in application code, then bind deployment-specific settings and credentials. See typed resources, connections and source inspection.

Calendar

incremental: incremental

The following example matches configuration standard.

import { googleCalendar } from "@bijection/connectors/google-calendar";
import { makeFunctionReference } from "bijection/server";

export const events = googleCalendar.calendar.incremental({
  governingRules: {
    updateEvent: makeFunctionReference<"query", any, [null]>(
      "calendar:canUpdate",
    ),
    createFollowing: makeFunctionReference<"query", any, [null]>(
      "calendar:canCreateFollowing",
    ),
  },
});

Inferred record types

{
  "calendar_event_id": string;
  "status": string;
  "title": string | null;
  "event": { location?: string | undefined; summary?: string | undefined; start?: { date?: string | undefined; dateTime?: string | undefined; timeZone?: string | undefined; } | undefined; end?: { date?: string | undefined; dateTime?: string | undefined; timeZone?: string | undefined; } | undefined; recurrence?: string[] | undefined; description?: string | undefined; updated?: string | undefined; etag?: string | undefined; recurringEventId?: string | undefined; originalStartTime?: { date?: string | undefined; dateTime?: string | undefined; timeZone?: string | undefined; } | undefined; iCalUID?: string | undefined; reminders?: { overrides?: { method: string; minutes: number; }[] | undefined; useDefault: boolean; } | undefined; id: string; status: string; };
}

The function references identify application policy queries. Implement those policies in your application; the references alone grant no authority.

Configuration: standard

Case: google-calendar/calendar/incremental/standard. Connection and resource configuration are declared by this exact case. Credential kind: google-calendar. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`calendarId`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "google-calendar",
    "output": {
      "kind": "single",
      "collection": "events"
    },
    "credential_kind": "google-calendar",
    "connection_fields": [],
    "selection_field": "calendarId",
    "address": {
      "kind": "path",
      "base": "https://www.googleapis.com/calendar/v3/calendars",
      "segments": [
        {
          "field": "calendarId"
        }
      ]
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "calendarId": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: events

Contract	Meaning
Initial	Current membership
Changes	Repeated observations of current records
Deletions	Withdrawal from selected scope
Resume	Opaque cursor
Gap	Explicit repair required after a gap
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "events": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "401": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "403": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": true,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "410": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "500": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "502": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "503": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "504": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange events",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "listener changes",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "current_membership",
  "changes": "observations",
  "deletions": "scope_membership",
  "resume": "opaque_cursor",
  "retentionMs": null,
  "gap": "explicit_repair",
  "limits": {
    "http_response_bytes": "524288",
    "initial_rows": "128"
  },
  "restrictions": [],
  "commands": {
    "createFollowing": {
      "target": "events",
      "delivery": "single_attempt",
      "condition": "unconditional",
      "replayWindowMs": null,
      "maxDeliveryHours": "1",
      "providerEnforcedExpiry": false
    },
    "updateEvent": {
      "target": "events",
      "delivery": "single_attempt",
      "condition": "target_version",
      "replayWindowMs": null,
      "maxDeliveryHours": "1",
      "providerEnforcedExpiry": false
    }
  }
}

Commands

Command	Target	Condition	Delivery
`createFollowing`	events	Unconditional	Single dispatch attempt
`updateEvent`	events	Target version precondition	Single dispatch attempt

Commands, occurrences and artifacts

{
  "records": {
    "events": {
      "protocol": "record_observation",
      "coverage": "incremental_snapshot",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": true,
      "snapshotMaxRows": "128",
      "profile": {
        "movement": {
          "exchanges": {
            "events": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "401": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "403": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": true,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "410": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "500": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "502": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "503": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "504": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange events",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "listener changes",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "current_membership",
        "changes": "observations",
        "deletions": "scope_membership",
        "resume": "opaque_cursor",
        "retentionMs": null,
        "gap": "explicit_repair",
        "limits": {
          "http_response_bytes": "524288",
          "initial_rows": "128"
        },
        "restrictions": [],
        "commands": {
          "createFollowing": {
            "target": "events",
            "delivery": "single_attempt",
            "condition": "unconditional",
            "replayWindowMs": null,
            "maxDeliveryHours": "1",
            "providerEnforcedExpiry": false
          },
          "updateEvent": {
            "target": "events",
            "delivery": "single_attempt",
            "condition": "target_version",
            "replayWindowMs": null,
            "maxDeliveryHours": "1",
            "providerEnforcedExpiry": false
          }
        }
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {
    "createFollowing": {
      "target": "events",
      "condition": {
        "kind": "unconditional"
      },
      "delivery": {
        "kind": "single_attempt",
        "retention": {
          "kind": "stated",
          "unit": "days",
          "value": 1
        },
        "max_delivery_hours": 1
      }
    },
    "updateEvent": {
      "target": "events",
      "condition": {
        "kind": "target_version",
        "from": {
          "kind": "record_version"
        }
      },
      "delivery": {
        "kind": "single_attempt",
        "retention": {
          "kind": "stated",
          "unit": "days",
          "value": 1
        },
        "max_delivery_hours": 1
      }
    }
  }
}

Recorded checks

Requirement	Scope	Evidence	Result
listener-custody-before-ack	{“kind”:“listener”,“collection”:“events”}	Calendar notifications are body-free refresh hints; no history asserts custody before acknowledging one.	Execution result unavailable
listener-duplicate-delivery	{“kind”:“listener”,“collection”:“events”}	Native test: integrations/listeners/calendar_uncertain_watch_uses_late_hint_without_resending (shared_engine)	Execution result unavailable
incremental-token-reset	{“kind”:“collection”,“name”:“events”}	Fixture: ./src/connectors/google-calendar/fixtures/sync-token-reset.json	passed (2026-10-24T21:36:12.053Z)
incremental-token-reset	{“kind”:“collection”,“name”:“events”}	Native test: integrations/listeners/calendar_listener_pages_follow_up_reset_and_retirement (shared_engine)	Execution result unavailable
page-publication-recovery	{“kind”:“collection”,“name”:“events”}	Native test: integrations/listeners/postgres_calendar_process_kill_recovers_private_page_and_pending_refresh (shared_engine)	Execution result unavailable
stated-cursor-empty-page-advances	{“kind”:“collection”,“name”:“events”}	No retained check covers this scoped google-calendar requirement.	Execution result unavailable
stated-cursor-repeat-refused	{“kind”:“collection”,“name”:“events”}	No retained check covers this scoped google-calendar requirement.	Execution result unavailable
command-response-lost	{“kind”:“command”,“name”:“createFollowing”}	Native test: integrations/listeners/calendar_repair_preserves_accepted_responsibility (shared_engine)	Execution result unavailable
command-response-lost	{“kind”:“command”,“name”:“updateEvent”}	Native test: integrations/listeners/calendar_repair_preserves_accepted_responsibility (shared_engine)	Execution result unavailable
discovery-page	{“kind”:“connection”}	Fixture: ./src/connectors/google-calendar/fixtures/discovery.json	passed (2026-10-24T21:36:12.054Z)
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/google-calendar/fixtures/identity.json	passed (2026-10-24T21:36:12.055Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Provider guidance

Compiled declaration examples and configuration details are published in the connector reference. The connection holds an OAuth google-calendar credential (googleCalendar.credential). Each binding selects one calendar with calendarId; discovery lists the calendars the connection can select. Writes are conditioned on the event’s opaque etag and authorized by the application’s governing rules. Semantics come from the admitted declaration: an incremental snapshot bounded by maxRows (at most 128 events for this profile), sync-token continuation with an explicit reset on 410 Gone, and channel push notifications that only request another read. Inspect the installed source for its exact profile. Authoring: this connector keeps its lower-level recipe. Its sync-token and page-token pair, reset status and channel subscription are provider facts that http.records does not claim.

Provider references

Provider references and prerequisites are maintained in the connector guidance above. No separate provider-documentation review date is recorded.

Source and evidence

Canonical connector source, native analysis and check receipts. Connector artifact: 905888ea276a2a28e36981a79e8142b2547ea451c3e63162cb6915ad4a7d1305. The resource declaration examples above are compiled and compared with exact catalog declarations. Recorded checks apply only to their source, declaration and runtime identities. Configure a connection and inspect its status to establish deployment-specific readiness.

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Availability

Resources and modes

Calendar

incremental: incremental

Configuration: standard

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Calendar

​incremental: incremental

​Configuration: standard

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Calendar

incremental: incremental

Configuration: standard

Provider guidance

Provider references

Source and evidence