meetschedify 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Raj
+
+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,355 @@
+# meetSchedify
+
+Enterprise-ready, multi-provider video meeting SDK for Node.js and TypeScript.
+
+Today: **Google Meet** via Google Calendar.  
+Tomorrow: **Zoom, Microsoft Teams, Calendly** and more – with one unified API.
+
+The goal is simple: after reading this README, any backend engineer should be able to plug in Google Meet scheduling end‑to‑end in under an hour.
+
+---
+
+## 1. What problem does meetSchedify solve?
+
+- **One API** to schedule video meetings across different platforms.
+- You decide **how to store tokens** (DB, Vault, etc.) – the library never touches your database directly.
+- Built for **multi-tenant apps** (SaaS with many employers/customers).
+- Clean separation:
+  - Frontend just calls your REST APIs.
+  - Backend calls `meetSchedify` to talk to Google/Zoom/Teams/etc.
+
+---
+
+## 2. Installation
+
+Inside your backend project:
+
+```bash
+npm install meetschedify googleapis
+```
+
+> **Note**: `meetschedify` is the NPM package name. You can still refer to the concept as “meetSchedify” in your code and docs.
+
+---
+
+## 3. Prerequisites (Google Meet)
+
+1. **Node.js 18+**
+2. **Google Cloud project** with Calendar API enabled.
+3. **OAuth 2.0 Client ID** of type “Web application”.
+4. **Authorized redirect URI**, e.g.:
+   - `https://your-backend.com/api/v1/calendar/oauth/callback`
+5. Add these environment variables in your backend:
+
+```bash
+GOOGLE_CLIENT_ID=your-google-oauth-client-id
+GOOGLE_CLIENT_SECRET=your-google-oauth-client-secret
+GOOGLE_REDIRECT_URI=https://your-backend.com/api/v1/calendar/oauth/callback
+```
+
+You can name the variables differently if you want; just use the same names when you configure `GoogleMeetProvider`.
+
+---
+
+## 4. Core concepts (very short)
+
+- **Tenant**: one customer/employer in your system. Identified by a stable `tenantId` (string).
+- **Provider**: a video platform (Google Meet, Zoom, Teams, Calendly, …).
+- **TokenStore**: your implementation that securely stores provider OAuth tokens per tenant.
+- **MeetSchedifyClient**: main entry; it knows which providers are available and routes calls to them.
+
+---
+
+## 5. Backend integration – step by step
+
+This section shows one concrete, end‑to‑end backend integration using **Express** and **Google Meet**.  
+You can easily adapt to NestJS, Fastify, etc.
+
+### Step 1 – Implement `TokenStore`
+
+Create a file like `src/meetSchedifyTokenStore.ts` and implement the interface.
+
+Example skeleton (you should connect this to your real DB model):
+
+```ts
+import type {
+  TokenStore,
+  TokenStoreContext,
+  TokenRecord,
+} from "meetschedify";
+
+// Example only. Replace this with your real DB calls.
+export class DbTokenStore implements TokenStore {
+  async getTokens(ctx: TokenStoreContext): Promise<TokenRecord | null> {
+    // 1. Query DB by ctx.tenantId + ctx.providerId
+    // 2. Return TokenRecord or null if not configured.
+    return null;
+  }
+
+  async saveTokens(ctx: TokenStoreContext, tokens: TokenRecord): Promise<void> {
+    // 1. Upsert into DB for ctx.tenantId + ctx.providerId.
+    // 2. Consider encrypting tokens at rest.
+  }
+}
+```
+
+**Production tip**: always encrypt `refreshToken` in the database (KMS, Vault, or field‑level encryption).
+
+---
+
+### Step 2 – Bootstrap meetSchedify
+
+Create `src/meetSchedify.ts` (or similar) and initialise the client once:
+
+```ts
+import { GoogleMeetProvider, MeetSchedifyClient } from "meetschedify";
+import { DbTokenStore } from "./meetSchedifyTokenStore";
+
+const tokenStore = new DbTokenStore();
+
+const googleProvider = new GoogleMeetProvider(
+  {
+    clientId: process.env.GOOGLE_CLIENT_ID!,
+    clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+    redirectUri: process.env.GOOGLE_REDIRECT_URI!,
+    logger: (msg, meta) => {
+      // Avoid logging any PII or raw tokens here.
+      console.log(`[meetSchedify] ${msg}`, meta);
+    },
+  },
+  tokenStore
+);
+
+export const meetSchedify = new MeetSchedifyClient({
+  providers: [googleProvider],
+});
+```
+
+If you later add Zoom/Teams/Calendly providers, you will add them to this `providers: [...]` array.
+
+---
+
+### Step 3 – Add REST endpoints (Express)
+
+Below are typical endpoints you would expose from your backend so the frontend can:
+- check if calendar is connected,
+- start OAuth connection to Google,
+- handle the OAuth callback,
+- schedule an interview/meeting.
+
+All examples assume:
+- You have auth middleware that puts the logged-in user on `req.user`.
+- Your `tenantId` is `String(req.user._id)` (change as needed).
+
+#### 3.1 – Check connection status
+
+```ts
+import type { Request, Response } from "express";
+import { meetSchedify } from "../meetSchedify";
+
+export async function getCalendarConnectionStatus(req: Request, res: Response) {
+  const tenantId = String((req as any).user._id);
+
+  const status = await meetSchedify.getConnectionStatus(
+    tenantId,
+    "google-meet"
+  );
+
+  res.json({
+    connected: status.connected,
+    providerId: status.providerId,
+  });
+}
+```
+
+#### 3.2 – Get Google OAuth URL
+
+```ts
+import type { Request, Response } from "express";
+import { meetSchedify } from "../meetSchedify";
+
+export async function getGoogleCalendarAuthUrl(req: Request, res: Response) {
+  const tenantId = String((req as any).user._id);
+  const returnUrl =
+    typeof req.query.returnUrl === "string"
+      ? req.query.returnUrl.trim()
+      : undefined;
+
+  const result = await meetSchedify.getAuthorizationUrl({
+    providerId: "google-meet",
+    tenantId,
+    returnUrl,
+  });
+
+  res.status(200).json({ url: result.url });
+}
+```
+
+#### 3.3 – OAuth callback route
+
+```ts
+import type { Request, Response } from "express";
+import { meetSchedify } from "../meetSchedify";
+
+export async function googleCalendarOAuthCallback(
+  req: Request,
+  res: Response
+) {
+  const { code, state } = req.query;
+
+  if (!code || !state) {
+    return res.status(400).json({
+      message: "Missing code or state for Google OAuth",
+    });
+  }
+
+  const result = await meetSchedify.handleOAuthCallback("google-meet", {
+    code: String(code),
+    state: typeof state === "string" ? state : undefined,
+  });
+
+  // Build a safe redirect URL back to your frontend.
+  const fallbackOrigin = `${req.protocol}://${req.get("host")}`;
+  const base = (process.env.FRONTEND_URL || fallbackOrigin).replace(/\/$/, "");
+
+  // Optionally read a "returnUrl" from the state you encoded earlier.
+  let returnUrl = "/dashboard";
+  try {
+    const parsed = JSON.parse(String(state));
+    if (parsed.returnUrl && typeof parsed.returnUrl === "string") {
+      returnUrl = parsed.returnUrl.startsWith("/")
+        ? parsed.returnUrl
+        : `/${parsed.returnUrl}`;
+    }
+  } catch {
+    // ignore; fall back to default.
+  }
+
+  const sep = returnUrl.includes("?") ? "&" : "?";
+  const redirectUrl = `${base}${returnUrl}${sep}googleCalendar=connected&provider=${result.providerId}`;
+
+  return res.redirect(redirectUrl);
+}
+```
+
+#### 3.4 – Schedule an interview/meeting
+
+This example mirrors a typical “schedule interview” payload (`date`, `startTime`, `endTime`, `timezone`, `locationType`, `ccEmails`, etc.).
+
+```ts
+import type { Request, Response } from "express";
+import { meetSchedify } from "../meetSchedify";
+
+export async function scheduleInterviewWithCalendar(
+  req: Request,
+  res: Response
+) {
+  const tenantId = String((req as any).user._id);
+
+  const {
+    date,
+    startTime,
+    endTime,
+    location,
+    locationType, // "online" | "offline"
+    subject,
+    description,
+    ccEmails = [],
+    timezone = "Asia/Dubai",
+    addGoogleMeet = true,
+    candidateEmail,
+    candidateName,
+  } = req.body;
+
+  const startDateTimeLocal = `${date}T${startTime}:00`;
+  const endDateTimeLocal = `${date}T${endTime}:00`;
+
+  const meeting = await meetSchedify.createMeeting({
+    providerId: "google-meet",
+    tenantId,
+    title: subject,
+    description,
+    time: {
+      start: startDateTimeLocal,
+      end: endDateTimeLocal,
+      timezone,
+    },
+    location: {
+      type: locationType === "offline" ? "offline" : "online",
+      value: location,
+    },
+    primaryParticipant: candidateEmail
+      ? {
+          email: candidateEmail,
+          displayName: candidateName,
+        }
+      : undefined,
+    additionalParticipants: (ccEmails as string[]).map((email) => ({
+      email,
+    })),
+    addConferenceLink: addGoogleMeet !== false,
+  });
+
+  res.status(200).json({
+    status: "interview_scheduled",
+    meeting,
+  });
+}
+```
+
+You can still store any extra interview metadata (status, notes, etc.) in your own database – `meeting` just gives you the calendar/meeting details to save alongside.
+
+---
+
+## 6. Frontend usage (high level)
+
+`meetSchedify` runs entirely on the backend. Your frontend just talks to your REST API.
+
+Typical React flow:
+
+1. **Connect calendar**
+   - Call `GET /api/calendar/status` – if `connected === false`, show “Connect Google Calendar” button.
+   - Button calls `GET /api/calendar/auth-url` to get `url`.
+   - Redirect browser to that `url` to complete OAuth.
+2. **Schedule interview**
+   - Use your existing schedule modal (date, time, timezone, location type, CC emails, subject, description).
+   - Post to `POST /api/job-applicants/:applicationId/interview/schedule`.
+   - Backend calls `meetSchedify.createMeeting` and returns the meeting details and/or link.
+
+No Google SDK is required on the frontend – everything is handled by your backend + `meetSchedify`.
+
+---
+
+## 7. Type reference (core)
+
+Key exported types:
+
+- `CreateMeetingRequest`
+- `CreatedMeeting`
+- `MeetingTimeRange`
+- `MeetingLocation`
+- `MeetingParticipant`
+- `ProviderConnectionStatus`
+- `TokenStore`, `TokenStoreContext`, `TokenRecord`
+- `VideoMeetingProvider`
+- `GoogleMeetProvider`
+- `MeetSchedifyClient`
+
+Refer to the TypeScript definitions in `src/` or compiled `.d.ts` in `dist/` for full detail.
+
+---
+
+## 8. Security and best practices
+
+- **Never** log raw access/refresh tokens or full OAuth credentials.
+- Use a secure **`TokenStore` implementation** (DB + KMS, Vault, or encrypted columns).
+- Scope everything by a stable `tenantId`; avoid using emails or other PII as identifiers.
+- Lock down your Google OAuth client in the Google Cloud console (allowed redirect URIs, JS origins, etc.).
+- Rotate client secrets and use environment variables for configuration – never hardcode secrets.
+
+---
+
+## 9. License
+
+MIT © Raj (WATNXT) and contributors
+

package/dist/MeetSchedifyClient.d.ts

@@ -0,0 +1,15 @@
+import type { AuthUrlResult, CreateMeetingRequest, CreatedMeeting, GetAuthUrlOptions, OAuthCallbackPayload, OAuthCallbackResult, ProviderConnectionStatus, ProviderId } from "./types";
+import type { VideoMeetingProvider } from "./providers/BaseProvider";
+export interface MeetSchedifyClientOptions {
+    providers: VideoMeetingProvider[];
+}
+export declare class MeetSchedifyClient {
+    private readonly providers;
+    constructor(options: MeetSchedifyClientOptions);
+    private getProvider;
+    getConnectionStatus(tenantId: string, providerId: ProviderId): Promise<ProviderConnectionStatus>;
+    getAuthorizationUrl(options: GetAuthUrlOptions): Promise<AuthUrlResult>;
+    handleOAuthCallback(providerId: ProviderId, payload: OAuthCallbackPayload): Promise<OAuthCallbackResult>;
+    createMeeting(req: CreateMeetingRequest): Promise<CreatedMeeting>;
+}
+//# sourceMappingURL=MeetSchedifyClient.d.ts.map

package/dist/MeetSchedifyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeetSchedifyClient.d.ts","sourceRoot":"","sources":["../src/MeetSchedifyClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAEtD,OAAO,EAAE,yBAAyB;IAS9C,OAAO,CAAC,WAAW;IAQb,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKhG,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IASvE,mBAAmB,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAQzB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;CAIxE"}

package/dist/MeetSchedifyClient.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetSchedifyClient = void 0;
+class MeetSchedifyClient {
+    constructor(options) {
+        if (!options.providers.length) {
+            throw new Error("MeetSchedifyClient requires at least one provider");
+        }
+        this.providers = new Map(options.providers.map((p) => [p.id, p]));
+    }
+    getProvider(id) {
+        const provider = this.providers.get(id);
+        if (!provider) {
+            throw new Error(`Provider '${id}' is not registered in MeetSchedifyClient`);
+        }
+        return provider;
+    }
+    async getConnectionStatus(tenantId, providerId) {
+        const provider = this.getProvider(providerId);
+        return provider.isConnected({ tenantId });
+    }
+    async getAuthorizationUrl(options) {
+        const provider = this.getProvider(options.providerId);
+        if (!provider.getAuthorizationUrl) {
+            throw new Error(`Provider '${options.providerId}' does not support OAuth authorization URLs`);
+        }
+        const result = await provider.getAuthorizationUrl(options);
+        return result;
+    }
+    async handleOAuthCallback(providerId, payload) {
+        const provider = this.getProvider(providerId);
+        if (!provider.handleOAuthCallback) {
+            throw new Error(`Provider '${providerId}' does not support OAuth callbacks`);
+        }
+        return provider.handleOAuthCallback(payload);
+    }
+    async createMeeting(req) {
+        const provider = this.getProvider(req.providerId);
+        return provider.createMeeting(req);
+    }
+}
+exports.MeetSchedifyClient = MeetSchedifyClient;
+//# sourceMappingURL=MeetSchedifyClient.js.map

package/dist/MeetSchedifyClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeetSchedifyClient.js","sourceRoot":"","sources":["../src/MeetSchedifyClient.ts"],"names":[],"mappings":";;;AAgBA,MAAa,kBAAkB;IAG7B,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CACtB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CACxC,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,EAAc;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,2CAA2C,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAgB,EAAE,UAAsB;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAA0B;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,UAAU,6CAA6C,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,UAAsB,EACtB,OAA6B;QAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,aAAa,UAAU,oCAAoC,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAyB;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;CACF;AAjDD,gDAiDC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./store/TokenStore";
+export * from "./providers/BaseProvider";
+export * from "./providers/google/GoogleMeetProvider";
+export * from "./MeetSchedifyClient";
+//# 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,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./store/TokenStore"), exports);
+__exportStar(require("./providers/BaseProvider"), exports);
+__exportStar(require("./providers/google/GoogleMeetProvider"), exports);
+__exportStar(require("./MeetSchedifyClient"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,qDAAmC;AACnC,2DAAyC;AACzC,wEAAsD;AACtD,uDAAqC"}

package/dist/providers/BaseProvider.d.ts

@@ -0,0 +1,11 @@
+import type { AuthUrlResult, CreateMeetingRequest, CreatedMeeting, GetAuthUrlOptions, OAuthCallbackPayload, OAuthCallbackResult, ProviderConnectionStatus, ProviderId } from "../types";
+export interface VideoMeetingProvider {
+    readonly id: ProviderId;
+    isConnected(ctx: {
+        tenantId: string;
+    }): Promise<ProviderConnectionStatus>;
+    getAuthorizationUrl?(options: GetAuthUrlOptions): Promise<AuthUrlResult> | AuthUrlResult;
+    handleOAuthCallback?(payload: OAuthCallbackPayload): Promise<OAuthCallbackResult>;
+    createMeeting(request: CreateMeetingRequest): Promise<CreatedMeeting>;
+}
+//# sourceMappingURL=BaseProvider.d.ts.map

package/dist/providers/BaseProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.d.ts","sourceRoot":"","sources":["../../src/providers/BaseProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IAExB,WAAW,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE1E,mBAAmB,CAAC,CAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;IAE1C,mBAAmB,CAAC,CAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE"}

package/dist/providers/BaseProvider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BaseProvider.js.map

package/dist/providers/BaseProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.js","sourceRoot":"","sources":["../../src/providers/BaseProvider.ts"],"names":[],"mappings":""}

package/dist/providers/google/GoogleMeetProvider.d.ts

@@ -0,0 +1,28 @@
+import type { AuthUrlResult, CreateMeetingRequest, CreatedMeeting, GetAuthUrlOptions, OAuthCallbackPayload, OAuthCallbackResult, ProviderConnectionStatus } from "../../types";
+import type { TokenStore } from "../../store/TokenStore";
+import type { VideoMeetingProvider } from "../BaseProvider";
+export interface GoogleMeetProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    /**
+     * Optional function used only for logging/sanitised audit trails.
+     * Never log raw tokens or PII here.
+     */
+    logger?: (msg: string, meta?: Record<string, unknown>) => void;
+}
+export declare class GoogleMeetProvider implements VideoMeetingProvider {
+    readonly id: "google-meet";
+    private readonly tokenStore;
+    private readonly cfg;
+    constructor(cfg: GoogleMeetProviderConfig, tokenStore: TokenStore);
+    private getOAuthClient;
+    private getAuthorizedClient;
+    isConnected(ctx: {
+        tenantId: string;
+    }): Promise<ProviderConnectionStatus>;
+    getAuthorizationUrl(options: GetAuthUrlOptions): AuthUrlResult;
+    handleOAuthCallback(payload: OAuthCallbackPayload): Promise<OAuthCallbackResult>;
+    createMeeting(req: CreateMeetingRequest): Promise<CreatedMeeting>;
+}
+//# sourceMappingURL=GoogleMeetProvider.d.ts.map

package/dist/providers/google/GoogleMeetProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMeetProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/google/GoogleMeetProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAChE;AAID,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,SAAgB,EAAE,EAAG,aAAa,CAAU;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;gBAEnC,GAAG,EAAE,wBAAwB,EAAE,UAAU,EAAE,UAAU;IAKjE,OAAO,CAAC,cAAc;YAQR,mBAAmB;IAoC3B,WAAW,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAY/E,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa;IA0BxD,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsChF,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;CA2GxE"}

package/dist/providers/google/GoogleMeetProvider.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleMeetProvider = void 0;
+const googleapis_1 = require("googleapis");
+const crypto_1 = require("crypto");
+const SCOPES = ["https://www.googleapis.com/auth/calendar"];
+class GoogleMeetProvider {
+    constructor(cfg, tokenStore) {
+        this.id = "google-meet";
+        this.cfg = cfg;
+        this.tokenStore = tokenStore;
+    }
+    getOAuthClient() {
+        return new googleapis_1.google.auth.OAuth2(this.cfg.clientId, this.cfg.clientSecret, this.cfg.redirectUri);
+    }
+    async getAuthorizedClient(ctx) {
+        var _a, _b, _c, _d, _e, _f;
+        const existing = await this.tokenStore.getTokens(ctx);
+        if (!existing || !existing.refreshToken) {
+            const err = new Error("GOOGLE_NOT_CONNECTED");
+            err.code = "GOOGLE_NOT_CONNECTED";
+            throw err;
+        }
+        const oauth2Client = this.getOAuthClient();
+        oauth2Client.setCredentials({
+            access_token: (_a = existing.accessToken) !== null && _a !== void 0 ? _a : undefined,
+            refresh_token: (_b = existing.refreshToken) !== null && _b !== void 0 ? _b : undefined,
+            expiry_date: (_c = existing.expiryDate) !== null && _c !== void 0 ? _c : undefined,
+        });
+        const now = Date.now();
+        const fiveMinutesMs = 5 * 60 * 1000;
+        const needsRefresh = !existing.accessToken ||
+            !existing.expiryDate ||
+            existing.expiryDate <= now + fiveMinutesMs;
+        if (needsRefresh) {
+            const { credentials } = await oauth2Client.refreshAccessToken();
+            await this.tokenStore.saveTokens(ctx, {
+                accessToken: (_d = credentials.access_token) !== null && _d !== void 0 ? _d : null,
+                refreshToken: (_e = credentials.refresh_token) !== null && _e !== void 0 ? _e : existing.refreshToken,
+                expiryDate: (_f = credentials.expiry_date) !== null && _f !== void 0 ? _f : null,
+                raw: credentials,
+            });
+            oauth2Client.setCredentials(credentials);
+        }
+        return oauth2Client;
+    }
+    async isConnected(ctx) {
+        const tokens = await this.tokenStore.getTokens({
+            tenantId: ctx.tenantId,
+            providerId: this.id,
+        });
+        return {
+            tenantId: ctx.tenantId,
+            providerId: this.id,
+            connected: !!(tokens && tokens.refreshToken),
+        };
+    }
+    getAuthorizationUrl(options) {
+        var _a, _b, _c, _d;
+        const oauth2Client = this.getOAuthClient();
+        const statePayload = {
+            tenantId: options.tenantId,
+            returnUrl: (_a = options.returnUrl) !== null && _a !== void 0 ? _a : "",
+            customState: (_b = options.customState) !== null && _b !== void 0 ? _b : {},
+        };
+        const state = JSON.stringify(statePayload);
+        const url = oauth2Client.generateAuthUrl({
+            access_type: "offline",
+            prompt: "consent",
+            scope: SCOPES,
+            state,
+        });
+        (_d = (_c = this.cfg).logger) === null || _d === void 0 ? void 0 : _d.call(_c, "google-meet.auth-url.generated", {
+            tenantId: options.tenantId,
+        });
+        return {
+            providerId: this.id,
+            url,
+        };
+    }
+    async handleOAuthCallback(payload) {
+        var _a, _b, _c, _d, _e;
+        if (!payload.code || !payload.state) {
+            throw new Error("Missing code or state for Google OAuth callback");
+        }
+        let parsedState;
+        try {
+            parsedState = JSON.parse(payload.state);
+        }
+        catch {
+            throw new Error("Invalid state payload for Google OAuth callback");
+        }
+        const oauth2Client = this.getOAuthClient();
+        const { tokens } = await oauth2Client.getToken(payload.code);
+        const ctx = {
+            tenantId: parsedState.tenantId,
+            providerId: this.id,
+        };
+        await this.tokenStore.saveTokens(ctx, {
+            accessToken: (_a = tokens.access_token) !== null && _a !== void 0 ? _a : null,
+            refreshToken: (_b = tokens.refresh_token) !== null && _b !== void 0 ? _b : null,
+            expiryDate: (_c = tokens.expiry_date) !== null && _c !== void 0 ? _c : null,
+            raw: tokens,
+        });
+        (_e = (_d = this.cfg).logger) === null || _e === void 0 ? void 0 : _e.call(_d, "google-meet.oauth.tokens-saved", {
+            tenantId: parsedState.tenantId,
+            hasRefreshToken: !!tokens.refresh_token,
+        });
+        return {
+            tenantId: parsedState.tenantId,
+            providerId: this.id,
+        };
+    }
+    async createMeeting(req) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        const { tenantId, title, description, time, location, primaryParticipant, additionalParticipants, addConferenceLink = true } = req;
+        if (!(time === null || time === void 0 ? void 0 : time.start) || !(time === null || time === void 0 ? void 0 : time.end)) {
+            throw new Error("time.start and time.end are required");
+        }
+        const ctx = { tenantId, providerId: this.id };
+        const auth = await this.getAuthorizedClient(ctx);
+        const calendar = googleapis_1.google.calendar({ version: "v3", auth });
+        const attendees = [];
+        const pushParticipant = (p) => {
+            var _a;
+            const email = (_a = p === null || p === void 0 ? void 0 : p.email) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase();
+            if (!email)
+                return;
+            attendees.push({
+                email,
+                displayName: p === null || p === void 0 ? void 0 : p.displayName,
+                responseStatus: "needsAction",
+            });
+        };
+        pushParticipant(primaryParticipant !== null && primaryParticipant !== void 0 ? primaryParticipant : undefined);
+        (additionalParticipants !== null && additionalParticipants !== void 0 ? additionalParticipants : []).forEach((p) => pushParticipant(p));
+        const event = {
+            summary: title,
+            description: description !== null && description !== void 0 ? description : "",
+            location: addConferenceLink ? undefined : location === null || location === void 0 ? void 0 : location.value,
+            start: {
+                dateTime: time.start,
+                timeZone: (_a = time.timezone) !== null && _a !== void 0 ? _a : "UTC",
+            },
+            end: {
+                dateTime: time.end,
+                timeZone: (_b = time.timezone) !== null && _b !== void 0 ? _b : "UTC",
+            },
+            attendees,
+            ...(addConferenceLink
+                ? {
+                    conferenceData: {
+                        createRequest: {
+                            requestId: (0, crypto_1.randomUUID)(),
+                            conferenceSolutionKey: {
+                                type: "hangoutsMeet",
+                            },
+                        },
+                    },
+                }
+                : {}),
+        };
+        const { data: created } = await calendar.events.insert({
+            calendarId: "primary",
+            requestBody: event,
+            sendUpdates: "all",
+            ...(addConferenceLink ? { conferenceDataVersion: 1 } : {}),
+        });
+        const links = [];
+        const entryPoints = (_d = (_c = created.conferenceData) === null || _c === void 0 ? void 0 : _c.entryPoints) !== null && _d !== void 0 ? _d : [];
+        for (const ep of entryPoints) {
+            if (!ep.uri)
+                continue;
+            const type = ep.entryPointType === "video"
+                ? "video"
+                : ep.entryPointType === "phone"
+                    ? "phone"
+                    : ep.entryPointType === "sip"
+                        ? "sip"
+                        : "custom";
+            links.push({ type, uri: ep.uri });
+        }
+        const primaryVideoLink = (_g = (_f = (_e = links.find((l) => l.type === "video")) === null || _e === void 0 ? void 0 : _e.uri) !== null && _f !== void 0 ? _f : created.hangoutLink) !== null && _g !== void 0 ? _g : null;
+        const result = {
+            providerId: this.id,
+            providerEventId: (_h = created.id) !== null && _h !== void 0 ? _h : "",
+            title: (_j = created.summary) !== null && _j !== void 0 ? _j : title,
+            description: (_k = created.description) !== null && _k !== void 0 ? _k : description,
+            time: {
+                start: (_m = (_l = created.start) === null || _l === void 0 ? void 0 : _l.dateTime) !== null && _m !== void 0 ? _m : time.start,
+                end: (_p = (_o = created.end) === null || _o === void 0 ? void 0 : _o.dateTime) !== null && _p !== void 0 ? _p : time.end,
+                timezone: (_q = time.timezone) !== null && _q !== void 0 ? _q : "UTC",
+            },
+            location: addConferenceLink
+                ? { type: "online", value: primaryVideoLink !== null && primaryVideoLink !== void 0 ? primaryVideoLink : undefined }
+                : location,
+            calendarUrl: (_r = created.htmlLink) !== null && _r !== void 0 ? _r : null,
+            conferenceLink: primaryVideoLink,
+            conferenceLinks: links,
+            raw: created,
+        };
+        (_t = (_s = this.cfg).logger) === null || _t === void 0 ? void 0 : _t.call(_s, "google-meet.meeting.created", {
+            tenantId,
+            eventId: result.providerEventId,
+            hasConferenceLink: !!result.conferenceLink,
+        });
+        return result;
+    }
+}
+exports.GoogleMeetProvider = GoogleMeetProvider;
+//# sourceMappingURL=GoogleMeetProvider.js.map

package/dist/providers/google/GoogleMeetProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMeetProvider.js","sourceRoot":"","sources":["../../../src/providers/google/GoogleMeetProvider.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AACjD,mCAAoC;AAyBpC,MAAM,MAAM,GAAG,CAAC,0CAA0C,CAAC,CAAC;AAE5D,MAAa,kBAAkB;IAM7B,YAAY,GAA6B,EAAE,UAAsB;QALjD,OAAE,GAAG,aAAsB,CAAC;QAM1C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEO,cAAc;QACpB,OAAO,IAAI,mBAAM,CAAC,IAAI,CAAC,MAAM,CAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,EACjB,IAAI,CAAC,GAAG,CAAC,YAAY,EACrB,IAAI,CAAC,GAAG,CAAC,WAAW,CACrB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,GAAsB;;QACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC7C,GAAW,CAAC,IAAI,GAAG,sBAAsB,CAAC;YAC3C,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,YAAY,CAAC,cAAc,CAAC;YAC1B,YAAY,EAAE,MAAA,QAAQ,CAAC,WAAW,mCAAI,SAAS;YAC/C,aAAa,EAAE,MAAA,QAAQ,CAAC,YAAY,mCAAI,SAAS;YACjD,WAAW,EAAE,MAAA,QAAQ,CAAC,UAAU,mCAAI,SAAS;SAC9C,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACpC,MAAM,YAAY,GAChB,CAAC,QAAQ,CAAC,WAAW;YACrB,CAAC,QAAQ,CAAC,UAAU;YACpB,QAAQ,CAAC,UAAU,IAAI,GAAG,GAAG,aAAa,CAAC;QAE7C,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,YAAY,CAAC,kBAAkB,EAAE,CAAC;YAChE,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE;gBACpC,WAAW,EAAE,MAAA,WAAW,CAAC,YAAY,mCAAI,IAAI;gBAC7C,YAAY,EAAE,MAAA,WAAW,CAAC,aAAa,mCAAI,QAAQ,CAAC,YAAY;gBAChE,UAAU,EAAE,MAAA,WAAW,CAAC,WAAW,mCAAI,IAAI;gBAC3C,GAAG,EAAE,WAAW;aACjB,CAAC,CAAC;YACH,YAAY,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAyB;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAC7C,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,EAAE;SACpB,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC;SAC7C,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,OAA0B;;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,MAAM,YAAY,GAAG;YACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,MAAA,OAAO,CAAC,SAAS,mCAAI,EAAE;YAClC,WAAW,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,EAAE;SACvC,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAE3C,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,MAAM;YACb,KAAK;SACN,CAAC,CAAC;QAEH,MAAA,MAAA,IAAI,CAAC,GAAG,EAAC,MAAM,mDAAG,gCAAgC,EAAE;YAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAA6B;;QACrD,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,WAAiC,CAAC;QACtC,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAyB,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE7D,MAAM,GAAG,GAAsB;YAC7B,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,UAAU,EAAE,IAAI,CAAC,EAAE;SACpB,CAAC;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE;YACpC,WAAW,EAAE,MAAA,MAAM,CAAC,YAAY,mCAAI,IAAI;YACxC,YAAY,EAAE,MAAA,MAAM,CAAC,aAAa,mCAAI,IAAI;YAC1C,UAAU,EAAE,MAAA,MAAM,CAAC,WAAW,mCAAI,IAAI;YACtC,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QAEH,MAAA,MAAA,IAAI,CAAC,GAAG,EAAC,MAAM,mDAAG,gCAAgC,EAAE;YAClD,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa;SACxC,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,UAAU,EAAE,IAAI,CAAC,EAAE;SACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAyB;;QAC3C,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,iBAAiB,GAAG,IAAI,EAAE,GAC1H,GAAG,CAAC;QAEN,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAAA,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CAAA,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,GAAG,GAAsB,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,mBAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1D,MAAM,SAAS,GAAuC,EAAE,CAAC;QACzD,MAAM,eAAe,GAAG,CAAC,CAAmD,EAAE,EAAE;;YAC9E,MAAM,KAAK,GAAG,MAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,0CAAE,IAAI,GAAG,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,SAAS,CAAC,IAAI,CAAC;gBACb,KAAK;gBACL,WAAW,EAAE,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,WAAW;gBAC3B,cAAc,EAAE,aAAa;aAC9B,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,eAAe,CAAC,kBAAkB,aAAlB,kBAAkB,cAAlB,kBAAkB,GAAI,SAAS,CAAC,CAAC;QACjD,CAAC,sBAAsB,aAAtB,sBAAsB,cAAtB,sBAAsB,GAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAElE,MAAM,KAAK,GAA6B;YACtC,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE;YAC9B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,KAAK;YACzD,KAAK,EAAE;gBACL,QAAQ,EAAE,IAAI,CAAC,KAAK;gBACpB,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,mCAAI,KAAK;aACjC;YACD,GAAG,EAAE;gBACH,QAAQ,EAAE,IAAI,CAAC,GAAG;gBAClB,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,mCAAI,KAAK;aACjC;YACD,SAAS;YACT,GAAG,CAAC,iBAAiB;gBACnB,CAAC,CAAC;oBACE,cAAc,EAAE;wBACd,aAAa,EAAE;4BACb,SAAS,EAAE,IAAA,mBAAU,GAAE;4BACvB,qBAAqB,EAAE;gCACrB,IAAI,EAAE,cAAc;6BACrB;yBACF;qBACF;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QAEF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;YACrD,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAC,CAAC;QAEH,MAAM,KAAK,GAAsC,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,MAAA,MAAA,OAAO,CAAC,cAAc,0CAAE,WAAW,mCAAI,EAAE,CAAC;QAC9D,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,EAAE,CAAC,GAAG;gBAAE,SAAS;YACtB,MAAM,IAAI,GACR,EAAE,CAAC,cAAc,KAAK,OAAO;gBAC3B,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,EAAE,CAAC,cAAc,KAAK,OAAO;oBAC/B,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,EAAE,CAAC,cAAc,KAAK,KAAK;wBAC7B,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,QAAQ,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,gBAAgB,GACpB,MAAA,MAAA,MAAA,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,0CAAE,GAAG,mCAC1C,OAAO,CAAC,WAAW,mCACnB,IAAI,CAAC;QAEP,MAAM,MAAM,GAAmB;YAC7B,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,eAAe,EAAE,MAAA,OAAO,CAAC,EAAE,mCAAI,EAAE;YACjC,KAAK,EAAE,MAAA,OAAO,CAAC,OAAO,mCAAI,KAAK;YAC/B,WAAW,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,WAAW;YAC/C,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,QAAQ,mCAAI,IAAI,CAAC,KAAK;gBAC5C,GAAG,EAAE,MAAA,MAAA,OAAO,CAAC,GAAG,0CAAE,QAAQ,mCAAI,IAAI,CAAC,GAAG;gBACtC,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,mCAAI,KAAK;aACjC;YACD,QAAQ,EAAE,iBAAiB;gBACzB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,SAAS,EAAE;gBAC1D,CAAC,CAAC,QAAQ;YACZ,WAAW,EAAE,MAAA,OAAO,CAAC,QAAQ,mCAAI,IAAI;YACrC,cAAc,EAAE,gBAAgB;YAChC,eAAe,EAAE,KAAK;YACtB,GAAG,EAAE,OAAO;SACb,CAAC;QAEF,MAAA,MAAA,IAAI,CAAC,GAAG,EAAC,MAAM,mDAAG,6BAA6B,EAAE;YAC/C,QAAQ;YACR,OAAO,EAAE,MAAM,CAAC,eAAe;YAC/B,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc;SAC3C,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA9OD,gDA8OC"}

package/dist/store/TokenStore.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderId, TenantContext, TokenRecord } from "../types";
+export interface TokenStoreContext extends TenantContext {
+    providerId: ProviderId;
+}
+/**
+ * Abstraction for securely persisting provider credentials.
+ * You will plug in your own implementation (DB, KMS, Vault, etc.).
+ */
+export interface TokenStore {
+    getTokens(ctx: TokenStoreContext): Promise<TokenRecord | null>;
+    saveTokens(ctx: TokenStoreContext, tokens: TokenRecord): Promise<void>;
+}
+//# sourceMappingURL=TokenStore.d.ts.map

package/dist/store/TokenStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenStore.d.ts","sourceRoot":"","sources":["../../src/store/TokenStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC/D,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}

package/dist/store/TokenStore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TokenStore.js.map

package/dist/store/TokenStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenStore.js","sourceRoot":"","sources":["../../src/store/TokenStore.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,104 @@
+export type ProviderId = "google-meet" | "zoom" | "microsoft-teams" | "calendly" | string;
+export interface TenantContext {
+    /**
+     * Stable, non-PII identifier for the tenant / employer / account.
+     * You own and control this id – we never assume DB structure.
+     */
+    tenantId: string;
+}
+export interface MeetingParticipant {
+    email: string;
+    displayName?: string;
+    optional?: boolean;
+}
+export interface MeetingTimeRange {
+    start: string;
+    end: string;
+    timezone?: string;
+}
+export type LocationType = "online" | "offline";
+export interface MeetingLocation {
+    type: LocationType;
+    /**
+     * For offline meetings, this is the physical address.
+     * For online meetings, providers typically attach the URL themselves,
+     * but you can still pass a custom value if needed.
+     */
+    value?: string;
+}
+export interface CreateMeetingRequest extends TenantContext {
+    providerId: ProviderId;
+    title: string;
+    description?: string;
+    time: MeetingTimeRange;
+    location?: MeetingLocation;
+    primaryParticipant?: MeetingParticipant | null;
+    additionalParticipants?: MeetingParticipant[];
+    /**
+     * Whether to attach a video-conference link if supported
+     * (e.g. Google Meet, Teams, Zoom).
+     */
+    addConferenceLink?: boolean;
+    /**
+     * Arbitrary metadata that you want to round-trip.
+     * Never logged or parsed by the SDK.
+     */
+    metadata?: Record<string, unknown>;
+}
+export interface MeetingLink {
+    type: "video" | "phone" | "sip" | "custom";
+    uri: string;
+}
+export interface CreatedMeeting {
+    providerId: ProviderId;
+    providerEventId: string;
+    title: string;
+    description?: string;
+    time: MeetingTimeRange;
+    location?: MeetingLocation;
+    calendarUrl?: string | null;
+    conferenceLink?: string | null;
+    conferenceLinks?: MeetingLink[];
+    raw?: unknown;
+}
+export interface ProviderConnectionStatus extends TenantContext {
+    providerId: ProviderId;
+    connected: boolean;
+}
+export interface GetAuthUrlOptions extends TenantContext {
+    /**
+     * Which video provider to use, e.g. "google-meet".
+     */
+    providerId: ProviderId;
+    /**
+     * Optional return URL you can encode in provider state and
+     * use to redirect the user back to a specific frontend route.
+     */
+    returnUrl?: string;
+    /**
+     * Opaque state payload you want to round-trip through the provider.
+     * Not all providers will support full custom state.
+     */
+    customState?: Record<string, unknown>;
+}
+export interface AuthUrlResult {
+    providerId: ProviderId;
+    url: string;
+}
+export interface OAuthCallbackPayload {
+    code: string;
+    state?: string | null;
+}
+export interface OAuthCallbackResult extends TenantContext {
+    providerId: ProviderId;
+}
+export interface TokenRecord {
+    accessToken: string | null;
+    refreshToken: string | null;
+    expiryDate: number | null;
+    /**
+     * Raw provider-specific credentials object (e.g. Google OAuth2 credentials).
+     */
+    raw?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "meetschedify",
+  "version": "0.1.0",
+  "description": "Enterprise-ready multi-provider video meeting scheduling SDK (Google Meet today, Zoom/Teams/Calendly and more tomorrow).",
+  "license": "MIT",
+  "author": "Raj Kumar Singha",
+  "keywords": [
+    "meeting",
+    "scheduler",
+    "video",
+    "google-meet",
+    "zoom",
+    "microsoft-teams",
+    "calendly",
+    "calendar",
+    "enterprise"
+  ],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "prepublishOnly": "npm run clean && npm run build && npm test",
+    "test": "echo \"Add tests for meetSchedify here\""
+  },
+  "dependencies": {
+    "googleapis": "^131.0.0"
+  },
+  "peerDependencies": {
+    "googleapis": ">=100.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "rimraf": "^5.0.0",
+    "eslint": "^9.0.0"
+  }
+}