@contractspec/example.calendar-google 1.57.0 → 1.59.0

package/dist/docs/index.js

@@ -1 +1,46 @@
-import "./calendar-google.docblock.js";
+// @bun
+// src/docs/calendar-google.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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/dist/example.d.ts

@@ -1,7 +1,3 @@
-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 };
+declare const example: import("@contractspec/lib.contracts").ExampleSpec;
+export default example;
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,OAAO,mDA2BX,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/example.js

@@ -1,44 +1,34 @@
+// @bun
+// src/example.ts
 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 }
-	}
+var 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
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-import example from "./example.js";
-import { CalendarSyncOutput, buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, runCalendarSyncFromEnv } from "./sync.js";
-export { CalendarSyncOutput, buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, example, runCalendarSyncFromEnv };
+export * from './sync';
+export { default as example } from './example';
+import './docs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,QAAQ,CAAC"}

package/dist/index.js

@@ -1,5 +1,165 @@
-import example from "./example.js";
-import { buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, runCalendarSyncFromEnv } from "./sync.js";
-import "./docs/index.js";
+// @bun
+// src/docs/calendar-google.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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.
 
-export { buildSampleEvent, buildUpcomingQuery, createProviderFromEnv, example, runCalendarSyncFromEnv };
+## 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);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/sync.ts
+import { google } from "googleapis";
+import { GoogleCalendarProvider } from "@contractspec/integration.providers-impls/impls/google-calendar";
+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);
+  const created = await provider.createEvent(eventInput);
+  const upcoming = await provider.listEvents(listQuery);
+  return { created, upcoming: upcoming.events };
+}
+function buildSampleEvent(calendarId) {
+  const start = new Date;
+  const end = new Date(start.getTime() + 30 * 60 * 1000);
+  return {
+    calendarId,
+    title: "Product sync review",
+    description: "Review onboarding friction and sync action items.",
+    location: "Zoom",
+    start,
+    end,
+    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 = new Date;
+  const inSevenDays = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
+  return {
+    calendarId,
+    timeMin: now,
+    timeMax: inSevenDays,
+    maxResults: 5
+  };
+}
+function createProviderFromEnv(calendarId) {
+  const auth = createGoogleAuthFromEnv();
+  return new GoogleCalendarProvider({ auth, 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(`
+`);
+}
+export {
+  runCalendarSyncFromEnv,
+  example_default as example,
+  createProviderFromEnv,
+  buildUpcomingQuery,
+  buildSampleEvent
+};

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

@@ -0,0 +1,45 @@
+// src/docs/calendar-google.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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/dist/node/docs/index.js

@@ -0,0 +1,45 @@
+// src/docs/calendar-google.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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/dist/node/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/node/index.js

@@ -0,0 +1,164 @@
+// src/docs/calendar-google.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/sync.ts
+import { google } from "googleapis";
+import { GoogleCalendarProvider } from "@contractspec/integration.providers-impls/impls/google-calendar";
+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);
+  const created = await provider.createEvent(eventInput);
+  const upcoming = await provider.listEvents(listQuery);
+  return { created, upcoming: upcoming.events };
+}
+function buildSampleEvent(calendarId) {
+  const start = new Date;
+  const end = new Date(start.getTime() + 30 * 60 * 1000);
+  return {
+    calendarId,
+    title: "Product sync review",
+    description: "Review onboarding friction and sync action items.",
+    location: "Zoom",
+    start,
+    end,
+    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 = new Date;
+  const inSevenDays = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
+  return {
+    calendarId,
+    timeMin: now,
+    timeMax: inSevenDays,
+    maxResults: 5
+  };
+}
+function createProviderFromEnv(calendarId) {
+  const auth = createGoogleAuthFromEnv();
+  return new GoogleCalendarProvider({ auth, 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(`
+`);
+}
+export {
+  runCalendarSyncFromEnv,
+  example_default as example,
+  createProviderFromEnv,
+  buildUpcomingQuery,
+  buildSampleEvent
+};