@lssm/lib.contracts 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/integrations/openbanking/models.js

@@ -1 +1,242 @@
-import{l as e}from"../../schema/dist/ScalarTypeEnum.js";import{t}from"../../schema/dist/SchemaModel.js";import"../../schema/dist/index.js";const n=new t({name:`BankAccountRecord`,description:`Canonical representation of a bank account synced from an open banking provider.`,fields:{id:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},userId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!1},externalId:{type:e.NonEmptyString(),isOptional:!1},institutionId:{type:e.NonEmptyString(),isOptional:!1},institutionName:{type:e.NonEmptyString(),isOptional:!1},institutionLogoUrl:{type:e.URL(),isOptional:!0},iban:{type:e.String_unsecure(),isOptional:!0},bic:{type:e.String_unsecure(),isOptional:!0},accountType:{type:e.NonEmptyString(),isOptional:!1},currency:{type:e.Currency(),isOptional:!1},displayName:{type:e.NonEmptyString(),isOptional:!1},accountNumberMasked:{type:e.String_unsecure(),isOptional:!0},productCode:{type:e.String_unsecure(),isOptional:!0},balance:{type:e.Float_unsecure(),isOptional:!0},availableBalance:{type:e.Float_unsecure(),isOptional:!0},lastSyncedAt:{type:e.DateTime(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1},metadata:{type:e.JSONObject(),isOptional:!0}}}),r=new t({name:`BankTransactionRecord`,description:`Canonical transaction entry mapped from Powens into the open banking ledger.`,fields:{id:{type:e.ID(),isOptional:!1},accountId:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!1},externalId:{type:e.NonEmptyString(),isOptional:!1},amount:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.Currency(),isOptional:!1},date:{type:e.DateTime(),isOptional:!1},bookingDate:{type:e.DateTime(),isOptional:!0},valueDate:{type:e.DateTime(),isOptional:!0},description:{type:e.String_unsecure(),isOptional:!0},counterpartyName:{type:e.String_unsecure(),isOptional:!0},counterpartyAccount:{type:e.String_unsecure(),isOptional:!0},merchantCategoryCode:{type:e.String_unsecure(),isOptional:!0},rawCategory:{type:e.String_unsecure(),isOptional:!0},standardizedCategory:{type:e.String_unsecure(),isOptional:!0},transactionType:{type:e.NonEmptyString(),isOptional:!1},status:{type:e.NonEmptyString(),isOptional:!1},runningBalance:{type:e.Float_unsecure(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),i=new t({name:`AccountBalanceRecord`,description:`Canonical balance snapshot computed from Powens balance payloads.`,fields:{id:{type:e.ID(),isOptional:!1},accountId:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!1},balanceType:{type:e.NonEmptyString(),isOptional:!1},currentBalance:{type:e.Float_unsecure(),isOptional:!1},availableBalance:{type:e.Float_unsecure(),isOptional:!0},currency:{type:e.Currency(),isOptional:!1},lastUpdatedAt:{type:e.DateTime(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},metadata:{type:e.JSONObject(),isOptional:!0}}});export{i as AccountBalanceRecord,n as BankAccountRecord,r as BankTransactionRecord};
+import { ScalarTypeEnum } from "../../schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "../../schema/dist/SchemaModel.js";
+import "../../schema/dist/index.js";
+
+//#region src/integrations/openbanking/models.ts
+const BankAccountRecord = new SchemaModel({
+	name: "BankAccountRecord",
+	description: "Canonical representation of a bank account synced from an open banking provider.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		externalId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		institutionId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		institutionName: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		institutionLogoUrl: {
+			type: ScalarTypeEnum.URL(),
+			isOptional: true
+		},
+		iban: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		bic: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		accountType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.Currency(),
+			isOptional: false
+		},
+		displayName: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		accountNumberMasked: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		productCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		balance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		availableBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		lastSyncedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+const BankTransactionRecord = new SchemaModel({
+	name: "BankTransactionRecord",
+	description: "Canonical transaction entry mapped from Powens into the open banking ledger.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		externalId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		amount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.Currency(),
+			isOptional: false
+		},
+		date: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		bookingDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		valueDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		counterpartyName: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		counterpartyAccount: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		merchantCategoryCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		rawCategory: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		standardizedCategory: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		transactionType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		runningBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const AccountBalanceRecord = new SchemaModel({
+	name: "AccountBalanceRecord",
+	description: "Canonical balance snapshot computed from Powens balance payloads.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		balanceType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		currentBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		availableBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		currency: {
+			type: ScalarTypeEnum.Currency(),
+			isOptional: false
+		},
+		lastUpdatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord };

package/dist/integrations/openbanking/openbanking.feature.js

@@ -1 +1,68 @@
-const e={meta:{key:`openbanking`,title:`Open Banking Integration`,description:`Open banking account sync, balance refresh, and transaction synchronization`,domain:`integrations`,owners:[`@platform.finance`],tags:[`open-banking`,`powens`,`finance`,`banking`],stability:`experimental`},operations:[{name:`openbanking.accounts.sync`,version:1},{name:`openbanking.accounts.list`,version:1},{name:`openbanking.accounts.get`,version:1},{name:`openbanking.balances.refresh`,version:1},{name:`openbanking.balances.get`,version:1},{name:`openbanking.transactions.sync`,version:1},{name:`openbanking.transactions.list`,version:1}],events:[],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:`openbanking`,version:1}],requires:[{key:`identity`,version:1}]}};export{e as OpenBankingFeature};
+//#region src/integrations/openbanking/openbanking.feature.ts
+/**
+* OpenBanking feature module that bundles account, balance,
+* and transaction synchronization capabilities.
+*/
+const OpenBankingFeature = {
+	meta: {
+		key: "openbanking",
+		title: "Open Banking Integration",
+		description: "Open banking account sync, balance refresh, and transaction synchronization",
+		domain: "integrations",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"finance",
+			"banking"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			name: "openbanking.accounts.sync",
+			version: 1
+		},
+		{
+			name: "openbanking.accounts.list",
+			version: 1
+		},
+		{
+			name: "openbanking.accounts.get",
+			version: 1
+		},
+		{
+			name: "openbanking.balances.refresh",
+			version: 1
+		},
+		{
+			name: "openbanking.balances.get",
+			version: 1
+		},
+		{
+			name: "openbanking.transactions.sync",
+			version: 1
+		},
+		{
+			name: "openbanking.transactions.list",
+			version: 1
+		}
+	],
+	events: [],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: {
+		provides: [{
+			key: "openbanking",
+			version: 1
+		}],
+		requires: [{
+			key: "identity",
+			version: 1
+		}]
+	}
+};
+
+//#endregion
+export { OpenBankingFeature };

package/dist/integrations/openbanking/telemetry.js

@@ -1 +1,39 @@
-const e=[`iban`,`bic`,`accountNumberMasked`,`accountNumber`,`counterpartyName`,`counterpartyAccount`,`description`,`merchantName`,`merchantCategoryCode`,`reference`],t={accountsSynced:`openbanking.accounts.synced`,accountsSyncFailed:`openbanking.accounts.sync_failed`,transactionsSynced:`openbanking.transactions.synced`,transactionsSyncFailed:`openbanking.transactions.sync_failed`,balancesRefreshed:`openbanking.balances.refreshed`,balancesRefreshFailed:`openbanking.balances.refresh_failed`,overviewGenerated:`openbanking.overview.generated`};function n(t){let i={};for(let[a,o]of Object.entries(t))e.includes(a)?i[a]=r(o):Array.isArray(o)?i[a]=o.map(e=>typeof e==`object`&&e?n(e):e):typeof o==`object`&&o?i[a]=n(o):i[a]=o;return i}function r(e){if(e==null)return``;let t=String(e);return t.length<=4?`*`.repeat(t.length):`${`*`.repeat(Math.max(t.length-4,0))}${t.slice(-4)}`}export{e as OPENBANKING_PII_FIELDS,t as OPENBANKING_TELEMETRY_EVENTS,n as redactOpenBankingTelemetryPayload};
+//#region src/integrations/openbanking/telemetry.ts
+const OPENBANKING_PII_FIELDS = [
+	"iban",
+	"bic",
+	"accountNumberMasked",
+	"accountNumber",
+	"counterpartyName",
+	"counterpartyAccount",
+	"description",
+	"merchantName",
+	"merchantCategoryCode",
+	"reference"
+];
+const OPENBANKING_TELEMETRY_EVENTS = {
+	accountsSynced: "openbanking.accounts.synced",
+	accountsSyncFailed: "openbanking.accounts.sync_failed",
+	transactionsSynced: "openbanking.transactions.synced",
+	transactionsSyncFailed: "openbanking.transactions.sync_failed",
+	balancesRefreshed: "openbanking.balances.refreshed",
+	balancesRefreshFailed: "openbanking.balances.refresh_failed",
+	overviewGenerated: "openbanking.overview.generated"
+};
+function redactOpenBankingTelemetryPayload(payload) {
+	const redacted = {};
+	for (const [key, value] of Object.entries(payload)) if (OPENBANKING_PII_FIELDS.includes(key)) redacted[key] = maskValue(value);
+	else if (Array.isArray(value)) redacted[key] = value.map((item) => typeof item === "object" && item !== null ? redactOpenBankingTelemetryPayload(item) : item);
+	else if (typeof value === "object" && value !== null) redacted[key] = redactOpenBankingTelemetryPayload(value);
+	else redacted[key] = value;
+	return redacted;
+}
+function maskValue(value) {
+	if (value == null) return "";
+	const str = String(value);
+	if (str.length <= 4) return "*".repeat(str.length);
+	return `${"*".repeat(Math.max(str.length - 4, 0))}${str.slice(-4)}`;
+}
+
+//#endregion
+export { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, redactOpenBankingTelemetryPayload };

package/dist/integrations/providers/elevenlabs.js

@@ -1 +1,56 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`ai-voice.elevenlabs`,version:1,category:`ai-voice`,displayName:`ElevenLabs Voice`,title:`ElevenLabs Text-to-Speech`,description:`ElevenLabs integration for neural voice synthesis and voice catalog access.`,domain:`ai`,owners:[`platform.ai`],tags:[`voice`,`tts`],stability:e.Beta},supportedModes:[`managed`,`byok`],capabilities:{provides:[{key:`ai.voice.synthesis`,version:1}]},configSchema:{schema:{type:`object`,properties:{defaultVoiceId:{type:`string`,description:`Optional default voice identifier for synthesis requests.`}}},example:{defaultVoiceId:`pNInz6obpgDQGcFmaJgB`}},secretSchema:{schema:{type:`object`,required:[`apiKey`],properties:{apiKey:{type:`string`,description:`ElevenLabs API key with text-to-speech permissions.`}}},example:{apiKey:`eleven-***`}},healthCheck:{method:`custom`,timeoutMs:4e3},docsUrl:`https://elevenlabs.io/docs/api-reference/text-to-speech`,constraints:{rateLimit:{rpm:120}},byokSetup:{setupInstructions:`Create an ElevenLabs API key and ensure the desired voices are accessible to the key scope.`}};function n(e){return e.register(t)}export{t as elevenLabsIntegrationSpec,n as registerElevenLabsIntegration};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/integrations/providers/elevenlabs.ts
+const elevenLabsIntegrationSpec = {
+	meta: {
+		key: "ai-voice.elevenlabs",
+		version: 1,
+		category: "ai-voice",
+		displayName: "ElevenLabs Voice",
+		title: "ElevenLabs Text-to-Speech",
+		description: "ElevenLabs integration for neural voice synthesis and voice catalog access.",
+		domain: "ai",
+		owners: ["platform.ai"],
+		tags: ["voice", "tts"],
+		stability: StabilityEnum.Beta
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "ai.voice.synthesis",
+		version: 1
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: { defaultVoiceId: {
+				type: "string",
+				description: "Optional default voice identifier for synthesis requests."
+			} }
+		},
+		example: { defaultVoiceId: "pNInz6obpgDQGcFmaJgB" }
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["apiKey"],
+			properties: { apiKey: {
+				type: "string",
+				description: "ElevenLabs API key with text-to-speech permissions."
+			} }
+		},
+		example: { apiKey: "eleven-***" }
+	},
+	healthCheck: {
+		method: "custom",
+		timeoutMs: 4e3
+	},
+	docsUrl: "https://elevenlabs.io/docs/api-reference/text-to-speech",
+	constraints: { rateLimit: { rpm: 120 } },
+	byokSetup: { setupInstructions: "Create an ElevenLabs API key and ensure the desired voices are accessible to the key scope." }
+};
+function registerElevenLabsIntegration(registry) {
+	return registry.register(elevenLabsIntegrationSpec);
+}
+
+//#endregion
+export { elevenLabsIntegrationSpec, registerElevenLabsIntegration };

package/dist/integrations/providers/gcs-storage.js

@@ -1 +1,79 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`storage.gcs`,version:1,category:`storage`,displayName:`Google Cloud Storage`,title:`Google Cloud Storage Buckets`,description:`Google Cloud Storage integration for object storage and retrieval.`,domain:`infrastructure`,owners:[`platform.infrastructure`],tags:[`storage`,`gcs`,`google-cloud`],stability:e.Beta},supportedModes:[`managed`,`byok`],capabilities:{provides:[{key:`storage.objects`,version:1}]},configSchema:{schema:{type:`object`,required:[`bucket`],properties:{bucket:{type:`string`,description:`Primary bucket name used for storing objects.`},prefix:{type:`string`,description:`Optional prefix applied to object keys.`}}},example:{bucket:`pfo-tenant-assets`,prefix:`documents/`}},secretSchema:{schema:{type:`object`,properties:{type:{type:`string`,description:`Service account type field from Google credentials JSON (if provided).`},client_email:{type:`string`},private_key:{type:`string`},project_id:{type:`string`}}},example:{type:`service_account`,client_email:`svc-account@example.iam.gserviceaccount.com`,private_key:`-----BEGIN PRIVATE KEY-----...`,project_id:`example-project`}},healthCheck:{method:`ping`,timeoutMs:4e3},docsUrl:`https://cloud.google.com/storage/docs/apis`,constraints:{quotas:{storageGb:5120}},byokSetup:{setupInstructions:`Create a Google Cloud service account with Storage Object Admin role and upload the JSON credentials to the secret store.`}};function n(e){return e.register(t)}export{t as gcsStorageIntegrationSpec,n as registerGcsStorageIntegration};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/integrations/providers/gcs-storage.ts
+const gcsStorageIntegrationSpec = {
+	meta: {
+		key: "storage.gcs",
+		version: 1,
+		category: "storage",
+		displayName: "Google Cloud Storage",
+		title: "Google Cloud Storage Buckets",
+		description: "Google Cloud Storage integration for object storage and retrieval.",
+		domain: "infrastructure",
+		owners: ["platform.infrastructure"],
+		tags: [
+			"storage",
+			"gcs",
+			"google-cloud"
+		],
+		stability: StabilityEnum.Beta
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "storage.objects",
+		version: 1
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			required: ["bucket"],
+			properties: {
+				bucket: {
+					type: "string",
+					description: "Primary bucket name used for storing objects."
+				},
+				prefix: {
+					type: "string",
+					description: "Optional prefix applied to object keys."
+				}
+			}
+		},
+		example: {
+			bucket: "pfo-tenant-assets",
+			prefix: "documents/"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				type: {
+					type: "string",
+					description: "Service account type field from Google credentials JSON (if provided)."
+				},
+				client_email: { type: "string" },
+				private_key: { type: "string" },
+				project_id: { type: "string" }
+			}
+		},
+		example: {
+			type: "service_account",
+			client_email: "svc-account@example.iam.gserviceaccount.com",
+			private_key: "-----BEGIN PRIVATE KEY-----...",
+			project_id: "example-project"
+		}
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 4e3
+	},
+	docsUrl: "https://cloud.google.com/storage/docs/apis",
+	constraints: { quotas: { storageGb: 5120 } },
+	byokSetup: { setupInstructions: "Create a Google Cloud service account with Storage Object Admin role and upload the JSON credentials to the secret store." }
+};
+function registerGcsStorageIntegration(registry) {
+	return registry.register(gcsStorageIntegrationSpec);
+}
+
+//#endregion
+export { gcsStorageIntegrationSpec, registerGcsStorageIntegration };

package/dist/integrations/providers/gmail.js

@@ -1 +1,91 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`email.gmail`,version:1,category:`email`,displayName:`Gmail API`,title:`Google Gmail API`,description:`Gmail integration supporting inbound thread ingestion and outbound transactional email.`,domain:`communications`,owners:[`platform.messaging`],tags:[`email`,`gmail`],stability:e.Beta},supportedModes:[`managed`,`byok`],capabilities:{provides:[{key:`email.inbound`,version:1},{key:`email.outbound`,version:1}]},configSchema:{schema:{type:`object`,properties:{labelIds:{type:`array`,items:{type:`string`},description:`Optional list of label IDs to scope inbound sync.`},includeSpamTrash:{type:`boolean`,description:`Whether to include spam or trash messages during sync.`}}},example:{labelIds:[`INBOX`],includeSpamTrash:!1}},secretSchema:{schema:{type:`object`,required:[`clientId`,`clientSecret`,`refreshToken`],properties:{clientId:{type:`string`,description:`OAuth client ID for the Google Cloud project.`},clientSecret:{type:`string`,description:`OAuth client secret for the Google Cloud project.`},refreshToken:{type:`string`,description:`OAuth refresh token for delegated Gmail access.`},redirectUri:{type:`string`,description:`Optional redirect URI used when issuing the refresh token.`}}},example:{clientId:`xxx.apps.googleusercontent.com`,clientSecret:`secret`,refreshToken:`refresh-token`}},healthCheck:{method:`custom`,timeoutMs:4e3},docsUrl:`https://developers.google.com/gmail/api`,constraints:{rateLimit:{rpm:600}},byokSetup:{setupInstructions:`Create an OAuth consent screen and credentials within Google Cloud Console, then authorize the Gmail scopes and store the resulting refresh token.`}};function n(e){return e.register(t)}export{t as gmailIntegrationSpec,n as registerGmailIntegration};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/integrations/providers/gmail.ts
+const gmailIntegrationSpec = {
+	meta: {
+		key: "email.gmail",
+		version: 1,
+		category: "email",
+		displayName: "Gmail API",
+		title: "Google Gmail API",
+		description: "Gmail integration supporting inbound thread ingestion and outbound transactional email.",
+		domain: "communications",
+		owners: ["platform.messaging"],
+		tags: ["email", "gmail"],
+		stability: StabilityEnum.Beta
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "email.inbound",
+		version: 1
+	}, {
+		key: "email.outbound",
+		version: 1
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				labelIds: {
+					type: "array",
+					items: { type: "string" },
+					description: "Optional list of label IDs to scope inbound sync."
+				},
+				includeSpamTrash: {
+					type: "boolean",
+					description: "Whether to include spam or trash messages during sync."
+				}
+			}
+		},
+		example: {
+			labelIds: ["INBOX"],
+			includeSpamTrash: false
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: [
+				"clientId",
+				"clientSecret",
+				"refreshToken"
+			],
+			properties: {
+				clientId: {
+					type: "string",
+					description: "OAuth client ID for the Google Cloud project."
+				},
+				clientSecret: {
+					type: "string",
+					description: "OAuth client secret for the Google Cloud project."
+				},
+				refreshToken: {
+					type: "string",
+					description: "OAuth refresh token for delegated Gmail access."
+				},
+				redirectUri: {
+					type: "string",
+					description: "Optional redirect URI used when issuing the refresh token."
+				}
+			}
+		},
+		example: {
+			clientId: "xxx.apps.googleusercontent.com",
+			clientSecret: "secret",
+			refreshToken: "refresh-token"
+		}
+	},
+	healthCheck: {
+		method: "custom",
+		timeoutMs: 4e3
+	},
+	docsUrl: "https://developers.google.com/gmail/api",
+	constraints: { rateLimit: { rpm: 600 } },
+	byokSetup: { setupInstructions: "Create an OAuth consent screen and credentials within Google Cloud Console, then authorize the Gmail scopes and store the resulting refresh token." }
+};
+function registerGmailIntegration(registry) {
+	return registry.register(gmailIntegrationSpec);
+}
+
+//#endregion
+export { gmailIntegrationSpec, registerGmailIntegration };

package/dist/integrations/providers/google-calendar.js

@@ -1 +1,70 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`calendar.google`,version:1,category:`calendar`,displayName:`Google Calendar`,title:`Google Calendar API`,description:`Google Calendar integration for event creation, updates, and scheduling automations.`,domain:`productivity`,owners:[`platform.messaging`],tags:[`calendar`,`google`],stability:e.Beta},supportedModes:[`managed`,`byok`],capabilities:{provides:[{key:`calendar.events`,version:1}]},configSchema:{schema:{type:`object`,properties:{calendarId:{type:`string`,description:`Default calendar identifier (defaults to primary).`}}},example:{calendarId:`primary`}},secretSchema:{schema:{type:`object`,required:[`clientEmail`,`privateKey`],properties:{clientEmail:{type:`string`,description:`Service account client email.`},privateKey:{type:`string`,description:`Service account private key.`},projectId:{type:`string`,description:`Google Cloud project ID.`}}},example:{clientEmail:`svc-calendar@example.iam.gserviceaccount.com`,privateKey:`-----BEGIN PRIVATE KEY-----...`,projectId:`calendar-project`}},healthCheck:{method:`custom`,timeoutMs:4e3},docsUrl:`https://developers.google.com/calendar/api`,constraints:{},byokSetup:{setupInstructions:`Create a Google service account with Calendar access and share the target calendars with the service account email.`}};function n(e){return e.register(t)}export{t as googleCalendarIntegrationSpec,n as registerGoogleCalendarIntegration};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/integrations/providers/google-calendar.ts
+const googleCalendarIntegrationSpec = {
+	meta: {
+		key: "calendar.google",
+		version: 1,
+		category: "calendar",
+		displayName: "Google Calendar",
+		title: "Google Calendar API",
+		description: "Google Calendar integration for event creation, updates, and scheduling automations.",
+		domain: "productivity",
+		owners: ["platform.messaging"],
+		tags: ["calendar", "google"],
+		stability: StabilityEnum.Beta
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "calendar.events",
+		version: 1
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: { calendarId: {
+				type: "string",
+				description: "Default calendar identifier (defaults to primary)."
+			} }
+		},
+		example: { calendarId: "primary" }
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["clientEmail", "privateKey"],
+			properties: {
+				clientEmail: {
+					type: "string",
+					description: "Service account client email."
+				},
+				privateKey: {
+					type: "string",
+					description: "Service account private key."
+				},
+				projectId: {
+					type: "string",
+					description: "Google Cloud project ID."
+				}
+			}
+		},
+		example: {
+			clientEmail: "svc-calendar@example.iam.gserviceaccount.com",
+			privateKey: "-----BEGIN PRIVATE KEY-----...",
+			projectId: "calendar-project"
+		}
+	},
+	healthCheck: {
+		method: "custom",
+		timeoutMs: 4e3
+	},
+	docsUrl: "https://developers.google.com/calendar/api",
+	constraints: {},
+	byokSetup: { setupInstructions: "Create a Google service account with Calendar access and share the target calendars with the service account email." }
+};
+function registerGoogleCalendarIntegration(registry) {
+	return registry.register(googleCalendarIntegrationSpec);
+}
+
+//#endregion
+export { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration };