@lssm/example.saas-boilerplate 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217073102

package/dist/modules/notifications/dist/libs/contracts/dist/index.js

@@ -0,0 +1,67 @@
+import "./schema/dist/SchemaModel.js";
+import "./schema/dist/index.js";
+import "./events.js";
+import "./presentations.v2.js";
+import "./client/react/feature-render.js";
+import "./client/react/form-render.js";
+import "./client/index.js";
+import "./jsonschema.js";
+import "./server/graphql-pothos.js";
+import "./presentations.js";
+import "./server/mcp/createMcpServer.js";
+import "./server/rest-generic.js";
+import "./server/rest-elysia.js";
+import "./server/rest-express.js";
+import "./server/rest-next-app.js";
+import "./server/rest-next-pages.js";
+import "./server/index.js";
+import "./docs/registry.js";
+import "./registry.js";
+import "./contract-registry/schemas.js";
+import "./contract-registry/index.js";
+import "./install.js";
+import "./openapi.js";
+import "./prompt.js";
+import "./promptRegistry.js";
+import "./resources.js";
+import "./onboarding-base.js";
+import "./capabilities/openbanking.js";
+import "./telemetry/tracker.js";
+import "./telemetry/index.js";
+import "./tests/runner.js";
+import "./tests/index.js";
+import "./experiments/evaluator.js";
+import "./integrations/providers/stripe.js";
+import "./integrations/providers/postmark.js";
+import "./integrations/providers/qdrant.js";
+import "./integrations/providers/mistral.js";
+import "./integrations/providers/elevenlabs.js";
+import "./integrations/providers/gmail.js";
+import "./integrations/providers/google-calendar.js";
+import "./integrations/providers/twilio-sms.js";
+import "./integrations/providers/gcs-storage.js";
+import "./integrations/providers/powens.js";
+import "./integrations/providers/registry.js";
+import "./integrations/openbanking/models.js";
+import "./integrations/openbanking/contracts/accounts.js";
+import "./integrations/openbanking/contracts/transactions.js";
+import "./integrations/openbanking/contracts/balances.js";
+import "./integrations/openbanking/contracts/index.js";
+import "./integrations/index.js";
+import "./knowledge/spaces/product-canon.js";
+import "./knowledge/spaces/support-faq.js";
+import "./knowledge/spaces/email-threads.js";
+import "./knowledge/spaces/uploaded-docs.js";
+import "./knowledge/spaces/financial-docs.js";
+import "./knowledge/spaces/financial-overview.js";
+import "./knowledge/index.js";
+import "./integrations/contracts.js";
+import "./knowledge/contracts.js";
+import "./regenerator/service.js";
+import "./regenerator/index.js";
+import "./workflow/runner.js";
+import "./workflow/index.js";
+import "./docs/index.js";
+import "./llm/exporters.js";
+import "./llm/prompts.js";
+import "./llm/index.js";

package/dist/modules/notifications/dist/libs/contracts/dist/install.js

@@ -0,0 +1,2 @@
+import "./registry.js";
+import "zod";

package/dist/modules/notifications/dist/libs/contracts/dist/integrations/contracts.js

@@ -0,0 +1,377 @@
+import { SchemaModel } from "../schema/dist/SchemaModel.js";
+import { defineCommand, defineQuery } from "../spec.js";
+import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
+import "../schema/dist/index.js";
+
+//#region ../../modules/notifications/dist/libs/contracts/dist/integrations/contracts.js
+const IntegrationConnectionRecord = new SchemaModel({
+	name: "IntegrationConnectionRecord",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		integrationKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		integrationVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		ownershipMode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		externalAccountId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		secretProvider: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		secretRef: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		environment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		healthStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		healthCheckedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		healthLatencyMs: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		healthErrorCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		healthErrorMessage: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		usageRequestCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		usageSuccessCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		usageErrorCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		usageLastUsedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		usageLastErrorAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		usageLastErrorCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const CreateIntegrationConnectionInput = new SchemaModel({
+	name: "CreateIntegrationConnectionInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		integrationKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		integrationVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		ownershipMode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		externalAccountId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		secretProvider: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		secretRef: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		environment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: false
+		}
+	}
+});
+const UpdateIntegrationConnectionInput = new SchemaModel({
+	name: "UpdateIntegrationConnectionInput",
+	fields: {
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		ownershipMode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		externalAccountId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		secretProvider: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		secretRef: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+const DeleteIntegrationConnectionInput = new SchemaModel({
+	name: "DeleteIntegrationConnectionInput",
+	fields: { connectionId: {
+		type: ScalarTypeEnum.ID(),
+		isOptional: false
+	} }
+});
+const ListIntegrationConnectionsInput = new SchemaModel({
+	name: "ListIntegrationConnectionsInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const ListIntegrationConnectionsOutput = new SchemaModel({
+	name: "ListIntegrationConnectionsOutput",
+	fields: { connections: {
+		type: IntegrationConnectionRecord,
+		isOptional: false,
+		isArray: true
+	} }
+});
+const TestIntegrationConnectionInput = new SchemaModel({
+	name: "TestIntegrationConnectionInput",
+	fields: { connectionId: {
+		type: ScalarTypeEnum.ID(),
+		isOptional: false
+	} }
+});
+const TestIntegrationConnectionOutput = new SchemaModel({
+	name: "TestIntegrationConnectionOutput",
+	fields: {
+		success: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		latencyMs: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		error: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		errorCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const DeleteIntegrationConnectionOutput = new SchemaModel({
+	name: "DeleteIntegrationConnectionOutput",
+	fields: { success: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+defineCommand({
+	meta: {
+		name: "integrations.connection.create",
+		version: 1,
+		description: "Create a new integration connection for a tenant.",
+		goal: "Provision a tenant-scoped connection to an external provider.",
+		context: "Used by Ops or the App Studio to configure external integrations such as Stripe or Qdrant.",
+		owners: ["platform.integrations"],
+		tags: ["integration", "connections"],
+		stability: "experimental"
+	},
+	io: {
+		input: CreateIntegrationConnectionInput,
+		output: IntegrationConnectionRecord
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.integration.manage",
+			version: 1
+		}]
+	}
+});
+defineCommand({
+	meta: {
+		name: "integrations.connection.update",
+		version: 1,
+		description: "Update metadata or credentials for an integration connection.",
+		goal: "Allow secure rotation of credentials and metadata adjustments.",
+		context: "Supports rotating API keys, toggling status, or updating labels for tenant integrations.",
+		owners: ["platform.integrations"],
+		tags: ["integration", "connections"],
+		stability: "experimental"
+	},
+	io: {
+		input: UpdateIntegrationConnectionInput,
+		output: IntegrationConnectionRecord
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.integration.manage",
+			version: 1
+		}]
+	}
+});
+defineCommand({
+	meta: {
+		name: "integrations.connection.delete",
+		version: 1,
+		description: "Delete an integration connection for a tenant.",
+		goal: "Safely remove credentials and disable connector usage.",
+		context: "Ensures connections are de-provisioned when no longer needed or breached.",
+		owners: ["platform.integrations"],
+		tags: ["integration", "connections"],
+		stability: "experimental"
+	},
+	io: {
+		input: DeleteIntegrationConnectionInput,
+		output: DeleteIntegrationConnectionOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.integration.manage",
+			version: 1
+		}]
+	}
+});
+defineQuery({
+	meta: {
+		name: "integrations.connection.list",
+		version: 1,
+		description: "List integration connections for a tenant.",
+		goal: "Provide visibility into configured integrations and their status.",
+		context: "Used by the App Studio and Ops flows to show bindings and health.",
+		owners: ["platform.integrations"],
+		tags: ["integration", "connections"],
+		stability: "experimental"
+	},
+	io: {
+		input: ListIntegrationConnectionsInput,
+		output: ListIntegrationConnectionsOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.integration.read",
+			version: 1
+		}]
+	}
+});
+defineCommand({
+	meta: {
+		name: "integrations.connection.test",
+		version: 1,
+		description: "Run a health check against a configured integration connection.",
+		goal: "Validate credentials and connectivity for external providers.",
+		context: "Triggered manually or by background monitors to confirm provider availability.",
+		owners: ["platform.integrations"],
+		tags: ["integration", "connections"],
+		stability: "experimental"
+	},
+	io: {
+		input: TestIntegrationConnectionInput,
+		output: TestIntegrationConnectionOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.integration.manage",
+			version: 1
+		}]
+	}
+});
+
+//#endregion

package/dist/modules/notifications/dist/libs/contracts/dist/integrations/index.js

@@ -0,0 +1,17 @@
+import "./providers/stripe.js";
+import "./providers/postmark.js";
+import "./providers/qdrant.js";
+import "./providers/mistral.js";
+import "./providers/elevenlabs.js";
+import "./providers/gmail.js";
+import "./providers/google-calendar.js";
+import "./providers/twilio-sms.js";
+import "./providers/gcs-storage.js";
+import "./providers/powens.js";
+import "./providers/registry.js";
+import "./openbanking/models.js";
+import "./openbanking/contracts/accounts.js";
+import "./openbanking/contracts/transactions.js";
+import "./openbanking/contracts/balances.js";
+import "./openbanking/contracts/index.js";
+import "./providers/index.js";

package/dist/modules/notifications/dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js

@@ -0,0 +1,228 @@
+import { SchemaModel } from "../../../schema/dist/SchemaModel.js";
+import { defineCommand, defineQuery } from "../../../spec.js";
+import { ScalarTypeEnum } from "../../../schema/dist/ScalarTypeEnum.js";
+import "../../../schema/dist/index.js";
+import { BankAccountRecord } from "../models.js";
+import { OPENBANKING_TELEMETRY_EVENTS } from "../telemetry.js";
+
+//#region ../../modules/notifications/dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js
+const OpenBankingListAccountsInput = new SchemaModel({
+	name: "OpenBankingListAccountsInput",
+	description: "Parameters for listing bank accounts through the open banking provider.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		includeBalances: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		institutionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		cursor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		pageSize: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingListAccountsOutput = new SchemaModel({
+	name: "OpenBankingListAccountsOutput",
+	description: "Paginated list of bank accounts available to the tenant and user.",
+	fields: {
+		accounts: {
+			type: BankAccountRecord,
+			isOptional: false,
+			isArray: true
+		},
+		nextCursor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		hasMore: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingGetAccountInput = new SchemaModel({
+	name: "OpenBankingGetAccountInput",
+	description: "Parameters for retrieving a specific bank account.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		includeBalances: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		includeLatestTransactions: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingSyncAccountsInput = new SchemaModel({
+	name: "OpenBankingSyncAccountsInput",
+	description: "Command payload to trigger an account synchronisation against the open banking provider.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountIds: {
+			type: ScalarTypeEnum.ID(),
+			isArray: true,
+			isOptional: true
+		},
+		forceFullRefresh: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		triggerWorkflows: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingSyncAccountsOutput = new SchemaModel({
+	name: "OpenBankingSyncAccountsOutput",
+	description: "Result of a bank account synchronisation run.",
+	fields: {
+		synced: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		failed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		errors: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		},
+		nextSyncSuggestedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+defineQuery({
+	meta: {
+		name: "openbanking.accounts.list",
+		version: 1,
+		description: "List bank accounts available to a tenant/user via Powens Open Banking.",
+		goal: "Provide downstream workflows with the set of accounts accessible via the configured open banking connection.",
+		context: "Used by Pocket Family Office dashboards and sync workflows to enumerate bank accounts prior to syncing balances or transactions.",
+		owners: ["platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"accounts"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingListAccountsInput,
+		output: OpenBankingListAccountsOutput
+	},
+	policy: { auth: "user" }
+});
+defineQuery({
+	meta: {
+		name: "openbanking.accounts.get",
+		version: 1,
+		description: "Retrieve the canonical bank account record for the given account identifier.",
+		goal: "Allow user-facing experiences and automations to display up-to-date account metadata.",
+		context: "Invoked by UI surfaces and workflow automation steps that require detailed metadata for a specific bank account.",
+		owners: ["platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"accounts"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingGetAccountInput,
+		output: BankAccountRecord
+	},
+	policy: { auth: "user" }
+});
+defineCommand({
+	meta: {
+		name: "openbanking.accounts.sync",
+		version: 1,
+		description: "Initiate a synchronisation run to refresh bank account metadata from Powens.",
+		goal: "Keep canonical bank account records aligned with the external open banking provider.",
+		context: "Triggered by scheduled workflows or manual operator actions to reconcile account metadata prior to transaction/balance syncs.",
+		owners: ["platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"accounts"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingSyncAccountsInput,
+		output: OpenBankingSyncAccountsOutput
+	},
+	policy: { auth: "admin" },
+	telemetry: {
+		success: {
+			event: { name: OPENBANKING_TELEMETRY_EVENTS.accountsSynced },
+			properties: ({ input, output }) => {
+				const payload = input;
+				const result = output;
+				return {
+					tenantId: payload?.tenantId,
+					connectionId: payload?.connectionId,
+					synced: result?.synced,
+					failed: result?.failed
+				};
+			}
+		},
+		failure: {
+			event: { name: OPENBANKING_TELEMETRY_EVENTS.accountsSyncFailed },
+			properties: ({ input, error }) => {
+				const payload = input;
+				return {
+					tenantId: payload?.tenantId,
+					connectionId: payload?.connectionId,
+					error: error instanceof Error ? error.message : String(error ?? "unknown")
+				};
+			}
+		}
+	}
+});
+
+//#endregion