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

package/dist/onboarding-base.d.ts

@@ -1,135 +1,135 @@
 import { ContractSpec } from "./spec.js";
-import * as _lssm_lib_schema302 from "@lssm/lib.schema";
+import * as _lssm_lib_schema108 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/onboarding-base.d.ts
 /** Save/update onboarding draft (auto-save during flow) */
 declare const SaveOnboardingDraftInput: SchemaModel<{
   data: {
-    type: _lssm_lib_schema302.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema108.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>;
 declare const SaveOnboardingDraftOutput: SchemaModel<{
   id: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: false;
   };
 }>;
 declare const SaveOnboardingDraftBaseSpec: ContractSpec<SchemaModel<{
   data: {
-    type: _lssm_lib_schema302.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema108.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>, SchemaModel<{
   id: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: false;
   };
 }>, undefined>;
 /** Get current onboarding draft (on mount/restore) */
 declare const GetOnboardingDraftOutput: SchemaModel<{
   id: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
   data: {
-    type: _lssm_lib_schema302.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema108.FieldType<unknown, unknown>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema302.FieldType<Date, string>;
+    type: _lssm_lib_schema108.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema302.FieldType<Date, string>;
+    type: _lssm_lib_schema108.FieldType<Date, string>;
     isOptional: true;
   };
 }>;
-declare const GetOnboardingDraftBaseSpec: ContractSpec<_lssm_lib_schema302.AnySchemaModel, SchemaModel<{
+declare const GetOnboardingDraftBaseSpec: ContractSpec<_lssm_lib_schema108.AnySchemaModel, SchemaModel<{
   id: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
   data: {
-    type: _lssm_lib_schema302.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema108.FieldType<unknown, unknown>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema302.FieldType<Date, string>;
+    type: _lssm_lib_schema108.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema302.FieldType<Date, string>;
+    type: _lssm_lib_schema108.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 /** Delete onboarding draft (cleanup after completion or cancel) */
 declare const DeleteOnboardingDraftOutput: SchemaModel<{
   ok: {
-    type: _lssm_lib_schema302.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema108.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>;
-declare const DeleteOnboardingDraftBaseSpec: ContractSpec<_lssm_lib_schema302.AnySchemaModel, SchemaModel<{
+declare const DeleteOnboardingDraftBaseSpec: ContractSpec<_lssm_lib_schema108.AnySchemaModel, SchemaModel<{
   ok: {
-    type: _lssm_lib_schema302.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema108.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 /** Complete onboarding (final submit, creates entities) */
 declare const CompleteOnboardingBaseInput: SchemaModel<{
   data: {
-    type: _lssm_lib_schema302.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema108.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>;
 declare const CompleteOnboardingBaseOutput: SchemaModel<{
   success: {
-    type: _lssm_lib_schema302.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema108.FieldType<boolean, boolean>;
     isOptional: false;
   };
   userId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
 }>;
 declare const CompleteOnboardingBaseSpec: ContractSpec<SchemaModel<{
   data: {
-    type: _lssm_lib_schema302.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema108.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema302.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema108.FieldType<boolean, boolean>;
     isOptional: false;
   };
   userId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema302.FieldType<string, string>;
+    type: _lssm_lib_schema108.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/onboarding-base.js

@@ -1 +1,196 @@
-import{l as e}from"./schema/dist/ScalarTypeEnum.js";import{t}from"./schema/dist/SchemaModel.js";import"./schema/dist/index.js";import{defineCommand as n,defineQuery as r}from"./spec.js";import{OwnersEnum as i,StabilityEnum as a}from"./ownership.js";const o=new t({name:`SaveOnboardingDraftInput`,description:`Input for saving onboarding draft`,fields:{data:{type:e.JSON(),isOptional:!1}}}),s=new t({name:`SaveOnboardingDraftOutput`,description:`Output for saving onboarding draft`,fields:{id:{type:e.ID(),isOptional:!1},organizationId:{type:e.ID(),isOptional:!1}}}),c=n({meta:{name:`base.onboarding.saveDraft`,version:1,stability:a.Beta,owners:[i.PlatformSigil],tags:[`onboarding`,`draft`],description:`Save or update onboarding draft for active organization`,goal:`Persist onboarding progress incrementally for resumption and safety`,context:`Auto-saves every few seconds during onboarding; enables users to leave and resume`},io:{input:o,output:s},policy:{auth:`user`,escalate:null},transport:{gql:{field:`saveOnboardingDraft`},rest:{method:`POST`}}}),l=new t({name:`GetOnboardingDraftOutput`,description:`Onboarding draft payload`,fields:{id:{type:e.ID(),isOptional:!0},organizationId:{type:e.ID(),isOptional:!0},data:{type:e.JSON(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!0},updatedAt:{type:e.DateTime(),isOptional:!0}}}),u=r({meta:{name:`base.onboarding.getDraft`,version:1,stability:a.Beta,owners:[i.PlatformSigil],tags:[`onboarding`,`draft`],description:`Get onboarding draft for active organization`,goal:`Retrieve saved onboarding progress`,context:`Called on mount to restore in-progress onboarding`},io:{input:null,output:l},policy:{auth:`user`,escalate:null},transport:{gql:{field:`getOnboardingDraft`},rest:{method:`GET`}}}),d=new t({name:`DeleteOnboardingDraftOutput`,description:`Result of delete operation`,fields:{ok:{type:e.Boolean(),isOptional:!1}}}),f=n({meta:{name:`base.onboarding.deleteDraft`,version:1,stability:a.Beta,owners:[i.PlatformSigil],tags:[`onboarding`,`draft`],description:`Delete onboarding draft for active organization`,goal:`Clear draft after completion or if user wants to restart`,context:`Called after successful onboarding or explicit user reset`},io:{input:null,output:d},policy:{auth:`user`,escalate:null},transport:{gql:{field:`deleteOnboardingDraft`},rest:{method:`POST`}}}),p=new t({name:`CompleteOnboardingBaseInput`,description:`Input for completing onboarding`,fields:{data:{type:e.JSON(),isOptional:!1}}}),m=new t({name:`CompleteOnboardingBaseOutput`,description:`Result of onboarding completion`,fields:{success:{type:e.Boolean(),isOptional:!1},userId:{type:e.ID(),isOptional:!0},organizationId:{type:e.ID(),isOptional:!0}}}),h=n({meta:{name:`base.onboarding.complete`,version:1,stability:a.Beta,owners:[i.PlatformSigil],tags:[`onboarding`],description:`Complete onboarding and finalize user/organization setup`,goal:`Transition from draft to active profile`,context:`Validates all required fields, creates/updates entities, marks onboarding complete`},io:{input:p,output:m},policy:{auth:`user`,escalate:null},transport:{gql:{field:`completeOnboarding`},rest:{method:`POST`}}});export{p as CompleteOnboardingBaseInput,m as CompleteOnboardingBaseOutput,h as CompleteOnboardingBaseSpec,f as DeleteOnboardingDraftBaseSpec,d as DeleteOnboardingDraftOutput,u as GetOnboardingDraftBaseSpec,l as GetOnboardingDraftOutput,c as SaveOnboardingDraftBaseSpec,o as SaveOnboardingDraftInput,s as SaveOnboardingDraftOutput};
+import { ScalarTypeEnum } from "./schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "./schema/dist/SchemaModel.js";
+import "./schema/dist/index.js";
+import { defineCommand, defineQuery } from "./spec.js";
+import { OwnersEnum, StabilityEnum } from "./ownership.js";
+
+//#region src/onboarding-base.ts
+/**
+* Shared base contracts for onboarding flows across verticals.
+* These operations are reusable for any app that needs multi-step onboarding with draft persistence.
+*/
+/** Save/update onboarding draft (auto-save during flow) */
+const SaveOnboardingDraftInput = new SchemaModel({
+	name: "SaveOnboardingDraftInput",
+	description: "Input for saving onboarding draft",
+	fields: { data: {
+		type: ScalarTypeEnum.JSON(),
+		isOptional: false
+	} }
+});
+const SaveOnboardingDraftOutput = new SchemaModel({
+	name: "SaveOnboardingDraftOutput",
+	description: "Output for saving onboarding draft",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		organizationId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		}
+	}
+});
+const SaveOnboardingDraftBaseSpec = defineCommand({
+	meta: {
+		name: "base.onboarding.saveDraft",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding", "draft"],
+		description: "Save or update onboarding draft for active organization",
+		goal: "Persist onboarding progress incrementally for resumption and safety",
+		context: "Auto-saves every few seconds during onboarding; enables users to leave and resume"
+	},
+	io: {
+		input: SaveOnboardingDraftInput,
+		output: SaveOnboardingDraftOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "saveOnboardingDraft" },
+		rest: { method: "POST" }
+	}
+});
+/** Get current onboarding draft (on mount/restore) */
+const GetOnboardingDraftOutput = new SchemaModel({
+	name: "GetOnboardingDraftOutput",
+	description: "Onboarding draft payload",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		organizationId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		data: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const GetOnboardingDraftBaseSpec = defineQuery({
+	meta: {
+		name: "base.onboarding.getDraft",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding", "draft"],
+		description: "Get onboarding draft for active organization",
+		goal: "Retrieve saved onboarding progress",
+		context: "Called on mount to restore in-progress onboarding"
+	},
+	io: {
+		input: null,
+		output: GetOnboardingDraftOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "getOnboardingDraft" },
+		rest: { method: "GET" }
+	}
+});
+/** Delete onboarding draft (cleanup after completion or cancel) */
+const DeleteOnboardingDraftOutput = new SchemaModel({
+	name: "DeleteOnboardingDraftOutput",
+	description: "Result of delete operation",
+	fields: { ok: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+const DeleteOnboardingDraftBaseSpec = defineCommand({
+	meta: {
+		name: "base.onboarding.deleteDraft",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding", "draft"],
+		description: "Delete onboarding draft for active organization",
+		goal: "Clear draft after completion or if user wants to restart",
+		context: "Called after successful onboarding or explicit user reset"
+	},
+	io: {
+		input: null,
+		output: DeleteOnboardingDraftOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "deleteOnboardingDraft" },
+		rest: { method: "POST" }
+	}
+});
+/** Complete onboarding (final submit, creates entities) */
+const CompleteOnboardingBaseInput = new SchemaModel({
+	name: "CompleteOnboardingBaseInput",
+	description: "Input for completing onboarding",
+	fields: { data: {
+		type: ScalarTypeEnum.JSON(),
+		isOptional: false
+	} }
+});
+const CompleteOnboardingBaseOutput = new SchemaModel({
+	name: "CompleteOnboardingBaseOutput",
+	description: "Result of onboarding completion",
+	fields: {
+		success: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		organizationId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		}
+	}
+});
+const CompleteOnboardingBaseSpec = defineCommand({
+	meta: {
+		name: "base.onboarding.complete",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding"],
+		description: "Complete onboarding and finalize user/organization setup",
+		goal: "Transition from draft to active profile",
+		context: "Validates all required fields, creates/updates entities, marks onboarding complete"
+	},
+	io: {
+		input: CompleteOnboardingBaseInput,
+		output: CompleteOnboardingBaseOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "completeOnboarding" },
+		rest: { method: "POST" }
+	}
+});
+
+//#endregion
+export { CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput };

package/dist/openapi.js

@@ -1 +1,75 @@
-import{defaultRestPath as e,jsonSchemaForSpec as t}from"./jsonschema.js";function n(e,t){return`${e.replace(/\./g,`_`)}_v${t}`}function r(e,t,r){return`${e}_${n(t,r)}`}function i(e,t){return(t??(e===`query`?`GET`:`POST`)).toLowerCase()}function a(t){let n=t.transport?.rest?.path??e(t.meta.name,t.meta.version);return n.startsWith(`/`)?n:`/${n}`}function o(e,o={}){let s=e.listSpecs().filter(e=>e.meta.kind===`command`||e.meta.kind===`query`).slice().sort((e,t)=>{let n=e.meta.name.localeCompare(t.meta.name);return n===0?e.meta.version-t.meta.version:n}),c={openapi:`3.1.0`,info:{title:o.title??`ContractSpec API`,version:o.version??`0.0.0`,...o.description?{description:o.description}:{}},...o.servers?{servers:o.servers}:{},paths:{},components:{schemas:{}}};for(let e of s){let o=t(e),s=i(e.meta.kind,e.transport?.rest?.method),l=a(e),u=n(e.meta.name,e.meta.version),d=c.paths[l]??={},f={operationId:u,summary:e.meta.description??e.meta.name,description:e.meta.description,tags:e.meta.tags??[],"x-contractspec":{name:e.meta.name,version:e.meta.version,kind:e.meta.kind},responses:{}};if(o.input){let t=r(`Input`,e.meta.name,e.meta.version);c.components.schemas[t]=o.input,f.requestBody={required:!0,content:{"application/json":{schema:{$ref:`#/components/schemas/${t}`}}}}}let p={};if(o.output){let t=r(`Output`,e.meta.name,e.meta.version);c.components.schemas[t]=o.output,p[200]={description:`OK`,content:{"application/json":{schema:{$ref:`#/components/schemas/${t}`}}}}}else p[200]={description:`OK`};f.responses=p,d[s]=f}return c}export{o as openApiForRegistry};
+import { defaultRestPath, jsonSchemaForSpec } from "./jsonschema.js";
+
+//#region src/openapi.ts
+function toOperationId(name, version) {
+	return `${name.replace(/\./g, "_")}_v${version}`;
+}
+function toSchemaName(prefix, name, version) {
+	return `${prefix}_${toOperationId(name, version)}`;
+}
+function toHttpMethod(kind, override) {
+	return (override ?? (kind === "query" ? "GET" : "POST")).toLowerCase();
+}
+function toRestPath(spec) {
+	const path = spec.transport?.rest?.path ?? defaultRestPath(spec.meta.name, spec.meta.version);
+	return path.startsWith("/") ? path : `/${path}`;
+}
+function openApiForRegistry(registry, options = {}) {
+	const specs = registry.listSpecs().filter((s) => s.meta.kind === "command" || s.meta.kind === "query").slice().sort((a, b) => {
+		const byName = a.meta.name.localeCompare(b.meta.name);
+		return byName !== 0 ? byName : a.meta.version - b.meta.version;
+	});
+	const doc = {
+		openapi: "3.1.0",
+		info: {
+			title: options.title ?? "ContractSpec API",
+			version: options.version ?? "0.0.0",
+			...options.description ? { description: options.description } : {}
+		},
+		...options.servers ? { servers: options.servers } : {},
+		paths: {},
+		components: { schemas: {} }
+	};
+	for (const spec of specs) {
+		const schema = jsonSchemaForSpec(spec);
+		const method = toHttpMethod(spec.meta.kind, spec.transport?.rest?.method);
+		const path = toRestPath(spec);
+		const operationId = toOperationId(spec.meta.name, spec.meta.version);
+		const pathItem = doc.paths[path] ??= {};
+		const op = {
+			operationId,
+			summary: spec.meta.description ?? spec.meta.name,
+			description: spec.meta.description,
+			tags: spec.meta.tags ?? [],
+			"x-contractspec": {
+				name: spec.meta.name,
+				version: spec.meta.version,
+				kind: spec.meta.kind
+			},
+			responses: {}
+		};
+		if (schema.input) {
+			const inputName = toSchemaName("Input", spec.meta.name, spec.meta.version);
+			doc.components.schemas[inputName] = schema.input;
+			op["requestBody"] = {
+				required: true,
+				content: { "application/json": { schema: { $ref: `#/components/schemas/${inputName}` } } }
+			};
+		}
+		const responses = {};
+		if (schema.output) {
+			const outputName = toSchemaName("Output", spec.meta.name, spec.meta.version);
+			doc.components.schemas[outputName] = schema.output;
+			responses["200"] = {
+				description: "OK",
+				content: { "application/json": { schema: { $ref: `#/components/schemas/${outputName}` } } }
+			};
+		} else responses["200"] = { description: "OK" };
+		op["responses"] = responses;
+		pathItem[method] = op;
+	}
+	return doc;
+}
+
+//#endregion
+export { openApiForRegistry };

package/dist/openbanking/docs/openbanking.docblock.js

@@ -1,109 +1,22 @@
-import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.openbanking`,title:`Open Banking (Powens) Overview`,summary:`The Pocket Family Office vertical now supports read-only open banking capabilities powered by Powens. This doc summarises the contract surfaces, canonical data models, workflows, telemetry, and guardrails introduced to make Powens a first-class integration.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/openbanking`,tags:[`tech`,`contracts`,`openbanking`],body:`# Open Banking (Powens) Overview
-
-The Pocket Family Office vertical now supports read-only open banking capabilities powered by Powens. This doc summarises the contract surfaces, canonical data models, workflows, telemetry, and guardrails introduced to make Powens a first-class integration.
-
-## Integration Spec
-
-Powens is registered under \`openbanking.powens\` with category \`open-banking\` and currently supports the BYOK ownership mode. The spec exposes three read-only capabilities:
-
-- \`openbanking.accounts.read\`
-- \`openbanking.transactions.read\`
-- \`openbanking.balances.read\`
-
-Configuration and secrets are separated:
-
-| Config Field | Description |
-| --- | --- |
-| \`environment\` | Powens environment (\`sandbox\` \\| \`production\`) |
-| \`baseUrl?\` | Optional API base URL override |
-| \`region?\` | Optional Powens region identifier |
-| \`pollingIntervalMs?\` | Optional custom sync cadence |
-
-| Secret Field | Description |
-| --- | --- |
-| \`clientId\` | Powens OAuth client identifier |
-| \`clientSecret\` | Powens OAuth client secret |
-| \`apiKey?\` | Optional supplemental Powens API key |
-| \`webhookSecret?\` | Optional webhook signing secret |
-
-## Canonical Data Models
-
-Canonical schemas live in \`@lssm/lib.contracts/integrations/openbanking/models\`:
-
-- \`BankAccountRecord\` – account metadata (institution, IBAN/BIC, masked numbers, balances, sync timestamps)
-- \`BankTransactionRecord\` – transaction ledger (amounts, categories, counterparty, status)
-- \`AccountBalanceRecord\` – balance snapshots per account and balance type
-
-These schemas power the vertical contracts and workflows, ensuring downstream features never use raw Powens payloads directly.
-
-## Provider Implementation
-
-\`PowensOpenBankingProvider\` wraps \`PowensClient\` which handles OAuth token management, request retries, and error mapping. The provider maps Powens payloads to the canonical interfaces exported from \`integrations/providers/openbanking\`.
-
-Factory support lives in \`IntegrationProviderFactory.createOpenBankingProvider\`, which validates configuration, loads BYOK secrets, and instantiates the provider.
-
-## Contracts
-
-Command/query contracts exist under \`integrations/openbanking/contracts\`:
-
-- \`openbanking.accounts.sync\` & \`openbanking.accounts.list\`
-- \`openbanking.transactions.sync\` & \`openbanking.transactions.list\`
-- \`openbanking.balances.refresh\` & \`openbanking.balances.get\`
-
-The Pocket Family Office bundle also exposes \`pfo.openbanking.generate-overview\`, which aggregates balances and transactions into a derived knowledge document.
-
-## Workflows
-
-New workflow specs (all requiring the \`primaryOpenBanking\` slot) orchestrate the sync flows:
-
-- \`pfo.workflow.sync-openbanking-accounts\`
-- \`pfo.workflow.sync-openbanking-transactions\`
-- \`pfo.workflow.refresh-openbanking-balances\`
-- \`pfo.workflow.generate-openbanking-overview\`
-
-Each workflow runs against the Powens provider, persists canonical records, and emits telemetry.
-
-## Knowledge & LLM Exposure
-
-Raw Powens payloads are never stored in knowledge spaces. Instead, \`knowledge.financial-overview\` captures derived summaries (cashflow, category breakdowns, balance trends) produced by \`pfo.openbanking.generate-overview\`. The space is \`operational\` category with 180-day retention and automation write access.
-
-When exposing data to LLMs or analytics:
-
-- Use derived summaries only.
-- Redact PII fields using \`redactOpenBankingTelemetryPayload\`.
-- Never emit IBANs, unmasked account numbers, or counterparty detail in telemetry/logs.
-
-## Telemetry
-
-Telemetry constants live in \`integrations/openbanking/telemetry\`. Key events:
-
-- \`openbanking.accounts.synced\`
-- \`openbanking.transactions.synced\`
-- \`openbanking.balances.refreshed\`
-- \`openbanking.overview.generated\`
-
-All events require tenant/app/blueprint/config metadata, and sensitive properties are flagged to avoid accidental leakage.
-
-## Guardrails
-
-\`ensurePrimaryOpenBankingIntegration\` verifies \`primaryOpenBanking\` is bound and healthy before workflows proceed. Runtime pre-flight checks already block workflows when the connection is disconnected or in error status.
-
-## Blueprint & Tenant Defaults
-
-\`pocketFamilyOfficeBlueprint\` now includes:
-
-- \`primaryOpenBanking\` slot (required, BYOK)
-- \`openbanking.*.read\` capabilities enabled by default
-- Workflow bindings for the new sync flows
-
-Sample tenant bindings (\`tenant.sample.ts\`) reference \`conn-powens-primary\` and bind the new knowledge space.
-
----
-
-Follow this doc when extending open banking support (e.g., adding payment initiation, additional providers, or expanded analytics) to keep the integration consistent and audited.
-
-
-
-
-
-`}];e(t);export{t as tech_contracts_openbanking_DocBlocks};
+import { registerDocBlocks } from "../../docs/registry.js";
+import "../../registry.js";
+
+//#region src/openbanking/docs/openbanking.docblock.ts
+const tech_contracts_openbanking_DocBlocks = [{
+	id: "docs.tech.contracts.openbanking",
+	title: "Open Banking (Powens) Overview",
+	summary: "The Pocket Family Office vertical now supports read-only open banking capabilities powered by Powens. This doc summarises the contract surfaces, canonical data models, workflows, telemetry, and guardrails introduced to make Powens a first-class integration.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/openbanking",
+	tags: [
+		"tech",
+		"contracts",
+		"openbanking"
+	],
+	body: "# Open Banking (Powens) Overview\n\nThe Pocket Family Office vertical now supports read-only open banking capabilities powered by Powens. This doc summarises the contract surfaces, canonical data models, workflows, telemetry, and guardrails introduced to make Powens a first-class integration.\n\n## Integration Spec\n\nPowens is registered under `openbanking.powens` with category `open-banking` and currently supports the BYOK ownership mode. The spec exposes three read-only capabilities:\n\n- `openbanking.accounts.read`\n- `openbanking.transactions.read`\n- `openbanking.balances.read`\n\nConfiguration and secrets are separated:\n\n| Config Field | Description |\n| --- | --- |\n| `environment` | Powens environment (`sandbox` \\| `production`) |\n| `baseUrl?` | Optional API base URL override |\n| `region?` | Optional Powens region identifier |\n| `pollingIntervalMs?` | Optional custom sync cadence |\n\n| Secret Field | Description |\n| --- | --- |\n| `clientId` | Powens OAuth client identifier |\n| `clientSecret` | Powens OAuth client secret |\n| `apiKey?` | Optional supplemental Powens API key |\n| `webhookSecret?` | Optional webhook signing secret |\n\n## Canonical Data Models\n\nCanonical schemas live in `@lssm/lib.contracts/integrations/openbanking/models`:\n\n- `BankAccountRecord` – account metadata (institution, IBAN/BIC, masked numbers, balances, sync timestamps)\n- `BankTransactionRecord` – transaction ledger (amounts, categories, counterparty, status)\n- `AccountBalanceRecord` – balance snapshots per account and balance type\n\nThese schemas power the vertical contracts and workflows, ensuring downstream features never use raw Powens payloads directly.\n\n## Provider Implementation\n\n`PowensOpenBankingProvider` wraps `PowensClient` which handles OAuth token management, request retries, and error mapping. The provider maps Powens payloads to the canonical interfaces exported from `integrations/providers/openbanking`.\n\nFactory support lives in `IntegrationProviderFactory.createOpenBankingProvider`, which validates configuration, loads BYOK secrets, and instantiates the provider.\n\n## Contracts\n\nCommand/query contracts exist under `integrations/openbanking/contracts`:\n\n- `openbanking.accounts.sync` & `openbanking.accounts.list`\n- `openbanking.transactions.sync` & `openbanking.transactions.list`\n- `openbanking.balances.refresh` & `openbanking.balances.get`\n\nThe Pocket Family Office bundle also exposes `pfo.openbanking.generate-overview`, which aggregates balances and transactions into a derived knowledge document.\n\n## Workflows\n\nNew workflow specs (all requiring the `primaryOpenBanking` slot) orchestrate the sync flows:\n\n- `pfo.workflow.sync-openbanking-accounts`\n- `pfo.workflow.sync-openbanking-transactions`\n- `pfo.workflow.refresh-openbanking-balances`\n- `pfo.workflow.generate-openbanking-overview`\n\nEach workflow runs against the Powens provider, persists canonical records, and emits telemetry.\n\n## Knowledge & LLM Exposure\n\nRaw Powens payloads are never stored in knowledge spaces. Instead, `knowledge.financial-overview` captures derived summaries (cashflow, category breakdowns, balance trends) produced by `pfo.openbanking.generate-overview`. The space is `operational` category with 180-day retention and automation write access.\n\nWhen exposing data to LLMs or analytics:\n\n- Use derived summaries only.\n- Redact PII fields using `redactOpenBankingTelemetryPayload`.\n- Never emit IBANs, unmasked account numbers, or counterparty detail in telemetry/logs.\n\n## Telemetry\n\nTelemetry constants live in `integrations/openbanking/telemetry`. Key events:\n\n- `openbanking.accounts.synced`\n- `openbanking.transactions.synced`\n- `openbanking.balances.refreshed`\n- `openbanking.overview.generated`\n\nAll events require tenant/app/blueprint/config metadata, and sensitive properties are flagged to avoid accidental leakage.\n\n## Guardrails\n\n`ensurePrimaryOpenBankingIntegration` verifies `primaryOpenBanking` is bound and healthy before workflows proceed. Runtime pre-flight checks already block workflows when the connection is disconnected or in error status.\n\n## Blueprint & Tenant Defaults\n\n`pocketFamilyOfficeBlueprint` now includes:\n\n- `primaryOpenBanking` slot (required, BYOK)\n- `openbanking.*.read` capabilities enabled by default\n- Workflow bindings for the new sync flows\n\nSample tenant bindings (`tenant.sample.ts`) reference `conn-powens-primary` and bind the new knowledge space.\n\n---\n\nFollow this doc when extending open banking support (e.g., adding payment initiation, additional providers, or expanded analytics) to keep the integration consistent and audited.\n\n\n\n\n\n"
+}];
+registerDocBlocks(tech_contracts_openbanking_DocBlocks);
+
+//#endregion
+export { tech_contracts_openbanking_DocBlocks };

package/dist/ownership.js

@@ -1 +1,40 @@
-const e={Idea:`idea`,InCreation:`in_creation`,Experimental:`experimental`,Beta:`beta`,Stable:`stable`,Deprecated:`deprecated`},t={ProductColiving:`product.coliving`,ProductStrit:`product.strit`,ProductArtisanos:`product.artisanos`,PlatformSigil:`platform.sigil`,PlatformMarketplace:`platform.marketplace`,PlatformContent:`platform.content`,PlatformFeatureFlags:`platform.featureflags`},n=t,r={Spots:`spots`,Collectivity:`collectivity`,Marketplace:`marketplace`,Sellers:`sellers`,Auth:`auth`,Login:`login`,Signup:`signup`,Guide:`guide`,Docs:`docs`,I18n:`i18n`,AtomicPages:`atomic:pages`,Incident:`incident`,Hygiene:`hygiene`,WeeklyPulse:`weekly_pulse`,WebAuth:`webauth`},i=r;export{n as Owners,t as OwnersEnum,e as StabilityEnum,i as Tags,r as TagsEnum};
+//#region src/ownership.ts
+const StabilityEnum = {
+	Idea: "idea",
+	InCreation: "in_creation",
+	Experimental: "experimental",
+	Beta: "beta",
+	Stable: "stable",
+	Deprecated: "deprecated"
+};
+const OwnersEnum = {
+	ProductColiving: "product.coliving",
+	ProductStrit: "product.strit",
+	ProductArtisanos: "product.artisanos",
+	PlatformSigil: "platform.sigil",
+	PlatformMarketplace: "platform.marketplace",
+	PlatformContent: "platform.content",
+	PlatformFeatureFlags: "platform.featureflags"
+};
+const Owners = OwnersEnum;
+const TagsEnum = {
+	Spots: "spots",
+	Collectivity: "collectivity",
+	Marketplace: "marketplace",
+	Sellers: "sellers",
+	Auth: "auth",
+	Login: "login",
+	Signup: "signup",
+	Guide: "guide",
+	Docs: "docs",
+	I18n: "i18n",
+	AtomicPages: "atomic:pages",
+	Incident: "incident",
+	Hygiene: "hygiene",
+	WeeklyPulse: "weekly_pulse",
+	WebAuth: "webauth"
+};
+const Tags = TagsEnum;
+
+//#endregion
+export { Owners, OwnersEnum, StabilityEnum, Tags, TagsEnum };