@contractspec/example.calendar-google 1.57.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,33 @@
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/calendar-google/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/run.ts, src/sync.ts, src/docs/calendar-google.docblock.ts, src/docs/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 19 files
+ℹ dist/sync.js                               2.97 kB │ gzip: 1.25 kB
+ℹ dist/docs/calendar-google.docblock.js      1.62 kB │ gzip: 0.80 kB
+ℹ dist/example.js                            0.96 kB │ gzip: 0.49 kB
+ℹ dist/run.js                                0.28 kB │ gzip: 0.22 kB
+ℹ dist/index.js                              0.28 kB │ gzip: 0.16 kB
+ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
+ℹ dist/sync.js.map                           5.05 kB │ gzip: 1.98 kB
+ℹ dist/docs/calendar-google.docblock.js.map  2.13 kB │ gzip: 0.98 kB
+ℹ dist/example.js.map                        1.43 kB │ gzip: 0.69 kB
+ℹ dist/run.js.map                            0.49 kB │ gzip: 0.33 kB
+ℹ dist/sync.d.ts.map                         0.34 kB │ gzip: 0.21 kB
+ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
+ℹ dist/sync.d.ts                             0.78 kB │ gzip: 0.33 kB
+ℹ dist/index.d.ts                            0.29 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/calendar-google.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/index.d.ts                       0.01 kB │ gzip: 0.03 kB
+ℹ dist/run.d.ts                              0.01 kB │ gzip: 0.03 kB
+ℹ 18 files, total: 17.06 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (60%)
+  - tsdown:external (40%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 46144ms

package/.turbo/turbo-build.log

@@ -0,0 +1,34 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/calendar-google/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/run.ts, src/sync.ts, src/docs/calendar-google.docblock.ts, src/docs/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/sync.js                               2.97 kB │ gzip: 1.25 kB
+ℹ dist/docs/calendar-google.docblock.js      1.62 kB │ gzip: 0.80 kB
+ℹ dist/example.js                            0.96 kB │ gzip: 0.49 kB
+ℹ dist/run.js                                0.28 kB │ gzip: 0.22 kB
+ℹ dist/index.js                              0.28 kB │ gzip: 0.16 kB
+ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
+ℹ dist/sync.js.map                           5.05 kB │ gzip: 1.98 kB
+ℹ dist/docs/calendar-google.docblock.js.map  2.13 kB │ gzip: 0.98 kB
+ℹ dist/example.js.map                        1.43 kB │ gzip: 0.69 kB
+ℹ dist/run.js.map                            0.49 kB │ gzip: 0.33 kB
+ℹ dist/sync.d.ts.map                         0.34 kB │ gzip: 0.21 kB
+ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
+ℹ dist/sync.d.ts                             0.78 kB │ gzip: 0.33 kB
+ℹ dist/index.d.ts                            0.29 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/calendar-google.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/index.d.ts                       0.01 kB │ gzip: 0.03 kB
+ℹ dist/run.d.ts                              0.01 kB │ gzip: 0.03 kB
+ℹ 18 files, total: 17.06 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - tsdown:external (50%)
+  - rolldown-plugin-dts:generate (50%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 90538ms

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# @contractspec/example.calendar-google
+
+## 1.57.0
+
+### Minor Changes
+
+- 5f660cd: Add Google Calendar and Gmail integration examples.
+- 4651e06: Add Supabase and voice provider integrations with new runnable examples, and expose these providers across contracts, workspace tooling, and provider factory wiring.
+- ad9d10a: feat: improve posthog integration
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/integration.providers-impls@1.57.0
+
+## 1.56.1
+
+### Minor Changes
+
+- Initial Google Calendar integration example.
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/integration.providers-impls@1.56.1
+  - @contractspec/lib.contracts@1.56.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+### Integration Example - Google Calendar
+
+Website: https://contractspec.io/
+
+This example shows how to list upcoming events and create a new event using the Google Calendar provider.
+
+Files included:
+
+- `example.ts` - example metadata for the catalog.
+- `sync.ts` - helper to build sample events and sync them to Google Calendar.
+- `docs/calendar-google.docblock.ts` - documentation blocks for MCP/docs.
+
+Usage:
+
+```bash
+export CONTRACTSPEC_CALENDAR_DRY_RUN="true" # set to false to create real events
+export GOOGLE_CLIENT_ID="your_client_id"
+export GOOGLE_CLIENT_SECRET="your_client_secret"
+export GOOGLE_REFRESH_TOKEN="your_refresh_token"
+export GOOGLE_REDIRECT_URI="https://developers.google.com/oauthplayground" # optional
+export GOOGLE_CALENDAR_ID="primary" # optional
+
+bun tsx packages/examples/calendar-google/src/run.ts
+```
+
+Refresh token notes:
+
+1. Open https://developers.google.com/oauthplayground
+2. Click the gear icon and enable "Use your own OAuth credentials"
+3. Enter GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET
+4. Authorize scope https://www.googleapis.com/auth/calendar
+5. Exchange for tokens and copy the refresh token
+6. Export GOOGLE_REFRESH_TOKEN and rerun the script

package/dist/docs/calendar-google.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/calendar-google.docblock.js

@@ -0,0 +1,49 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/calendar-google.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.calendar-google",
+	title: "Google Calendar (example)",
+	summary: "List upcoming events and create a new event via Google Calendar.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/calendar-google",
+	tags: [
+		"calendar",
+		"google-calendar",
+		"example"
+	],
+	body: `## What this example shows
+- Create a Google OAuth client from env vars.
+- List upcoming events with time bounds.
+- Create a new event with attendees and reminders.
+
+## Guardrails
+- Keep refresh tokens in secrets.
+- Use dry-run when validating payloads.
+- Limit maxResults for quick previews.`
+}, {
+	id: "docs.examples.calendar-google.usage",
+	title: "Google Calendar - Usage",
+	summary: "How to run the calendar sync with env-driven settings.",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/examples/calendar-google/usage",
+	tags: ["calendar", "usage"],
+	body: `## Usage
+- Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.
+- Optionally set GOOGLE_CALENDAR_ID (defaults to primary).
+- Run the sync script to create a sample event.
+
+## Refresh token
+- Open https://developers.google.com/oauthplayground.
+- Enable "Use your own OAuth credentials" and enter client ID/secret.
+- Authorize https://www.googleapis.com/auth/calendar and exchange tokens.
+- Copy the refresh token into GOOGLE_REFRESH_TOKEN.
+
+## Example
+- Call runCalendarSyncFromEnv() from run.ts to execute the flow.`
+}]);
+
+//#endregion
+//# sourceMappingURL=calendar-google.docblock.js.map

package/dist/docs/calendar-google.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-google.docblock.js","names":[],"sources":["../../src/docs/calendar-google.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.calendar-google',\n    title: 'Google Calendar (example)',\n    summary: 'List upcoming events and create a new event via Google Calendar.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/calendar-google',\n    tags: ['calendar', 'google-calendar', 'example'],\n    body: `## What this example shows\n- Create a Google OAuth client from env vars.\n- List upcoming events with time bounds.\n- Create a new event with attendees and reminders.\n\n## Guardrails\n- Keep refresh tokens in secrets.\n- Use dry-run when validating payloads.\n- Limit maxResults for quick previews.`,\n  },\n  {\n    id: 'docs.examples.calendar-google.usage',\n    title: 'Google Calendar - Usage',\n    summary: 'How to run the calendar sync with env-driven settings.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/calendar-google/usage',\n    tags: ['calendar', 'usage'],\n    body: `## Usage\n- Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.\n- Optionally set GOOGLE_CALENDAR_ID (defaults to primary).\n- Run the sync script to create a sample event.\n\n## Refresh token\n- Open https://developers.google.com/oauthplayground.\n- Enable \"Use your own OAuth credentials\" and enter client ID/secret.\n- Authorize https://www.googleapis.com/auth/calendar and exchange tokens.\n- Copy the refresh token into GOOGLE_REFRESH_TOKEN.\n\n## Example\n- Call runCalendarSyncFromEnv() from run.ts to execute the flow.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA8CA,kBA3C2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAmB;EAAU;CAChD,MAAM;;;;;;;;;CASP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,YAAY,QAAQ;CAC3B,MAAM;;;;;;;;;;;;;CAaP,CACF,CAEwB"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./calendar-google.docblock.js";

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}

package/dist/example.js

@@ -0,0 +1,44 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "calendar-google",
+		version: "1.0.0",
+		title: "Google Calendar",
+		description: "List upcoming events and create a new event using the Google Calendar provider.",
+		kind: "integration",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.integrations"],
+		tags: [
+			"calendar",
+			"google-calendar",
+			"integrations"
+		]
+	},
+	docs: {
+		rootDocId: "docs.examples.calendar-google",
+		usageDocId: "docs.examples.calendar-google.usage"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.calendar-google",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+});
+
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'calendar-google',\n    version: '1.0.0',\n    title: 'Google Calendar',\n    description:\n      'List upcoming events and create a new event using the Google Calendar provider.',\n    kind: 'integration',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.integrations'],\n    tags: ['calendar', 'google-calendar', 'integrations'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.calendar-google',\n    usageDocId: 'docs.examples.calendar-google.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.calendar-google',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,yBAAyB;EAClC,MAAM;GAAC;GAAY;GAAmB;GAAe;EACtD;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import example from "./example.js";
+import { CalendarSyncOutput, buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, runCalendarSyncFromEnv } from "./sync.js";
+export { CalendarSyncOutput, buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, example, runCalendarSyncFromEnv };

package/dist/index.js

@@ -0,0 +1,5 @@
+import example from "./example.js";
+import { buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, runCalendarSyncFromEnv } from "./sync.js";
+import "./docs/index.js";
+
+export { buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, example, runCalendarSyncFromEnv };

package/dist/run.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/run.js

@@ -0,0 +1,12 @@
+import { runCalendarSyncFromEnv } from "./sync.js";
+
+//#region src/run.ts
+runCalendarSyncFromEnv().then((result) => {
+	console.log(JSON.stringify(result, null, 2));
+}).catch((error) => {
+	console.error(error);
+	process.exitCode = 1;
+});
+
+//#endregion
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","names":[],"sources":["../src/run.ts"],"sourcesContent":["import { runCalendarSyncFromEnv } from './sync';\n\nrunCalendarSyncFromEnv()\n  .then((result) => {\n    console.log(JSON.stringify(result, null, 2));\n  })\n  .catch((error) => {\n    console.error(error);\n    process.exitCode = 1;\n  });\n"],"mappings":";;;AAEA,wBAAwB,CACrB,MAAM,WAAW;AAChB,SAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC;EAC5C,CACD,OAAO,UAAU;AAChB,SAAQ,MAAM,MAAM;AACpB,SAAQ,WAAW;EACnB"}

package/dist/sync.d.ts

@@ -0,0 +1,14 @@
+import { CalendarEvent, CalendarEventInput, CalendarListEventsQuery, CalendarProvider } from "@contractspec/integration.providers-impls/calendar";
+
+//#region src/sync.d.ts
+interface CalendarSyncOutput {
+  created?: CalendarEvent | CalendarEventInput;
+  upcoming: CalendarEvent[] | CalendarEventInput[];
+}
+declare function runCalendarSyncFromEnv(): Promise<CalendarSyncOutput>;
+declare function buildSampleEvent(calendarId: string): CalendarEventInput;
+declare function buildUpcomingQuery(calendarId: string): CalendarListEventsQuery;
+declare function createProviderFromEnv(calendarId: string): CalendarProvider;
+//#endregion
+export { CalendarSyncOutput, buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, runCalendarSyncFromEnv };
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","names":[],"sources":["../src/sync.ts"],"mappings":";;;UASiB,kBAAA;EACf,OAAA,GAAU,aAAA,GAAgB,kBAAA;EAC1B,QAAA,EAAU,aAAA,KAAkB,kBAAA;AAAA;AAAA,iBAGR,sBAAA,CAAA,GAA0B,OAAA,CAAQ,kBAAA;AAAA,iBAgBxC,gBAAA,CAAiB,UAAA,WAAqB,kBAAA;AAAA,iBAiBtC,kBAAA,CACd,UAAA,WACC,uBAAA;AAAA,iBAWa,qBAAA,CAAsB,UAAA,WAAqB,gBAAA"}

package/dist/sync.js

@@ -0,0 +1,92 @@
+import { google } from "googleapis";
+import { GoogleCalendarProvider } from "@contractspec/integration.providers-impls/impls/google-calendar";
+
+//#region src/sync.ts
+async function runCalendarSyncFromEnv() {
+	const calendarId = resolveCalendarId();
+	const dryRun = process.env.CONTRACTSPEC_CALENDAR_DRY_RUN === "true";
+	const eventInput = buildSampleEvent(calendarId);
+	const listQuery = buildUpcomingQuery(calendarId);
+	if (dryRun) return {
+		created: eventInput,
+		upcoming: [eventInput]
+	};
+	const provider = createProviderFromEnv(calendarId);
+	return {
+		created: await provider.createEvent(eventInput),
+		upcoming: (await provider.listEvents(listQuery)).events
+	};
+}
+function buildSampleEvent(calendarId) {
+	const start = /* @__PURE__ */ new Date();
+	return {
+		calendarId,
+		title: "Product sync review",
+		description: "Review onboarding friction and sync action items.",
+		location: "Zoom",
+		start,
+		end: new Date(start.getTime() + 1800 * 1e3),
+		conference: {
+			create: true,
+			type: "google_meet"
+		},
+		attendees: [{
+			email: "teammate@example.com",
+			name: "Teammate"
+		}],
+		reminders: [{
+			method: "popup",
+			minutesBeforeStart: 10
+		}],
+		metadata: { source: "contractspec-example" }
+	};
+}
+function buildUpcomingQuery(calendarId) {
+	const now = /* @__PURE__ */ new Date();
+	return {
+		calendarId,
+		timeMin: now,
+		timeMax: new Date(now.getTime() + 10080 * 60 * 1e3),
+		maxResults: 5
+	};
+}
+function createProviderFromEnv(calendarId) {
+	return new GoogleCalendarProvider({
+		auth: createGoogleAuthFromEnv(),
+		calendarId
+	});
+}
+function createGoogleAuthFromEnv() {
+	const clientId = requireEnv("GOOGLE_CLIENT_ID");
+	const clientSecret = requireEnv("GOOGLE_CLIENT_SECRET");
+	const refreshToken = requireEnv("GOOGLE_REFRESH_TOKEN");
+	const redirectUri = process.env.GOOGLE_REDIRECT_URI ?? "https://developers.google.com/oauthplayground";
+	const oauth = new google.auth.OAuth2(clientId, clientSecret, redirectUri);
+	oauth.setCredentials({ refresh_token: refreshToken });
+	return oauth;
+}
+function resolveCalendarId() {
+	return process.env.GOOGLE_CALENDAR_ID ?? "primary";
+}
+function requireEnv(key) {
+	const value = process.env[key];
+	if (!value) throw new Error(buildMissingEnvMessage(key));
+	return value;
+}
+function buildMissingEnvMessage(key) {
+	if (key !== "GOOGLE_REFRESH_TOKEN") return `Missing required env var: ${key}`;
+	return [
+		`Missing required env var: ${key}`,
+		"Get a refresh token with OAuth Playground:",
+		"1) Open https://developers.google.com/oauthplayground",
+		"2) Click the gear icon and enable \"Use your own OAuth credentials\"",
+		"3) Enter GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET",
+		"4) Authorize scope https://www.googleapis.com/auth/calendar",
+		"5) Exchange for tokens and copy the refresh token",
+		"Then export GOOGLE_REFRESH_TOKEN and rerun the script."
+	].join("\n");
+}
+
+//#endregion
+export { buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, runCalendarSyncFromEnv };
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","names":[],"sources":["../src/sync.ts"],"sourcesContent":["import { google } from 'googleapis';\nimport { GoogleCalendarProvider } from '@contractspec/integration.providers-impls/impls/google-calendar';\nimport type {\n  CalendarEvent,\n  CalendarEventInput,\n  CalendarListEventsQuery,\n  CalendarProvider,\n} from '@contractspec/integration.providers-impls/calendar';\n\nexport interface CalendarSyncOutput {\n  created?: CalendarEvent | CalendarEventInput;\n  upcoming: CalendarEvent[] | CalendarEventInput[];\n}\n\nexport async function runCalendarSyncFromEnv(): Promise<CalendarSyncOutput> {\n  const calendarId = resolveCalendarId();\n  const dryRun = process.env.CONTRACTSPEC_CALENDAR_DRY_RUN === 'true';\n  const eventInput = buildSampleEvent(calendarId);\n  const listQuery = buildUpcomingQuery(calendarId);\n\n  if (dryRun) {\n    return { created: eventInput, upcoming: [eventInput] };\n  }\n\n  const provider = createProviderFromEnv(calendarId);\n  const created = await provider.createEvent(eventInput);\n  const upcoming = await provider.listEvents(listQuery);\n  return { created, upcoming: upcoming.events };\n}\n\nexport function buildSampleEvent(calendarId: string): CalendarEventInput {\n  const start = new Date();\n  const end = new Date(start.getTime() + 30 * 60 * 1000);\n  return {\n    calendarId,\n    title: 'Product sync review',\n    description: 'Review onboarding friction and sync action items.',\n    location: 'Zoom',\n    start,\n    end,\n    conference: { create: true, type: 'google_meet' },\n    attendees: [{ email: 'teammate@example.com', name: 'Teammate' }],\n    reminders: [{ method: 'popup', minutesBeforeStart: 10 }],\n    metadata: { source: 'contractspec-example' },\n  };\n}\n\nexport function buildUpcomingQuery(\n  calendarId: string\n): CalendarListEventsQuery {\n  const now = new Date();\n  const inSevenDays = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);\n  return {\n    calendarId,\n    timeMin: now,\n    timeMax: inSevenDays,\n    maxResults: 5,\n  };\n}\n\nexport function createProviderFromEnv(calendarId: string): CalendarProvider {\n  const auth = createGoogleAuthFromEnv();\n  return new GoogleCalendarProvider({ auth, calendarId });\n}\n\nfunction createGoogleAuthFromEnv() {\n  const clientId = requireEnv('GOOGLE_CLIENT_ID');\n  const clientSecret = requireEnv('GOOGLE_CLIENT_SECRET');\n  const refreshToken = requireEnv('GOOGLE_REFRESH_TOKEN');\n  const redirectUri =\n    process.env.GOOGLE_REDIRECT_URI ??\n    'https://developers.google.com/oauthplayground';\n  const oauth = new google.auth.OAuth2(clientId, clientSecret, redirectUri);\n  oauth.setCredentials({ refresh_token: refreshToken });\n  return oauth;\n}\n\nfunction resolveCalendarId(): string {\n  return process.env.GOOGLE_CALENDAR_ID ?? 'primary';\n}\n\nfunction requireEnv(key: string): string {\n  const value = process.env[key];\n  if (!value) {\n    throw new Error(buildMissingEnvMessage(key));\n  }\n  return value;\n}\n\nfunction buildMissingEnvMessage(key: string): string {\n  if (key !== 'GOOGLE_REFRESH_TOKEN') {\n    return `Missing required env var: ${key}`;\n  }\n  return [\n    `Missing required env var: ${key}`,\n    'Get a refresh token with OAuth Playground:',\n    '1) Open https://developers.google.com/oauthplayground',\n    '2) Click the gear icon and enable \"Use your own OAuth credentials\"',\n    '3) Enter GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET',\n    '4) Authorize scope https://www.googleapis.com/auth/calendar',\n    '5) Exchange for tokens and copy the refresh token',\n    'Then export GOOGLE_REFRESH_TOKEN and rerun the script.',\n  ].join('\\n');\n}\n"],"mappings":";;;;AAcA,eAAsB,yBAAsD;CAC1E,MAAM,aAAa,mBAAmB;CACtC,MAAM,SAAS,QAAQ,IAAI,kCAAkC;CAC7D,MAAM,aAAa,iBAAiB,WAAW;CAC/C,MAAM,YAAY,mBAAmB,WAAW;AAEhD,KAAI,OACF,QAAO;EAAE,SAAS;EAAY,UAAU,CAAC,WAAW;EAAE;CAGxD,MAAM,WAAW,sBAAsB,WAAW;AAGlD,QAAO;EAAE,SAFO,MAAM,SAAS,YAAY,WAAW;EAEpC,WADD,MAAM,SAAS,WAAW,UAAU,EAChB;EAAQ;;AAG/C,SAAgB,iBAAiB,YAAwC;CACvE,MAAM,wBAAQ,IAAI,MAAM;AAExB,QAAO;EACL;EACA,OAAO;EACP,aAAa;EACb,UAAU;EACV;EACA,KAPU,IAAI,KAAK,MAAM,SAAS,GAAG,OAAU,IAAK;EAQpD,YAAY;GAAE,QAAQ;GAAM,MAAM;GAAe;EACjD,WAAW,CAAC;GAAE,OAAO;GAAwB,MAAM;GAAY,CAAC;EAChE,WAAW,CAAC;GAAE,QAAQ;GAAS,oBAAoB;GAAI,CAAC;EACxD,UAAU,EAAE,QAAQ,wBAAwB;EAC7C;;AAGH,SAAgB,mBACd,YACyB;CACzB,MAAM,sBAAM,IAAI,MAAM;AAEtB,QAAO;EACL;EACA,SAAS;EACT,SAJkB,IAAI,KAAK,IAAI,SAAS,GAAG,QAAc,KAAK,IAAK;EAKnE,YAAY;EACb;;AAGH,SAAgB,sBAAsB,YAAsC;AAE1E,QAAO,IAAI,uBAAuB;EAAE,MADvB,yBAAyB;EACI;EAAY,CAAC;;AAGzD,SAAS,0BAA0B;CACjC,MAAM,WAAW,WAAW,mBAAmB;CAC/C,MAAM,eAAe,WAAW,uBAAuB;CACvD,MAAM,eAAe,WAAW,uBAAuB;CACvD,MAAM,cACJ,QAAQ,IAAI,uBACZ;CACF,MAAM,QAAQ,IAAI,OAAO,KAAK,OAAO,UAAU,cAAc,YAAY;AACzE,OAAM,eAAe,EAAE,eAAe,cAAc,CAAC;AACrD,QAAO;;AAGT,SAAS,oBAA4B;AACnC,QAAO,QAAQ,IAAI,sBAAsB;;AAG3C,SAAS,WAAW,KAAqB;CACvC,MAAM,QAAQ,QAAQ,IAAI;AAC1B,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,uBAAuB,IAAI,CAAC;AAE9C,QAAO;;AAGT,SAAS,uBAAuB,KAAqB;AACnD,KAAI,QAAQ,uBACV,QAAO,6BAA6B;AAEtC,QAAO;EACL,6BAA6B;EAC7B;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@contractspec/example.calendar-google",
+  "version": "1.57.0",
+  "description": "Google Calendar integration example: list and create events.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/calendar-google.docblock": "./dist/docs/calendar-google.docblock.js",
+    "./example": "./dist/example.js",
+    "./run": "./dist/run.js",
+    "./sync": "./dist/sync.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/integration.providers-impls": "1.57.0",
+    "@contractspec/lib.contracts": "1.57.0",
+    "googleapis": "^171.4.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.57.0",
+    "@contractspec/tool.typescript": "1.57.0",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/calendar-google.docblock": "./dist/docs/calendar-google.docblock.js",
+      "./example": "./dist/example.js",
+      "./run": "./dist/run.js",
+      "./sync": "./dist/sync.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/calendar-google"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/calendar-google.docblock.ts

@@ -0,0 +1,47 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    id: 'docs.examples.calendar-google',
+    title: 'Google Calendar (example)',
+    summary: 'List upcoming events and create a new event via Google Calendar.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/calendar-google',
+    tags: ['calendar', 'google-calendar', 'example'],
+    body: `## What this example shows
+- Create a Google OAuth client from env vars.
+- List upcoming events with time bounds.
+- Create a new event with attendees and reminders.
+
+## Guardrails
+- Keep refresh tokens in secrets.
+- Use dry-run when validating payloads.
+- Limit maxResults for quick previews.`,
+  },
+  {
+    id: 'docs.examples.calendar-google.usage',
+    title: 'Google Calendar - Usage',
+    summary: 'How to run the calendar sync with env-driven settings.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/calendar-google/usage',
+    tags: ['calendar', 'usage'],
+    body: `## Usage
+- Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.
+- Optionally set GOOGLE_CALENDAR_ID (defaults to primary).
+- Run the sync script to create a sample event.
+
+## Refresh token
+- Open https://developers.google.com/oauthplayground.
+- Enable "Use your own OAuth credentials" and enter client ID/secret.
+- Authorize https://www.googleapis.com/auth/calendar and exchange tokens.
+- Copy the refresh token into GOOGLE_REFRESH_TOKEN.
+
+## Example
+- Call runCalendarSyncFromEnv() from run.ts to execute the flow.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './calendar-google.docblock';

package/src/example.ts

@@ -0,0 +1,32 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+const example = defineExample({
+  meta: {
+    key: 'calendar-google',
+    version: '1.0.0',
+    title: 'Google Calendar',
+    description:
+      'List upcoming events and create a new event using the Google Calendar provider.',
+    kind: 'integration',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.integrations'],
+    tags: ['calendar', 'google-calendar', 'integrations'],
+  },
+  docs: {
+    rootDocId: 'docs.examples.calendar-google',
+    usageDocId: 'docs.examples.calendar-google.usage',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.calendar-google',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+});
+
+export default example;

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './sync';
+export { default as example } from './example';
+import './docs';

package/src/run.ts

@@ -0,0 +1,10 @@
+import { runCalendarSyncFromEnv } from './sync';
+
+runCalendarSyncFromEnv()
+  .then((result) => {
+    console.log(JSON.stringify(result, null, 2));
+  })
+  .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+  });