@contractspec/integration.providers-impls 0.0.0-canary-20260113170453

package/LICENSE

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

package/README.md

@@ -0,0 +1,20 @@
+# @contractspec/integration.providers-impls
+
+Website: https://contractspec.io/
+
+
+SDK-backed implementations of ContractSpec integration provider interfaces.
+
+Depends on:
+- `@contractspec/lib.contracts` for provider interface types and IntegrationSpec declarations
+- `@contractspec/integration.runtime` for secret/guard helpers (when needed)
+
+
+
+
+
+
+
+
+
+

package/dist/_virtual/rolldown_runtime.js

@@ -0,0 +1,36 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+//#endregion
+export { __exportAll, __reExport };

package/dist/calendar.d.ts

@@ -0,0 +1,8 @@
+export * from "@contractspec/lib.contracts/integrations/providers/calendar";
+
+//#region src/calendar.d.ts
+
+import * as import__contractspec_lib_contracts_integrations_providers_calendar from "@contractspec/lib.contracts/integrations/providers/calendar";
+//#endregion
+export { import__contractspec_lib_contracts_integrations_providers_calendar as calendar_d_exports };
+//# sourceMappingURL=calendar.d.ts.map

package/dist/calendar.d.ts.map

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

package/dist/calendar.js

@@ -0,0 +1,3 @@
+import { __reExport } from "./_virtual/rolldown_runtime.js";
+
+export * from "@contractspec/lib.contracts/integrations/providers/calendar"

package/dist/email.d.ts

@@ -0,0 +1,8 @@
+export * from "@contractspec/lib.contracts/integrations/providers/email";
+
+//#region src/email.d.ts
+
+import * as import__contractspec_lib_contracts_integrations_providers_email from "@contractspec/lib.contracts/integrations/providers/email";
+//#endregion
+export { import__contractspec_lib_contracts_integrations_providers_email as email_d_exports };
+//# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","names":[],"sources":["../src/email.ts"],"sourcesContent":[],"mappings":""}

package/dist/email.js

@@ -0,0 +1,3 @@
+import { __reExport } from "./_virtual/rolldown_runtime.js";
+
+export * from "@contractspec/lib.contracts/integrations/providers/email"

package/dist/embedding.d.ts

@@ -0,0 +1,8 @@
+export * from "@contractspec/lib.contracts/integrations/providers/embedding";
+
+//#region src/embedding.d.ts
+
+import * as import__contractspec_lib_contracts_integrations_providers_embedding from "@contractspec/lib.contracts/integrations/providers/embedding";
+//#endregion
+export { import__contractspec_lib_contracts_integrations_providers_embedding as embedding_d_exports };
+//# sourceMappingURL=embedding.d.ts.map

package/dist/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","names":[],"sources":["../src/embedding.ts"],"sourcesContent":[],"mappings":""}

package/dist/embedding.js

@@ -0,0 +1,3 @@
+import { __reExport } from "./_virtual/rolldown_runtime.js";
+
+export * from "@contractspec/lib.contracts/integrations/providers/embedding"

package/dist/impls/elevenlabs-voice.d.ts

@@ -0,0 +1,21 @@
+import { voice_d_exports } from "../voice.js";
+import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
+
+//#region src/impls/elevenlabs-voice.d.ts
+interface ElevenLabsVoiceProviderOptions {
+  apiKey: string;
+  defaultVoiceId?: string;
+  modelId?: string;
+  client?: ElevenLabsClient;
+}
+declare class ElevenLabsVoiceProvider implements voice_d_exports.VoiceProvider {
+  private readonly client;
+  private readonly defaultVoiceId?;
+  private readonly modelId?;
+  constructor(options: ElevenLabsVoiceProviderOptions);
+  listVoices(): Promise<voice_d_exports.Voice[]>;
+  synthesize(input: voice_d_exports.VoiceSynthesisInput): Promise<voice_d_exports.VoiceSynthesisResult>;
+}
+//#endregion
+export { ElevenLabsVoiceProvider, ElevenLabsVoiceProviderOptions };
+//# sourceMappingURL=elevenlabs-voice.d.ts.map

package/dist/impls/elevenlabs-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-voice.d.ts","names":[],"sources":["../../src/impls/elevenlabs-voice.ts"],"sourcesContent":[],"mappings":";;;;UAUiB,8BAAA;;EAAA,cAAA,CAAA,EAAA,MAAA;EAiCJ,OAAA,CAAA,EAAA,MAAA;EAKU,MAAA,CAAA,EAlCZ,gBAkCY;;AAUD,cAfT,uBAAA,YAAmC,eAAA,CAAA,aAe1B,CAAA;EAkBI,iBAAA,MAAA;EAA8B,iBAAA,cAAA;EAAR,iBAAA,OAAA;EAjCA,WAAA,CAAA,OAAA,EAKzB,8BALyB;EAAa,UAAA,CAAA,CAAA,EAevC,OAfuC,CAe/B,eAAA,CAAA,KAf+B,EAAA,CAAA;oBAiCnC,eAAA,CAAA,sBAAsB,QAAQ,eAAA,CAAA"}

package/dist/impls/elevenlabs-voice.js

@@ -0,0 +1,93 @@
+import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
+
+//#region src/impls/elevenlabs-voice.ts
+const FORMAT_MAP = {
+	mp3: "mp3_44100_128",
+	wav: "pcm_44100",
+	ogg: "mp3_44100_128",
+	pcm: "pcm_16000"
+};
+const SAMPLE_RATE = {
+	mp3_22050_32: 22050,
+	mp3_44100_32: 44100,
+	mp3_44100_64: 44100,
+	mp3_44100_96: 44100,
+	mp3_44100_128: 44100,
+	mp3_44100_192: 44100,
+	pcm_16000: 16e3,
+	pcm_22050: 22050,
+	pcm_24000: 24e3,
+	pcm_44100: 44100,
+	ulaw_8000: 8e3
+};
+var ElevenLabsVoiceProvider = class {
+	client;
+	defaultVoiceId;
+	modelId;
+	constructor(options) {
+		this.client = options.client ?? new ElevenLabsClient({ apiKey: options.apiKey });
+		this.defaultVoiceId = options.defaultVoiceId;
+		this.modelId = options.modelId;
+	}
+	async listVoices() {
+		return ((await this.client.voices.getAll()).voices ?? []).map((voice) => ({
+			id: voice.voiceId ?? "",
+			name: voice.name ?? "",
+			description: voice.description ?? void 0,
+			language: voice.labels?.language ?? void 0,
+			metadata: {
+				category: voice.category ?? "",
+				...voice.previewUrl ? { previewUrl: voice.previewUrl } : {},
+				...(() => {
+					const { language, ...rest } = voice.labels ?? {};
+					return rest;
+				})()
+			}
+		}));
+	}
+	async synthesize(input) {
+		const voiceId = input.voiceId ?? this.defaultVoiceId;
+		if (!voiceId) throw new Error("Voice ID is required for ElevenLabs synthesis.");
+		const formatKey = input.format ?? "mp3";
+		const outputFormat = FORMAT_MAP[formatKey] ?? FORMAT_MAP.mp3;
+		const sampleRate = input.sampleRateHz ?? SAMPLE_RATE[outputFormat] ?? SAMPLE_RATE.mp3_44100_128 ?? 44100;
+		const voiceSettings = input.stability != null || input.similarityBoost != null || input.style != null ? {
+			...input.stability != null ? { stability: input.stability } : {},
+			...input.similarityBoost != null ? { similarityBoost: input.similarityBoost } : {},
+			...input.style != null ? { style: input.style } : {}
+		} : void 0;
+		return {
+			audio: await readWebStream(await this.client.textToSpeech.convert(voiceId, {
+				text: input.text,
+				modelId: this.modelId,
+				outputFormat,
+				voiceSettings
+			})),
+			format: formatKey,
+			sampleRateHz: sampleRate,
+			durationSeconds: void 0,
+			url: void 0
+		};
+	}
+};
+async function readWebStream(stream) {
+	const reader = stream.getReader();
+	const chunks = [];
+	while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		if (value) chunks.push(value);
+	}
+	const length = chunks.reduce((total, chunk) => total + chunk.length, 0);
+	const result = new Uint8Array(length);
+	let offset = 0;
+	for (const chunk of chunks) {
+		result.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return result;
+}
+
+//#endregion
+export { ElevenLabsVoiceProvider };
+//# sourceMappingURL=elevenlabs-voice.js.map

package/dist/impls/elevenlabs-voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-voice.js","names":[],"sources":["../../src/impls/elevenlabs-voice.ts"],"sourcesContent":["import type { ElevenLabs } from '@elevenlabs/elevenlabs-js';\nimport { ElevenLabsClient } from '@elevenlabs/elevenlabs-js';\n\nimport type {\n  Voice,\n  VoiceProvider,\n  VoiceSynthesisInput,\n  VoiceSynthesisResult,\n} from '../voice';\n\nexport interface ElevenLabsVoiceProviderOptions {\n  apiKey: string;\n  defaultVoiceId?: string;\n  modelId?: string;\n  client?: ElevenLabsClient;\n}\n\nconst FORMAT_MAP: Record<\n  NonNullable<VoiceSynthesisInput['format']>,\n  ElevenLabs.TextToSpeechConvertRequestOutputFormat\n> = {\n  mp3: 'mp3_44100_128',\n  wav: 'pcm_44100',\n  ogg: 'mp3_44100_128',\n  pcm: 'pcm_16000',\n};\n\nconst SAMPLE_RATE: Partial<\n  Record<ElevenLabs.TextToSpeechConvertRequestOutputFormat, number>\n> = {\n  mp3_22050_32: 22050,\n  mp3_44100_32: 44100,\n  mp3_44100_64: 44100,\n  mp3_44100_96: 44100,\n  mp3_44100_128: 44100,\n  mp3_44100_192: 44100,\n  pcm_16000: 16000,\n  pcm_22050: 22050,\n  pcm_24000: 24000,\n  pcm_44100: 44100,\n  ulaw_8000: 8000,\n};\n\nexport class ElevenLabsVoiceProvider implements VoiceProvider {\n  private readonly client: ElevenLabsClient;\n  private readonly defaultVoiceId?: string;\n  private readonly modelId?: string;\n\n  constructor(options: ElevenLabsVoiceProviderOptions) {\n    this.client =\n      options.client ??\n      new ElevenLabsClient({\n        apiKey: options.apiKey,\n      });\n    this.defaultVoiceId = options.defaultVoiceId;\n    this.modelId = options.modelId;\n  }\n\n  async listVoices(): Promise<Voice[]> {\n    const response = await this.client.voices.getAll();\n    return (response.voices ?? []).map((voice) => ({\n      id: voice.voiceId ?? '',\n      name: voice.name ?? '',\n      description: voice.description ?? undefined,\n      language: voice.labels?.language ?? undefined,\n      metadata: {\n        category: voice.category ?? '',\n        ...(voice.previewUrl ? { previewUrl: voice.previewUrl } : {}),\n        ...(() => {\n          const { language, ...rest } = voice.labels ?? {};\n          return rest;\n        })(),\n      },\n    }));\n  }\n\n  async synthesize(input: VoiceSynthesisInput): Promise<VoiceSynthesisResult> {\n    const voiceId = input.voiceId ?? this.defaultVoiceId;\n    if (!voiceId) {\n      throw new Error('Voice ID is required for ElevenLabs synthesis.');\n    }\n\n    const formatKey = input.format ?? 'mp3';\n    const outputFormat = FORMAT_MAP[formatKey] ?? FORMAT_MAP.mp3;\n    const sampleRate =\n      input.sampleRateHz ??\n      SAMPLE_RATE[outputFormat] ??\n      SAMPLE_RATE.mp3_44100_128 ??\n      44100;\n\n    const voiceSettings =\n      input.stability != null ||\n      input.similarityBoost != null ||\n      input.style != null\n        ? {\n            ...(input.stability != null ? { stability: input.stability } : {}),\n            ...(input.similarityBoost != null\n              ? { similarityBoost: input.similarityBoost }\n              : {}),\n            ...(input.style != null ? { style: input.style } : {}),\n          }\n        : undefined;\n\n    const stream = await this.client.textToSpeech.convert(voiceId, {\n      text: input.text,\n      modelId: this.modelId,\n      outputFormat,\n      voiceSettings,\n    });\n\n    const audio = await readWebStream(stream);\n\n    return {\n      audio,\n      format: formatKey,\n      sampleRateHz: sampleRate,\n      durationSeconds: undefined,\n      url: undefined,\n    };\n  }\n}\n\nasync function readWebStream(\n  stream: ReadableStream<Uint8Array>\n): Promise<Uint8Array> {\n  const reader = stream.getReader();\n  const chunks: Uint8Array[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (value) {\n      chunks.push(value);\n    }\n  }\n\n  const length = chunks.reduce((total, chunk) => total + chunk.length, 0);\n  const result = new Uint8Array(length);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.length;\n  }\n  return result;\n}\n"],"mappings":";;;AAiBA,MAAM,aAGF;CACF,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;AAED,MAAM,cAEF;CACF,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,eAAe;CACf,eAAe;CACf,WAAW;CACX,WAAW;CACX,WAAW;CACX,WAAW;CACX,WAAW;CACZ;AAED,IAAa,0BAAb,MAA8D;CAC5D,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAyC;AACnD,OAAK,SACH,QAAQ,UACR,IAAI,iBAAiB,EACnB,QAAQ,QAAQ,QACjB,CAAC;AACJ,OAAK,iBAAiB,QAAQ;AAC9B,OAAK,UAAU,QAAQ;;CAGzB,MAAM,aAA+B;AAEnC,WADiB,MAAM,KAAK,OAAO,OAAO,QAAQ,EACjC,UAAU,EAAE,EAAE,KAAK,WAAW;GAC7C,IAAI,MAAM,WAAW;GACrB,MAAM,MAAM,QAAQ;GACpB,aAAa,MAAM,eAAe;GAClC,UAAU,MAAM,QAAQ,YAAY;GACpC,UAAU;IACR,UAAU,MAAM,YAAY;IAC5B,GAAI,MAAM,aAAa,EAAE,YAAY,MAAM,YAAY,GAAG,EAAE;IAC5D,UAAU;KACR,MAAM,EAAE,UAAU,GAAG,SAAS,MAAM,UAAU,EAAE;AAChD,YAAO;QACL;IACL;GACF,EAAE;;CAGL,MAAM,WAAW,OAA2D;EAC1E,MAAM,UAAU,MAAM,WAAW,KAAK;AACtC,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,iDAAiD;EAGnE,MAAM,YAAY,MAAM,UAAU;EAClC,MAAM,eAAe,WAAW,cAAc,WAAW;EACzD,MAAM,aACJ,MAAM,gBACN,YAAY,iBACZ,YAAY,iBACZ;EAEF,MAAM,gBACJ,MAAM,aAAa,QACnB,MAAM,mBAAmB,QACzB,MAAM,SAAS,OACX;GACE,GAAI,MAAM,aAAa,OAAO,EAAE,WAAW,MAAM,WAAW,GAAG,EAAE;GACjE,GAAI,MAAM,mBAAmB,OACzB,EAAE,iBAAiB,MAAM,iBAAiB,GAC1C,EAAE;GACN,GAAI,MAAM,SAAS,OAAO,EAAE,OAAO,MAAM,OAAO,GAAG,EAAE;GACtD,GACD;AAWN,SAAO;GACL,OAHY,MAAM,cAPL,MAAM,KAAK,OAAO,aAAa,QAAQ,SAAS;IAC7D,MAAM,MAAM;IACZ,SAAS,KAAK;IACd;IACA;IACD,CAAC,CAEuC;GAIvC,QAAQ;GACR,cAAc;GACd,iBAAiB;GACjB,KAAK;GACN;;;AAIL,eAAe,cACb,QACqB;CACrB,MAAM,SAAS,OAAO,WAAW;CACjC,MAAM,SAAuB,EAAE;AAE/B,QAAO,MAAM;EACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,MAAI,KAAM;AACV,MAAI,MACF,QAAO,KAAK,MAAM;;CAItB,MAAM,SAAS,OAAO,QAAQ,OAAO,UAAU,QAAQ,MAAM,QAAQ,EAAE;CACvE,MAAM,SAAS,IAAI,WAAW,OAAO;CACrC,IAAI,SAAS;AACb,MAAK,MAAM,SAAS,QAAQ;AAC1B,SAAO,IAAI,OAAO,OAAO;AACzB,YAAU,MAAM;;AAElB,QAAO"}

package/dist/impls/gcs-storage.d.ts

@@ -0,0 +1,25 @@
+import { storage_d_exports } from "../storage.js";
+import { Storage, StorageOptions } from "@google-cloud/storage";
+
+//#region src/impls/gcs-storage.d.ts
+interface GoogleCloudStorageProviderOptions {
+  bucket: string;
+  storage?: Storage;
+  clientOptions?: StorageOptions;
+}
+declare class GoogleCloudStorageProvider implements storage_d_exports.ObjectStorageProvider {
+  private readonly storage;
+  private readonly bucketName;
+  constructor(options: GoogleCloudStorageProviderOptions);
+  putObject(input: storage_d_exports.PutObjectInput): Promise<storage_d_exports.StorageObjectMetadata>;
+  getObject(input: storage_d_exports.DeleteObjectInput): Promise<storage_d_exports.GetObjectResult | null>;
+  deleteObject(input: storage_d_exports.DeleteObjectInput): Promise<void>;
+  generateSignedUrl(options: storage_d_exports.SignedUrlOptions): Promise<{
+    url: string;
+    expiresAt: Date;
+  }>;
+  listObjects(query: storage_d_exports.ListObjectsQuery): Promise<storage_d_exports.ListObjectsResult>;
+}
+//#endregion
+export { GoogleCloudStorageProvider, GoogleCloudStorageProviderOptions };
+//# sourceMappingURL=gcs-storage.d.ts.map

package/dist/impls/gcs-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs-storage.d.ts","names":[],"sources":["../../src/impls/gcs-storage.ts"],"sourcesContent":[],"mappings":";;;;UAaiB,iCAAA;;EAAA,OAAA,CAAA,EAEL,OAFK;EAMJ,aAAA,CAAA,EAHK,cAGsB;;AAUf,cAVZ,0BAAA,YAAsC,iBAAA,CAAA,qBAU1B,CAAA;EAAyB,iBAAA,OAAA;EAAR,iBAAA,UAAA;EAiBjB,WAAA,CAAA,OAAA,EAvBF,iCAuBE;EAA4B,SAAA,CAAA,KAAA,EAjB5B,iBAAA,CAAA,cAiB4B,CAAA,EAjBX,OAiBW,CAjBH,iBAAA,CAAA,qBAiBG,CAAA;EAAR,SAAA,CAAA,KAAA,EAApB,iBAAA,CAAA,iBAAoB,CAAA,EAAA,OAAA,CAAQ,iBAAA,CAAA,eAAR,GAAA,IAAA,CAAA;EAcjB,YAAA,CAAA,KAAA,EAAA,iBAAA,CAAA,iBAAA,CAAA,EAAoB,OAApB,CAAA,IAAA,CAAA;EAAoB,iBAAA,CAAA,OAAA,EAOb,iBAAA,CAAA,gBAPa,CAAA,EAOM,OAPN,CAAA;IAOb,GAAA,EAAA,MAAA;IAEpB,SAAA,EAAA,IAAA;EAFuC,CAAA,CAAA;EAiB3B,WAAA,CAAA,KAAA,EAAA,iBAAA,CAAA,gBAAA,CAAA,EAAmB,OAAnB,CAA2B,iBAAA,CAAA,iBAA3B,CAAA"}

package/dist/impls/gcs-storage.js

@@ -0,0 +1,90 @@
+import { Storage } from "@google-cloud/storage";
+
+//#region src/impls/gcs-storage.ts
+var GoogleCloudStorageProvider = class {
+	storage;
+	bucketName;
+	constructor(options) {
+		this.storage = options.storage ?? new Storage(options.clientOptions ?? void 0);
+		this.bucketName = options.bucket;
+	}
+	async putObject(input) {
+		const bucketName = input.bucket ?? this.bucketName;
+		const file = this.storage.bucket(bucketName).file(input.key);
+		const buffer = toBuffer(input.data);
+		await file.save(buffer, {
+			resumable: false,
+			contentType: input.contentType,
+			metadata: input.metadata
+		});
+		if (input.makePublic) await file.makePublic();
+		const [metadata] = await file.getMetadata();
+		return toMetadata(metadata);
+	}
+	async getObject(input) {
+		const bucketName = input.bucket ?? this.bucketName;
+		const file = this.storage.bucket(bucketName).file(input.key);
+		const [exists] = await file.exists();
+		if (!exists) return null;
+		const [contents] = await file.download();
+		const [metadata] = await file.getMetadata();
+		return {
+			...toMetadata(metadata),
+			data: new Uint8Array(contents)
+		};
+	}
+	async deleteObject(input) {
+		const bucketName = input.bucket ?? this.bucketName;
+		await this.storage.bucket(bucketName).file(input.key).delete({ ignoreNotFound: true });
+	}
+	async generateSignedUrl(options) {
+		const bucketName = options.bucket ?? this.bucketName;
+		const file = this.storage.bucket(bucketName).file(options.key);
+		const action = options.method === "PUT" ? "write" : "read";
+		const expires = Date.now() + options.expiresInSeconds * 1e3;
+		const [url] = await file.getSignedUrl({
+			action,
+			expires,
+			contentType: options.contentType
+		});
+		return {
+			url,
+			expiresAt: new Date(expires)
+		};
+	}
+	async listObjects(query) {
+		const bucketName = query.bucket ?? this.bucketName;
+		const [files, nextQuery, response] = await this.storage.bucket(bucketName).getFiles({
+			prefix: query.prefix,
+			maxResults: query.maxResults,
+			pageToken: query.pageToken
+		});
+		const nextTokenFromQuery = typeof nextQuery === "object" && nextQuery !== null && "pageToken" in nextQuery ? nextQuery.pageToken : void 0;
+		const nextTokenFromResponse = response && typeof response === "object" && "nextPageToken" in response ? response.nextPageToken : void 0;
+		return {
+			objects: files.map((file) => toMetadata(file.metadata)),
+			nextPageToken: nextTokenFromQuery ?? nextTokenFromResponse ?? void 0
+		};
+	}
+};
+function toBuffer(data) {
+	if (data instanceof Uint8Array) return Buffer.from(data);
+	return Buffer.from(data);
+}
+function toMetadata(metadata) {
+	const meta = metadata;
+	return {
+		bucket: String(meta.bucket ?? ""),
+		key: String(meta.name ?? ""),
+		sizeBytes: meta.size ? Number(meta.size) : void 0,
+		contentType: meta.contentType ? String(meta.contentType) : void 0,
+		etag: meta.etag ? String(meta.etag) : void 0,
+		checksum: meta.md5Hash ? String(meta.md5Hash) : void 0,
+		lastModified: meta.updated ? new Date(String(meta.updated)) : void 0,
+		metadata: meta.metadata
+	};
+}
+
+//#endregion
+export { GoogleCloudStorageProvider };
+//# sourceMappingURL=gcs-storage.js.map

package/dist/impls/gcs-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs-storage.js","names":[],"sources":["../../src/impls/gcs-storage.ts"],"sourcesContent":["import { Storage, type StorageOptions } from '@google-cloud/storage';\n\nimport type {\n  ObjectStorageProvider,\n  PutObjectInput,\n  GetObjectResult,\n  StorageObjectMetadata,\n  ListObjectsQuery,\n  ListObjectsResult,\n  SignedUrlOptions,\n  DeleteObjectInput,\n} from '../storage';\n\nexport interface GoogleCloudStorageProviderOptions {\n  bucket: string;\n  storage?: Storage;\n  clientOptions?: StorageOptions;\n}\n\nexport class GoogleCloudStorageProvider implements ObjectStorageProvider {\n  private readonly storage: Storage;\n  private readonly bucketName: string;\n\n  constructor(options: GoogleCloudStorageProviderOptions) {\n    this.storage =\n      options.storage ?? new Storage(options.clientOptions ?? undefined);\n    this.bucketName = options.bucket;\n  }\n\n  async putObject(input: PutObjectInput): Promise<StorageObjectMetadata> {\n    const bucketName = input.bucket ?? this.bucketName;\n    const bucket = this.storage.bucket(bucketName);\n    const file = bucket.file(input.key);\n    const buffer = toBuffer(input.data);\n    await file.save(buffer, {\n      resumable: false,\n      contentType: input.contentType,\n      metadata: input.metadata,\n    });\n    if (input.makePublic) {\n      await file.makePublic();\n    }\n    const [metadata] = await file.getMetadata();\n    return toMetadata(metadata);\n  }\n\n  async getObject(input: DeleteObjectInput): Promise<GetObjectResult | null> {\n    const bucketName = input.bucket ?? this.bucketName;\n    const bucket = this.storage.bucket(bucketName);\n    const file = bucket.file(input.key);\n    const [exists] = await file.exists();\n    if (!exists) return null;\n    const [contents] = await file.download();\n    const [metadata] = await file.getMetadata();\n    return {\n      ...toMetadata(metadata),\n      data: new Uint8Array(contents),\n    };\n  }\n\n  async deleteObject(input: DeleteObjectInput): Promise<void> {\n    const bucketName = input.bucket ?? this.bucketName;\n    const bucket = this.storage.bucket(bucketName);\n    const file = bucket.file(input.key);\n    await file.delete({ ignoreNotFound: true });\n  }\n\n  async generateSignedUrl(options: SignedUrlOptions): Promise<{\n    url: string;\n    expiresAt: Date;\n  }> {\n    const bucketName = options.bucket ?? this.bucketName;\n    const bucket = this.storage.bucket(bucketName);\n    const file = bucket.file(options.key);\n    const action = options.method === 'PUT' ? 'write' : 'read';\n    const expires = Date.now() + options.expiresInSeconds * 1000;\n    const [url] = await file.getSignedUrl({\n      action,\n      expires,\n      contentType: options.contentType,\n    });\n    return { url, expiresAt: new Date(expires) };\n  }\n\n  async listObjects(query: ListObjectsQuery): Promise<ListObjectsResult> {\n    const bucketName = query.bucket ?? this.bucketName;\n    const bucket = this.storage.bucket(bucketName);\n    const [files, nextQuery, response] = await bucket.getFiles({\n      prefix: query.prefix,\n      maxResults: query.maxResults,\n      pageToken: query.pageToken,\n    });\n    const nextTokenFromQuery =\n      typeof nextQuery === 'object' &&\n      nextQuery !== null &&\n      'pageToken' in nextQuery\n        ? (nextQuery as { pageToken?: string }).pageToken\n        : undefined;\n    const nextTokenFromResponse =\n      response && typeof response === 'object' && 'nextPageToken' in response\n        ? (response as { nextPageToken?: string }).nextPageToken\n        : undefined;\n    return {\n      objects: files.map((file) => toMetadata(file.metadata)),\n      nextPageToken: nextTokenFromQuery ?? nextTokenFromResponse ?? undefined,\n    };\n  }\n}\n\nfunction toBuffer(data: Uint8Array | ArrayBuffer): Buffer {\n  if (data instanceof Uint8Array) {\n    return Buffer.from(data);\n  }\n  return Buffer.from(data);\n}\n\nfunction toMetadata(metadata: unknown): StorageObjectMetadata {\n  const meta = metadata as Record<string, unknown>;\n  return {\n    bucket: String(meta.bucket ?? ''),\n    key: String(meta.name ?? ''),\n    sizeBytes: meta.size ? Number(meta.size) : undefined,\n    contentType: meta.contentType ? String(meta.contentType) : undefined,\n    etag: meta.etag ? String(meta.etag) : undefined,\n    checksum: meta.md5Hash ? String(meta.md5Hash) : undefined,\n    lastModified: meta.updated ? new Date(String(meta.updated)) : undefined,\n    metadata: meta.metadata as Record<string, string> | undefined,\n  };\n}\n"],"mappings":"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"}

package/dist/impls/gmail-inbound.d.ts

@@ -0,0 +1,27 @@
+import { email_d_exports } from "../email.js";
+import { gmail_v1 } from "googleapis";
+
+//#region src/impls/gmail-inbound.d.ts
+interface GmailInboundProviderOptions {
+  auth: gmail_v1.Options['auth'];
+  userId?: string;
+  gmail?: gmail_v1.Gmail;
+  includeSpamTrash?: boolean;
+}
+declare class GmailInboundProvider implements email_d_exports.EmailInboundProvider {
+  private readonly gmail;
+  private readonly userId;
+  private readonly includeSpamTrash;
+  private readonly auth;
+  constructor(options: GmailInboundProviderOptions);
+  listThreads(query?: email_d_exports.EmailThreadListQuery): Promise<email_d_exports.EmailThread[]>;
+  getThread(threadId: string): Promise<email_d_exports.EmailThread | null>;
+  listMessagesSince(query: email_d_exports.EmailMessagesSinceQuery): Promise<{
+    messages: email_d_exports.EmailMessage[];
+    nextPageToken: string | undefined;
+  }>;
+  private transformMessage;
+}
+//#endregion
+export { GmailInboundProvider, GmailInboundProviderOptions };
+//# sourceMappingURL=gmail-inbound.d.ts.map

package/dist/impls/gmail-inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-inbound.d.ts","names":[],"sources":["../../src/impls/gmail-inbound.ts"],"sourcesContent":[],"mappings":";;;;UAUiB,2BAAA;QACT,QAAA,CAAS;EADA,MAAA,CAAA,EAAA,MAAA;EAOJ,KAAA,CAAA,EAJH,QAAA,CAAS,KAIN;EAMU,gBAAA,CAAA,EAAA,OAAA;;AAYoC,cAlB9C,oBAAA,YAAgC,eAAA,CAAA,oBAkBc,CAAA;EAAR,iBAAA,KAAA;EAqBN,iBAAA,MAAA;EAAR,iBAAA,gBAAA;EAsDJ,iBAAA,IAAA;uBAvFV;EAuFiC,WAAA,CAAA,KAAA,CAAA,EA3E5B,eAAA,CAAA,oBA2E4B,CAAA,EA3EL,OA2EK,CA3EG,eAAA,CAAA,WA2EH,EAAA,CAAA;EA7FX,SAAA,CAAA,QAAA,EAAA,MAAA,CAAA,EAuCR,OAvCQ,CAuCA,eAAA,CAAA,WAvCA,GAAA,IAAA,CAAA;EAAoB,iBAAA,CAAA,KAAA,EA6FhC,eAAA,CAAA,uBA7FgC,CAAA,EA6FT,OA7FS,CAAA"}

package/dist/impls/gmail-inbound.js

@@ -0,0 +1,201 @@
+import { google } from "googleapis";
+
+//#region src/impls/gmail-inbound.ts
+var GmailInboundProvider = class {
+	gmail;
+	userId;
+	includeSpamTrash;
+	auth;
+	constructor(options) {
+		this.auth = options.auth;
+		this.gmail = options.gmail ?? google.gmail({
+			version: "v1",
+			auth: options.auth
+		});
+		this.userId = options.userId ?? "me";
+		this.includeSpamTrash = options.includeSpamTrash ?? false;
+	}
+	async listThreads(query) {
+		const response = await this.gmail.users.threads.list({
+			userId: this.userId,
+			maxResults: query?.pageSize,
+			pageToken: query?.pageToken,
+			q: query?.query,
+			labelIds: query?.label ? [query.label] : void 0,
+			includeSpamTrash: this.includeSpamTrash,
+			auth: this.auth
+		});
+		return (await Promise.all((response.data.threads ?? []).map(async (thread) => {
+			if (!thread.id) return null;
+			return this.getThread(thread.id);
+		}))).filter((thread) => thread !== null);
+	}
+	async getThread(threadId) {
+		const thread = (await this.gmail.users.threads.get({
+			id: threadId,
+			userId: this.userId,
+			format: "full",
+			auth: this.auth
+		})).data;
+		if (!thread) return null;
+		const messages = thread.messages?.map((message) => this.transformMessage(message)) ?? [];
+		const participants = dedupeAddresses(messages.flatMap((message) => [
+			message.from,
+			...message.to,
+			...message.cc ?? []
+		]));
+		const firstMessage = messages[0];
+		const lastMessage = messages[messages.length - 1];
+		const updatedAt = lastMessage?.receivedAt ?? lastMessage?.sentAt ?? firstMessage?.receivedAt ?? firstMessage?.sentAt ?? /* @__PURE__ */ new Date();
+		const labels = Array.from(new Set(messages.flatMap((message) => {
+			const labelField = message.metadata?.labelIds;
+			if (!labelField) return [];
+			return labelField.split(",").map((label) => label.trim());
+		}).filter((label) => Boolean(label))));
+		return {
+			id: thread.id ?? threadId,
+			subject: messages[0]?.subject,
+			snippet: thread.snippet ?? "",
+			participants,
+			messages,
+			updatedAt,
+			labels,
+			metadata: thread.historyId ? { historyId: thread.historyId } : void 0
+		};
+	}
+	async listMessagesSince(query) {
+		const after = query.since ? Math.floor(query.since.getTime() / 1e3) : void 0;
+		const q = [];
+		if (after) q.push(`after:${after}`);
+		const response = await this.gmail.users.messages.list({
+			userId: this.userId,
+			maxResults: query.pageSize,
+			pageToken: query.pageToken,
+			labelIds: query.label ? [query.label] : void 0,
+			q: q.join(" "),
+			includeSpamTrash: this.includeSpamTrash,
+			auth: this.auth
+		});
+		return {
+			messages: (await Promise.all((response.data.messages ?? []).map(async (item) => {
+				if (!item.id) return null;
+				const full = await this.gmail.users.messages.get({
+					userId: this.userId,
+					id: item.id,
+					format: "full",
+					auth: this.auth
+				});
+				if (!full.data) return null;
+				return this.transformMessage(full.data);
+			}))).filter((message) => message !== null),
+			nextPageToken: response.data.nextPageToken ?? void 0
+		};
+	}
+	transformMessage(message) {
+		const headers = message.payload?.headers ?? [];
+		const subject = headerValue(headers, "Subject") ?? "";
+		const from = parseAddress(headerValue(headers, "From")) ?? inferFallbackAddress("from", message.id);
+		const to = parseAddressList(headerValue(headers, "To"));
+		const cc = parseAddressList(headerValue(headers, "Cc"));
+		const bcc = parseAddressList(headerValue(headers, "Bcc"));
+		const replyTo = parseAddress(headerValue(headers, "Reply-To"));
+		const { text, html, attachments } = extractContent(message.payload);
+		const timestamp = message.internalDate ? new Date(Number(message.internalDate)) : /* @__PURE__ */ new Date();
+		const metadata = {
+			...message.labelIds?.length ? { labelIds: message.labelIds.join(",") } : {},
+			...message.historyId ? { historyId: message.historyId } : {}
+		};
+		return {
+			id: message.id ?? "",
+			threadId: message.threadId ?? "",
+			subject,
+			from,
+			to,
+			cc,
+			bcc,
+			replyTo: replyTo ?? void 0,
+			sentAt: timestamp,
+			receivedAt: timestamp,
+			textBody: text ?? void 0,
+			htmlBody: html ?? void 0,
+			attachments,
+			headers: Object.fromEntries(headers.map((header) => [header.name ?? "", header.value ?? ""])),
+			metadata: Object.keys(metadata).length > 0 ? metadata : void 0
+		};
+	}
+};
+function headerValue(headers, name) {
+	const value = headers.find((candidate) => candidate.name?.toLowerCase() === name.toLowerCase())?.value;
+	return typeof value === "string" ? value : void 0;
+}
+function parseAddress(header) {
+	const addresses = parseAddressList(header);
+	if (addresses.length === 0) return null;
+	return addresses[0] || null;
+}
+function inferFallbackAddress(field, messageId) {
+	return { email: `${field}-${messageId ? messageId.replace(/[^\w]/g, "").slice(-8) || "unknown" : "unknown"}@mail.local` };
+}
+function parseAddressList(header) {
+	if (!header) return [];
+	return header.split(",").map((part) => part.trim()).filter(Boolean).map((value) => {
+		const match = value.match(/^(?:"?([^"]*)"?\s)?<?([^<>]+)>?$/);
+		if (!match) return { email: value };
+		const name = match[1]?.trim();
+		const email = match[2]?.trim();
+		if (!email) return { email: value };
+		return name ? {
+			email,
+			name
+		} : { email };
+	});
+}
+function dedupeAddresses(addresses) {
+	const map = /* @__PURE__ */ new Map();
+	for (const address of addresses) {
+		if (!address) continue;
+		map.set(address.email.toLowerCase(), address);
+	}
+	return Array.from(map.values());
+}
+function extractContent(payload) {
+	if (!payload) return { attachments: [] };
+	const attachments = [];
+	const visit = (part) => {
+		if (!part) return {};
+		if (part.filename && part.body?.attachmentId) attachments.push({
+			id: part.body.attachmentId,
+			filename: part.filename,
+			contentType: part.mimeType ?? "application/octet-stream",
+			sizeBytes: part.body.size ?? void 0
+		});
+		const mimeType = part.mimeType ?? "";
+		const data = part.body?.data;
+		if (mimeType === "text/plain" && data) return { text: decodeBase64Url(data) };
+		if (mimeType === "text/html" && data) return { html: decodeBase64Url(data) };
+		if (part.parts?.length) return part.parts.reduce((acc, nested) => {
+			const value = visit(nested);
+			return {
+				text: value.text ?? acc.text,
+				html: value.html ?? acc.html
+			};
+		}, {});
+		return {};
+	};
+	const { text, html } = visit(payload);
+	return {
+		text,
+		html,
+		attachments
+	};
+}
+function decodeBase64Url(data) {
+	const normalized = data.replace(/-/g, "+").replace(/_/g, "/");
+	const padding = normalized.length % 4;
+	const padded = padding === 0 ? normalized : normalized + "=".repeat(4 - padding);
+	return Buffer.from(padded, "base64").toString("utf-8");
+}
+
+//#endregion
+export { GmailInboundProvider };
+//# sourceMappingURL=gmail-inbound.js.map