@contractspec/example.calendar-google 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,34 +1,35 @@
-$ 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.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=6
+Bundled 6 modules in 24ms
 
-✔ Build complete in 90538ms
+  docs/calendar-google.docblock.js  1.63 KB  (entry point)
+  ./index.js                        5.64 KB  (entry point)
+  docs/index.js                     1.63 KB  (entry point)
+  ./example.js                      0.96 KB  (entry point)
+  ./run.js                          3.15 KB  (entry point)
+  ./sync.js                         3.1 KB   (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=6
+Bundled 6 modules in 10ms
+
+  docs/calendar-google.docblock.js  1.62 KB  (entry point)
+  ./index.js                        5.63 KB  (entry point)
+  docs/index.js                     1.62 KB  (entry point)
+  ./example.js                      0.95 KB  (entry point)
+  ./run.js                          3.15 KB  (entry point)
+  ./sync.js                         3.1 KB   (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=6
+Bundled 6 modules in 15ms
+
+  docs/calendar-google.docblock.js  1.62 KB  (entry point)
+  ./index.js                        5.63 KB  (entry point)
+  docs/index.js                     1.62 KB  (entry point)
+  ./example.js                      0.95 KB  (entry point)
+  ./run.js                          3.15 KB  (entry point)
+  ./sync.js                         3.1 KB   (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @contractspec/example.calendar-google
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/integration.providers-impls@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/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/browser/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/browser/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/browser/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
+};

package/dist/browser/run.js

@@ -0,0 +1,89 @@
+// 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(`
+`);
+}
+
+// src/run.ts
+runCalendarSyncFromEnv().then((result) => {
+  console.log(JSON.stringify(result, null, 2));
+}).catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/dist/browser/sync.js

@@ -0,0 +1,87 @@
+// 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,
+  createProviderFromEnv,
+  buildUpcomingQuery,
+  buildSampleEvent
+};

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

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=calendar-google.docblock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-google.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/calendar-google.docblock.ts"],"names":[],"mappings":""}

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

@@ -1,19 +1,16 @@
+// @bun
+// src/docs/calendar-google.docblock.ts
 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
+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.
@@ -22,15 +19,16 @@ registerDocBlocks([{
 - 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
+  },
+  {
+    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.
@@ -43,7 +41,6 @@ registerDocBlocks([{
 
 ## Example
 - Call runCalendarSyncFromEnv() from run.ts to execute the flow.`
-}]);
-
-//#endregion
-//# sourceMappingURL=calendar-google.docblock.js.map
+  }
+];
+registerDocBlocks(blocks);

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './calendar-google.docblock';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC"}