@contractspec/example.openbanking-powens 1.46.1 → 1.48.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
  $ tsdown
2
- ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
2
+ ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
3
3
  ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/openbanking-powens/tsdown.config.js
4
4
  ℹ entry: src/example.ts, src/index.ts, src/docs/index.ts, src/docs/openbanking-powens.docblock.ts, src/handlers/oauth-callback.ts, src/handlers/webhook-handler.ts
5
5
  ℹ target: esnext
@@ -9,23 +9,23 @@ $ tsdown
9
9
  ℹ dist/handlers/webhook-handler.js 3.32 kB │ gzip: 1.23 kB
10
10
  ℹ dist/handlers/oauth-callback.js 2.42 kB │ gzip: 1.02 kB
11
11
  ℹ dist/docs/openbanking-powens.docblock.js 1.57 kB │ gzip: 0.76 kB
12
- ℹ dist/example.js 0.99 kB │ gzip: 0.52 kB
12
+ ℹ dist/example.js 1.07 kB │ gzip: 0.55 kB
13
13
  ℹ dist/index.js 0.30 kB │ gzip: 0.16 kB
14
14
  ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
15
- ℹ dist/handlers/webhook-handler.js.map 6.46 kB │ gzip: 2.18 kB
16
- ℹ dist/handlers/oauth-callback.js.map 4.84 kB │ gzip: 1.81 kB
15
+ ℹ dist/handlers/webhook-handler.js.map 6.40 kB │ gzip: 2.17 kB
16
+ ℹ dist/handlers/oauth-callback.js.map 4.79 kB │ gzip: 1.80 kB
17
17
  ℹ dist/docs/openbanking-powens.docblock.js.map 2.07 kB │ gzip: 0.94 kB
18
- ℹ dist/example.js.map 1.52 kB │ gzip: 0.74 kB
18
+ ℹ dist/example.js.map 1.51 kB │ gzip: 0.74 kB
19
19
  ℹ dist/handlers/webhook-handler.d.ts.map 0.17 kB │ gzip: 0.14 kB
20
20
  ℹ dist/handlers/oauth-callback.d.ts.map 0.17 kB │ gzip: 0.15 kB
21
- ℹ dist/example.d.ts.map 0.12 kB │ gzip: 0.12 kB
21
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
22
+ ℹ dist/example.d.ts 0.25 kB │ gzip: 0.17 kB
22
23
  ℹ dist/index.d.ts 0.25 kB │ gzip: 0.13 kB
23
24
  ℹ dist/handlers/oauth-callback.d.ts 0.22 kB │ gzip: 0.17 kB
24
25
  ℹ dist/handlers/webhook-handler.d.ts 0.21 kB │ gzip: 0.16 kB
25
- ℹ dist/example.d.ts 0.20 kB │ gzip: 0.16 kB
26
26
  ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
27
27
  ℹ dist/docs/openbanking-powens.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
28
- ℹ 19 files, total: 24.90 kB
28
+ ℹ 19 files, total: 24.91 kB
29
29
  src/handlers/webhook-handler.ts (7:44) [UNRESOLVED_IMPORT] Warning: Could not resolve 'crypto' in src/handlers/webhook-handler.ts
30
30
  ╭─[ src/handlers/webhook-handler.ts:7:45 ]
31
31
  │
@@ -36,4 +36,4 @@ src/handlers/webhook-handler.ts (7:44) [UNRESOLVED_IMPORT] Warning: Cou
36
36
   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
37
37
  ───╯
38
38
 
39
- ✔ Build complete in 4106ms
39
+ ✔ Build complete in 13593ms
@@ -1,7 +1,7 @@
1
1
  $ bun build:types && bun build:bundle
2
2
  $ tsc --noEmit
3
3
  $ tsdown
4
- ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
4
+ ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
5
5
  ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/openbanking-powens/tsdown.config.js
6
6
  ℹ entry: src/example.ts, src/index.ts, src/docs/index.ts, src/docs/openbanking-powens.docblock.ts, src/handlers/oauth-callback.ts, src/handlers/webhook-handler.ts
7
7
  ℹ target: esnext
@@ -10,23 +10,23 @@ $ tsdown
10
10
  ℹ dist/handlers/webhook-handler.js 3.32 kB │ gzip: 1.23 kB
11
11
  ℹ dist/handlers/oauth-callback.js 2.42 kB │ gzip: 1.02 kB
12
12
  ℹ dist/docs/openbanking-powens.docblock.js 1.57 kB │ gzip: 0.76 kB
13
- ℹ dist/example.js 0.99 kB │ gzip: 0.52 kB
13
+ ℹ dist/example.js 1.07 kB │ gzip: 0.55 kB
14
14
  ℹ dist/index.js 0.30 kB │ gzip: 0.16 kB
15
15
  ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
16
- ℹ dist/handlers/webhook-handler.js.map 6.46 kB │ gzip: 2.18 kB
17
- ℹ dist/handlers/oauth-callback.js.map 4.84 kB │ gzip: 1.81 kB
16
+ ℹ dist/handlers/webhook-handler.js.map 6.40 kB │ gzip: 2.17 kB
17
+ ℹ dist/handlers/oauth-callback.js.map 4.79 kB │ gzip: 1.80 kB
18
18
  ℹ dist/docs/openbanking-powens.docblock.js.map 2.07 kB │ gzip: 0.94 kB
19
- ℹ dist/example.js.map 1.52 kB │ gzip: 0.74 kB
19
+ ℹ dist/example.js.map 1.51 kB │ gzip: 0.74 kB
20
20
  ℹ dist/handlers/webhook-handler.d.ts.map 0.17 kB │ gzip: 0.14 kB
21
21
  ℹ dist/handlers/oauth-callback.d.ts.map 0.17 kB │ gzip: 0.15 kB
22
- ℹ dist/example.d.ts.map 0.12 kB │ gzip: 0.12 kB
22
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
23
+ ℹ dist/example.d.ts 0.25 kB │ gzip: 0.17 kB
23
24
  ℹ dist/index.d.ts 0.25 kB │ gzip: 0.13 kB
24
25
  ℹ dist/handlers/oauth-callback.d.ts 0.22 kB │ gzip: 0.17 kB
25
26
  ℹ dist/handlers/webhook-handler.d.ts 0.21 kB │ gzip: 0.16 kB
26
- ℹ dist/example.d.ts 0.20 kB │ gzip: 0.16 kB
27
27
  ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
28
28
  ℹ dist/docs/openbanking-powens.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
29
- ℹ 19 files, total: 24.90 kB
29
+ ℹ 19 files, total: 24.91 kB
30
30
  src/handlers/webhook-handler.ts (7:44) [UNRESOLVED_IMPORT] Warning: Could not resolve 'crypto' in src/handlers/webhook-handler.ts
31
31
  ╭─[ src/handlers/webhook-handler.ts:7:45 ]
32
32
  │
@@ -37,4 +37,4 @@ src/handlers/webhook-handler.ts (7:44) [UNRESOLVED_IMPORT] Warning: Cou
37
37
   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
38
38
  ───╯
39
39
 
40
- ✔ Build complete in 3545ms
40
+ ✔ Build complete in 20828ms
package/CHANGELOG.md CHANGED
@@ -1,5 +1,48 @@
1
1
  # @contractspec/example.openbanking-powens
2
2
 
3
+ ## 1.48.0
4
+
5
+ ### Minor Changes
6
+
7
+ - b0444a4: feat: reduce adoption's friction by allowing generation of contracts from an analyse of the codebase
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [b0444a4]
12
+ - @contractspec/integration.providers-impls@1.48.0
13
+ - @contractspec/lib.contracts@1.48.0
14
+
15
+ ## 1.47.0
16
+
17
+ ### Minor Changes
18
+
19
+ - caf8701: feat: add cli vibe command to run workflow
20
+ - c69b849: feat: add api web services (mcp & website)
21
+ - 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
22
+ - fd38e85: feat: auto-fix contractspec issues
23
+
24
+ ### Patch Changes
25
+
26
+ - e7ded36: feat: improve stability (adding ts-morph)
27
+ - c231a8b: test: improve workspace stability
28
+ - Updated dependencies [e7ded36]
29
+ - Updated dependencies [caf8701]
30
+ - Updated dependencies [c69b849]
31
+ - Updated dependencies [c231a8b]
32
+ - Updated dependencies [42b8d78]
33
+ - Updated dependencies [fd38e85]
34
+ - @contractspec/integration.providers-impls@1.47.0
35
+ - @contractspec/lib.contracts@1.47.0
36
+
37
+ ## 1.46.2
38
+
39
+ ### Patch Changes
40
+
41
+ - 7e21625: feat: library services (landing page & api)
42
+ - Updated dependencies [7e21625]
43
+ - @contractspec/integration.providers-impls@1.46.2
44
+ - @contractspec/lib.contracts@1.46.2
45
+
3
46
  ## 1.46.1
4
47
 
5
48
  ### Patch Changes
package/dist/example.d.ts CHANGED
@@ -1,7 +1,7 @@
1
- import { ExampleSpec } from "@contractspec/lib.contracts";
1
+ import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
2
2
 
3
3
  //#region src/example.d.ts
4
- declare const example: ExampleSpec;
4
+ declare const example: _contractspec_lib_contracts0.ExampleSpec;
5
5
  //#endregion
6
6
  export { example as default };
7
7
  //# sourceMappingURL=example.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SAAS"}
1
+ {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA2BJ,4BAAA,CA3BW"}
package/dist/example.js CHANGED
@@ -1,5 +1,7 @@
1
+ import { defineExample } from "@contractspec/lib.contracts";
2
+
1
3
  //#region src/example.ts
2
- const example = {
4
+ const example = defineExample({
3
5
  meta: {
4
6
  key: "openbanking-powens",
5
7
  version: "1.0.0",
@@ -37,7 +39,7 @@ const example = {
37
39
  },
38
40
  mcp: { enabled: true }
39
41
  }
40
- };
42
+ });
41
43
  var example_default = example;
42
44
 
43
45
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"example.js","names":["example: ExampleSpec"],"sources":["../src/example.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\nconst example: ExampleSpec = {\n meta: {\n key: 'openbanking-powens',\n version: '1.0.0',\n title: 'Open Banking — Powens',\n description:\n 'OAuth callback + webhook handler patterns for Powens open banking integration (provider + workflow orchestration).',\n kind: 'integration',\n visibility: 'public',\n stability: 'experimental',\n owners: ['@platform.core'],\n tags: ['openbanking', 'powens', 'oauth', 'webhooks', 'integrations'],\n },\n docs: {\n rootDocId: 'docs.examples.openbanking-powens',\n usageDocId: 'docs.examples.openbanking-powens.usage',\n },\n entrypoints: {\n packageName: '@contractspec/example.openbanking-powens',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n};\n\nexport default example;\n"],"mappings":";AAEA,MAAMA,UAAuB;CAC3B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAe;GAAU;GAAS;GAAY;GAAe;EACrE;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
1
+ {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n meta: {\n key: 'openbanking-powens',\n version: '1.0.0',\n title: 'Open Banking — Powens',\n description:\n 'OAuth callback + webhook handler patterns for Powens open banking integration (provider + workflow orchestration).',\n kind: 'integration',\n visibility: 'public',\n stability: 'experimental',\n owners: ['@platform.core'],\n tags: ['openbanking', 'powens', 'oauth', 'webhooks', 'integrations'],\n },\n docs: {\n rootDocId: 'docs.examples.openbanking-powens',\n usageDocId: 'docs.examples.openbanking-powens.usage',\n },\n entrypoints: {\n packageName: '@contractspec/example.openbanking-powens',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAe;GAAU;GAAS;GAAY;GAAe;EACrE;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}
@@ -1 +1 @@
1
- {"version":3,"file":"oauth-callback.js","names":["fakeSecretStore: Record<string, ExamplePowensSecrets>"],"sources":["../../src/handlers/oauth-callback.ts"],"sourcesContent":["/**\n * Example OAuth callback handler for Powens (open banking).\n *\n * This example stays framework-neutral: it operates on the standard `Request`\n * type so it can be used in Next.js, Elysia, or any fetch-compatible runtime.\n */\nimport { PowensOpenBankingProvider } from '@contractspec/integration.providers-impls/impls/powens-openbanking';\nimport type { PowensEnvironment } from '@contractspec/integration.providers-impls/impls/powens-client';\n\nexport async function powensOAuthCallbackHandler(req: Request) {\n const url = new URL(req.url);\n const code = url.searchParams.get('code');\n const state = url.searchParams.get('state');\n const userUuid = url.searchParams.get('user_uuid');\n\n if (!code || !state || !userUuid) {\n return new Response('Missing Powens OAuth params', { status: 400 });\n }\n\n const connection = await getConnectionByState(state);\n if (!connection) {\n return new Response('Unknown Powens OAuth state', { status: 404 });\n }\n\n const secrets = await getPowensSecretsForConnection(connection.meta.id);\n\n const provider = new PowensOpenBankingProvider({\n clientId: secrets.clientId,\n clientSecret: secrets.clientSecret,\n apiKey: secrets.apiKey,\n environment: connection.config.environment as PowensEnvironment,\n baseUrl: connection.config.baseUrl as string | undefined,\n });\n\n const preview = await provider.listAccounts({\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n userId: userUuid,\n });\n\n await connection.storePowensUser({\n tenantUserId: connection.meta.tenantUserId,\n powensUserUuid: userUuid,\n authCode: code,\n });\n\n await enqueueWorkflow('pfo.workflow.sync-openbanking-accounts', {\n tenantId: connection.meta.tenantId,\n userUuid,\n connectionId: connection.meta.id,\n previewAccounts: preview.accounts,\n });\n\n const redirectBase = process.env.APP_DASHBOARD_URL ?? '';\n return Response.redirect(\n `${redirectBase}/banking/linked?tenant=${connection.meta.tenantId}`,\n 302\n );\n}\n\ninterface ExamplePowensSecrets {\n clientId: string;\n clientSecret: string;\n apiKey?: string;\n}\n\ninterface ExampleIntegrationConnection {\n meta: {\n id: string;\n tenantId: string;\n tenantUserId: string;\n };\n config: {\n environment: PowensEnvironment;\n baseUrl?: string;\n };\n storePowensUser(input: {\n tenantUserId: string;\n powensUserUuid: string;\n authCode: string;\n }): Promise<void>;\n}\n\nasync function getConnectionByState(\n state: string\n): Promise<ExampleIntegrationConnection | null> {\n const record = fakeDatabase.connections.find((conn) => conn.state === state);\n return record ?? null;\n}\n\nasync function getPowensSecretsForConnection(\n connectionId: string\n): Promise<ExamplePowensSecrets> {\n const secret = fakeSecretStore[connectionId];\n if (!secret) throw new Error(`Missing Powens secrets for ${connectionId}`);\n return secret;\n}\n\nasync function enqueueWorkflow(name: string, input: Record<string, unknown>) {\n await fakeWorkflowQueue.enqueue({ name, input });\n}\n\nconst fakeDatabase = {\n connections: [] as (ExampleIntegrationConnection & { state: string })[],\n};\n\nconst fakeSecretStore: Record<string, ExamplePowensSecrets> = {};\n\nconst fakeWorkflowQueue = {\n enqueue: async (_payload: Record<string, unknown>) => {\n /* no-op */\n },\n};\n"],"mappings":";;;;;;;;;AASA,eAAsB,2BAA2B,KAAc;CAC7D,MAAM,MAAM,IAAI,IAAI,IAAI,IAAI;CAC5B,MAAM,OAAO,IAAI,aAAa,IAAI,OAAO;CACzC,MAAM,QAAQ,IAAI,aAAa,IAAI,QAAQ;CAC3C,MAAM,WAAW,IAAI,aAAa,IAAI,YAAY;AAElD,KAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SACtB,QAAO,IAAI,SAAS,+BAA+B,EAAE,QAAQ,KAAK,CAAC;CAGrE,MAAM,aAAa,MAAM,qBAAqB,MAAM;AACpD,KAAI,CAAC,WACH,QAAO,IAAI,SAAS,8BAA8B,EAAE,QAAQ,KAAK,CAAC;CAGpE,MAAM,UAAU,MAAM,8BAA8B,WAAW,KAAK,GAAG;CAUvE,MAAM,UAAU,MARC,IAAI,0BAA0B;EAC7C,UAAU,QAAQ;EAClB,cAAc,QAAQ;EACtB,QAAQ,QAAQ;EAChB,aAAa,WAAW,OAAO;EAC/B,SAAS,WAAW,OAAO;EAC5B,CAAC,CAE6B,aAAa;EAC1C,UAAU,WAAW,KAAK;EAC1B,cAAc,WAAW,KAAK;EAC9B,QAAQ;EACT,CAAC;AAEF,OAAM,WAAW,gBAAgB;EAC/B,cAAc,WAAW,KAAK;EAC9B,gBAAgB;EAChB,UAAU;EACX,CAAC;AAEF,OAAM,gBAAgB,0CAA0C;EAC9D,UAAU,WAAW,KAAK;EAC1B;EACA,cAAc,WAAW,KAAK;EAC9B,iBAAiB,QAAQ;EAC1B,CAAC;CAEF,MAAM,eAAe,QAAQ,IAAI,qBAAqB;AACtD,QAAO,SAAS,SACd,GAAG,aAAa,yBAAyB,WAAW,KAAK,YACzD,IACD;;AA0BH,eAAe,qBACb,OAC8C;AAE9C,QADe,aAAa,YAAY,MAAM,SAAS,KAAK,UAAU,MAAM,IAC3D;;AAGnB,eAAe,8BACb,cAC+B;CAC/B,MAAM,SAAS,gBAAgB;AAC/B,KAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,8BAA8B,eAAe;AAC1E,QAAO;;AAGT,eAAe,gBAAgB,MAAc,OAAgC;AAC3E,OAAM,kBAAkB,QAAQ;EAAE;EAAM;EAAO,CAAC;;AAGlD,MAAM,eAAe,EACnB,aAAa,EAAE,EAChB;AAED,MAAMA,kBAAwD,EAAE;AAEhE,MAAM,oBAAoB,EACxB,SAAS,OAAO,aAAsC,IAGvD"}
1
+ {"version":3,"file":"oauth-callback.js","names":[],"sources":["../../src/handlers/oauth-callback.ts"],"sourcesContent":["/**\n * Example OAuth callback handler for Powens (open banking).\n *\n * This example stays framework-neutral: it operates on the standard `Request`\n * type so it can be used in Next.js, Elysia, or any fetch-compatible runtime.\n */\nimport { PowensOpenBankingProvider } from '@contractspec/integration.providers-impls/impls/powens-openbanking';\nimport type { PowensEnvironment } from '@contractspec/integration.providers-impls/impls/powens-client';\n\nexport async function powensOAuthCallbackHandler(req: Request) {\n const url = new URL(req.url);\n const code = url.searchParams.get('code');\n const state = url.searchParams.get('state');\n const userUuid = url.searchParams.get('user_uuid');\n\n if (!code || !state || !userUuid) {\n return new Response('Missing Powens OAuth params', { status: 400 });\n }\n\n const connection = await getConnectionByState(state);\n if (!connection) {\n return new Response('Unknown Powens OAuth state', { status: 404 });\n }\n\n const secrets = await getPowensSecretsForConnection(connection.meta.id);\n\n const provider = new PowensOpenBankingProvider({\n clientId: secrets.clientId,\n clientSecret: secrets.clientSecret,\n apiKey: secrets.apiKey,\n environment: connection.config.environment as PowensEnvironment,\n baseUrl: connection.config.baseUrl as string | undefined,\n });\n\n const preview = await provider.listAccounts({\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n userId: userUuid,\n });\n\n await connection.storePowensUser({\n tenantUserId: connection.meta.tenantUserId,\n powensUserUuid: userUuid,\n authCode: code,\n });\n\n await enqueueWorkflow('pfo.workflow.sync-openbanking-accounts', {\n tenantId: connection.meta.tenantId,\n userUuid,\n connectionId: connection.meta.id,\n previewAccounts: preview.accounts,\n });\n\n const redirectBase = process.env.APP_DASHBOARD_URL ?? '';\n return Response.redirect(\n `${redirectBase}/banking/linked?tenant=${connection.meta.tenantId}`,\n 302\n );\n}\n\ninterface ExamplePowensSecrets {\n clientId: string;\n clientSecret: string;\n apiKey?: string;\n}\n\ninterface ExampleIntegrationConnection {\n meta: {\n id: string;\n tenantId: string;\n tenantUserId: string;\n };\n config: {\n environment: PowensEnvironment;\n baseUrl?: string;\n };\n storePowensUser(input: {\n tenantUserId: string;\n powensUserUuid: string;\n authCode: string;\n }): Promise<void>;\n}\n\nasync function getConnectionByState(\n state: string\n): Promise<ExampleIntegrationConnection | null> {\n const record = fakeDatabase.connections.find((conn) => conn.state === state);\n return record ?? null;\n}\n\nasync function getPowensSecretsForConnection(\n connectionId: string\n): Promise<ExamplePowensSecrets> {\n const secret = fakeSecretStore[connectionId];\n if (!secret) throw new Error(`Missing Powens secrets for ${connectionId}`);\n return secret;\n}\n\nasync function enqueueWorkflow(name: string, input: Record<string, unknown>) {\n await fakeWorkflowQueue.enqueue({ name, input });\n}\n\nconst fakeDatabase = {\n connections: [] as (ExampleIntegrationConnection & { state: string })[],\n};\n\nconst fakeSecretStore: Record<string, ExamplePowensSecrets> = {};\n\nconst fakeWorkflowQueue = {\n enqueue: async (_payload: Record<string, unknown>) => {\n /* no-op */\n },\n};\n"],"mappings":";;;;;;;;;AASA,eAAsB,2BAA2B,KAAc;CAC7D,MAAM,MAAM,IAAI,IAAI,IAAI,IAAI;CAC5B,MAAM,OAAO,IAAI,aAAa,IAAI,OAAO;CACzC,MAAM,QAAQ,IAAI,aAAa,IAAI,QAAQ;CAC3C,MAAM,WAAW,IAAI,aAAa,IAAI,YAAY;AAElD,KAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SACtB,QAAO,IAAI,SAAS,+BAA+B,EAAE,QAAQ,KAAK,CAAC;CAGrE,MAAM,aAAa,MAAM,qBAAqB,MAAM;AACpD,KAAI,CAAC,WACH,QAAO,IAAI,SAAS,8BAA8B,EAAE,QAAQ,KAAK,CAAC;CAGpE,MAAM,UAAU,MAAM,8BAA8B,WAAW,KAAK,GAAG;CAUvE,MAAM,UAAU,MARC,IAAI,0BAA0B;EAC7C,UAAU,QAAQ;EAClB,cAAc,QAAQ;EACtB,QAAQ,QAAQ;EAChB,aAAa,WAAW,OAAO;EAC/B,SAAS,WAAW,OAAO;EAC5B,CAAC,CAE6B,aAAa;EAC1C,UAAU,WAAW,KAAK;EAC1B,cAAc,WAAW,KAAK;EAC9B,QAAQ;EACT,CAAC;AAEF,OAAM,WAAW,gBAAgB;EAC/B,cAAc,WAAW,KAAK;EAC9B,gBAAgB;EAChB,UAAU;EACX,CAAC;AAEF,OAAM,gBAAgB,0CAA0C;EAC9D,UAAU,WAAW,KAAK;EAC1B;EACA,cAAc,WAAW,KAAK;EAC9B,iBAAiB,QAAQ;EAC1B,CAAC;CAEF,MAAM,eAAe,QAAQ,IAAI,qBAAqB;AACtD,QAAO,SAAS,SACd,GAAG,aAAa,yBAAyB,WAAW,KAAK,YACzD,IACD;;AA0BH,eAAe,qBACb,OAC8C;AAE9C,QADe,aAAa,YAAY,MAAM,SAAS,KAAK,UAAU,MAAM,IAC3D;;AAGnB,eAAe,8BACb,cAC+B;CAC/B,MAAM,SAAS,gBAAgB;AAC/B,KAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,8BAA8B,eAAe;AAC1E,QAAO;;AAGT,eAAe,gBAAgB,MAAc,OAAgC;AAC3E,OAAM,kBAAkB,QAAQ;EAAE;EAAM;EAAO,CAAC;;AAGlD,MAAM,eAAe,EACnB,aAAa,EAAE,EAChB;AAED,MAAM,kBAAwD,EAAE;AAEhE,MAAM,oBAAoB,EACxB,SAAS,OAAO,aAAsC,IAGvD"}
@@ -1 +1 @@
1
- {"version":3,"file":"webhook-handler.js","names":["fakeSecretStore: Record<string, ExamplePowensSecrets>"],"sources":["../../src/handlers/webhook-handler.ts"],"sourcesContent":["/**\n * Example Powens webhook handler (fetch-compatible).\n *\n * Verifies signature, then enqueues the canonical workflows to keep the ledger\n * in sync. Unknown events are ignored (or can be recorded by the app layer).\n */\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { PowensOpenBankingProvider } from '@contractspec/integration.providers-impls/impls/powens-openbanking';\nimport type { PowensEnvironment } from '@contractspec/integration.providers-impls/impls/powens-client';\n\nexport async function powensWebhookHandler(req: Request) {\n const signature = req.headers.get('x-powens-signature');\n const stateHeader = req.headers.get('x-powens-state');\n const payload = await req.text();\n\n if (!signature || !stateHeader) {\n return new Response('Missing Powens signature headers', { status: 400 });\n }\n\n const connection = await getConnectionByState(stateHeader);\n if (!connection) {\n return new Response('Unknown Powens state header', { status: 404 });\n }\n\n const secrets = await getPowensSecretsForConnection(connection.meta.id);\n if (!verifySignature(payload, signature, secrets.webhookSecret)) {\n return new Response('Invalid Powens webhook signature', { status: 401 });\n }\n\n const event = JSON.parse(payload) as PowensWebhookEvent;\n const provider = new PowensOpenBankingProvider({\n clientId: secrets.clientId,\n clientSecret: secrets.clientSecret,\n apiKey: secrets.apiKey,\n environment: connection.config.environment as PowensEnvironment,\n baseUrl: connection.config.baseUrl as string | undefined,\n });\n\n switch (event.type) {\n case 'connection.updated':\n case 'user.sync.completed': {\n await enqueueWorkflow('pfo.workflow.sync-openbanking-accounts', {\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n userUuid: event.user_uuid,\n });\n break;\n }\n case 'transactions.created':\n case 'transactions.updated': {\n await enqueueWorkflow('pfo.workflow.sync-openbanking-transactions', {\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n userUuid: event.user_uuid,\n accountId: event.account_uuid,\n });\n break;\n }\n default:\n await logUnmappedEvent(event);\n }\n\n if (event.account_uuid) {\n await provider.getBalances({\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n accountId: event.account_uuid,\n });\n }\n\n return new Response('OK', { status: 200 });\n}\n\ninterface PowensWebhookEvent {\n type: string;\n user_uuid: string;\n connection_uuid: string;\n account_uuid?: string;\n}\n\ninterface ExamplePowensSecrets {\n clientId: string;\n clientSecret: string;\n apiKey?: string;\n webhookSecret: string;\n}\n\ninterface ExampleIntegrationConnection {\n meta: {\n id: string;\n tenantId: string;\n };\n config: {\n environment: PowensEnvironment;\n baseUrl?: string;\n };\n}\n\nfunction verifySignature(payload: string, signature: string, secret: string) {\n const digest = createHmac('sha256', secret).update(payload).digest('hex');\n const a = Buffer.from(digest, 'hex');\n const b = Buffer.from(signature, 'hex');\n return a.length === b.length && timingSafeEqual(a, b);\n}\n\nasync function getConnectionByState(\n state: string\n): Promise<ExampleIntegrationConnection | null> {\n return fakeDatabase.connections.find((conn) => conn.state === state) ?? null;\n}\n\nasync function getPowensSecretsForConnection(\n connectionId: string\n): Promise<ExamplePowensSecrets> {\n const secret = fakeSecretStore[connectionId];\n if (!secret) throw new Error(`Missing Powens secrets for ${connectionId}`);\n return secret;\n}\n\nasync function enqueueWorkflow(name: string, input: Record<string, unknown>) {\n await fakeWorkflowQueue.enqueue({ name, input });\n}\n\nasync function logUnmappedEvent(_event: PowensWebhookEvent) {\n await fakeTelemetryLogger.record({\n event: 'openbanking.webhook.unmapped',\n payload: 'redacted',\n });\n}\n\nconst fakeDatabase = {\n connections: [] as (ExampleIntegrationConnection & { state: string })[],\n};\n\nconst fakeSecretStore: Record<string, ExamplePowensSecrets> = {};\n\nconst fakeWorkflowQueue = {\n enqueue: async (_payload: Record<string, unknown>) => {\n /* no-op */\n },\n};\n\nconst fakeTelemetryLogger = {\n record: async (_payload: Record<string, unknown>) => {\n /* no-op */\n },\n};\n"],"mappings":";;;;;;;;;;AAUA,eAAsB,qBAAqB,KAAc;CACvD,MAAM,YAAY,IAAI,QAAQ,IAAI,qBAAqB;CACvD,MAAM,cAAc,IAAI,QAAQ,IAAI,iBAAiB;CACrD,MAAM,UAAU,MAAM,IAAI,MAAM;AAEhC,KAAI,CAAC,aAAa,CAAC,YACjB,QAAO,IAAI,SAAS,oCAAoC,EAAE,QAAQ,KAAK,CAAC;CAG1E,MAAM,aAAa,MAAM,qBAAqB,YAAY;AAC1D,KAAI,CAAC,WACH,QAAO,IAAI,SAAS,+BAA+B,EAAE,QAAQ,KAAK,CAAC;CAGrE,MAAM,UAAU,MAAM,8BAA8B,WAAW,KAAK,GAAG;AACvE,KAAI,CAAC,gBAAgB,SAAS,WAAW,QAAQ,cAAc,CAC7D,QAAO,IAAI,SAAS,oCAAoC,EAAE,QAAQ,KAAK,CAAC;CAG1E,MAAM,QAAQ,KAAK,MAAM,QAAQ;CACjC,MAAM,WAAW,IAAI,0BAA0B;EAC7C,UAAU,QAAQ;EAClB,cAAc,QAAQ;EACtB,QAAQ,QAAQ;EAChB,aAAa,WAAW,OAAO;EAC/B,SAAS,WAAW,OAAO;EAC5B,CAAC;AAEF,SAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;AACH,SAAM,gBAAgB,0CAA0C;IAC9D,UAAU,WAAW,KAAK;IAC1B,cAAc,WAAW,KAAK;IAC9B,UAAU,MAAM;IACjB,CAAC;AACF;EAEF,KAAK;EACL,KAAK;AACH,SAAM,gBAAgB,8CAA8C;IAClE,UAAU,WAAW,KAAK;IAC1B,cAAc,WAAW,KAAK;IAC9B,UAAU,MAAM;IAChB,WAAW,MAAM;IAClB,CAAC;AACF;EAEF,QACE,OAAM,iBAAiB,MAAM;;AAGjC,KAAI,MAAM,aACR,OAAM,SAAS,YAAY;EACzB,UAAU,WAAW,KAAK;EAC1B,cAAc,WAAW,KAAK;EAC9B,WAAW,MAAM;EAClB,CAAC;AAGJ,QAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC;;AA4B5C,SAAS,gBAAgB,SAAiB,WAAmB,QAAgB;CAC3E,MAAM,SAAS,WAAW,UAAU,OAAO,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM;CACzE,MAAM,IAAI,OAAO,KAAK,QAAQ,MAAM;CACpC,MAAM,IAAI,OAAO,KAAK,WAAW,MAAM;AACvC,QAAO,EAAE,WAAW,EAAE,UAAU,gBAAgB,GAAG,EAAE;;AAGvD,eAAe,qBACb,OAC8C;AAC9C,QAAO,aAAa,YAAY,MAAM,SAAS,KAAK,UAAU,MAAM,IAAI;;AAG1E,eAAe,8BACb,cAC+B;CAC/B,MAAM,SAAS,gBAAgB;AAC/B,KAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,8BAA8B,eAAe;AAC1E,QAAO;;AAGT,eAAe,gBAAgB,MAAc,OAAgC;AAC3E,OAAM,kBAAkB,QAAQ;EAAE;EAAM;EAAO,CAAC;;AAGlD,eAAe,iBAAiB,QAA4B;AAC1D,OAAM,oBAAoB,OAAO;EAC/B,OAAO;EACP,SAAS;EACV,CAAC;;AAGJ,MAAM,eAAe,EACnB,aAAa,EAAE,EAChB;AAED,MAAMA,kBAAwD,EAAE;AAEhE,MAAM,oBAAoB,EACxB,SAAS,OAAO,aAAsC,IAGvD;AAED,MAAM,sBAAsB,EAC1B,QAAQ,OAAO,aAAsC,IAGtD"}
1
+ {"version":3,"file":"webhook-handler.js","names":[],"sources":["../../src/handlers/webhook-handler.ts"],"sourcesContent":["/**\n * Example Powens webhook handler (fetch-compatible).\n *\n * Verifies signature, then enqueues the canonical workflows to keep the ledger\n * in sync. Unknown events are ignored (or can be recorded by the app layer).\n */\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { PowensOpenBankingProvider } from '@contractspec/integration.providers-impls/impls/powens-openbanking';\nimport type { PowensEnvironment } from '@contractspec/integration.providers-impls/impls/powens-client';\n\nexport async function powensWebhookHandler(req: Request) {\n const signature = req.headers.get('x-powens-signature');\n const stateHeader = req.headers.get('x-powens-state');\n const payload = await req.text();\n\n if (!signature || !stateHeader) {\n return new Response('Missing Powens signature headers', { status: 400 });\n }\n\n const connection = await getConnectionByState(stateHeader);\n if (!connection) {\n return new Response('Unknown Powens state header', { status: 404 });\n }\n\n const secrets = await getPowensSecretsForConnection(connection.meta.id);\n if (!verifySignature(payload, signature, secrets.webhookSecret)) {\n return new Response('Invalid Powens webhook signature', { status: 401 });\n }\n\n const event = JSON.parse(payload) as PowensWebhookEvent;\n const provider = new PowensOpenBankingProvider({\n clientId: secrets.clientId,\n clientSecret: secrets.clientSecret,\n apiKey: secrets.apiKey,\n environment: connection.config.environment as PowensEnvironment,\n baseUrl: connection.config.baseUrl as string | undefined,\n });\n\n switch (event.type) {\n case 'connection.updated':\n case 'user.sync.completed': {\n await enqueueWorkflow('pfo.workflow.sync-openbanking-accounts', {\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n userUuid: event.user_uuid,\n });\n break;\n }\n case 'transactions.created':\n case 'transactions.updated': {\n await enqueueWorkflow('pfo.workflow.sync-openbanking-transactions', {\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n userUuid: event.user_uuid,\n accountId: event.account_uuid,\n });\n break;\n }\n default:\n await logUnmappedEvent(event);\n }\n\n if (event.account_uuid) {\n await provider.getBalances({\n tenantId: connection.meta.tenantId,\n connectionId: connection.meta.id,\n accountId: event.account_uuid,\n });\n }\n\n return new Response('OK', { status: 200 });\n}\n\ninterface PowensWebhookEvent {\n type: string;\n user_uuid: string;\n connection_uuid: string;\n account_uuid?: string;\n}\n\ninterface ExamplePowensSecrets {\n clientId: string;\n clientSecret: string;\n apiKey?: string;\n webhookSecret: string;\n}\n\ninterface ExampleIntegrationConnection {\n meta: {\n id: string;\n tenantId: string;\n };\n config: {\n environment: PowensEnvironment;\n baseUrl?: string;\n };\n}\n\nfunction verifySignature(payload: string, signature: string, secret: string) {\n const digest = createHmac('sha256', secret).update(payload).digest('hex');\n const a = Buffer.from(digest, 'hex');\n const b = Buffer.from(signature, 'hex');\n return a.length === b.length && timingSafeEqual(a, b);\n}\n\nasync function getConnectionByState(\n state: string\n): Promise<ExampleIntegrationConnection | null> {\n return fakeDatabase.connections.find((conn) => conn.state === state) ?? null;\n}\n\nasync function getPowensSecretsForConnection(\n connectionId: string\n): Promise<ExamplePowensSecrets> {\n const secret = fakeSecretStore[connectionId];\n if (!secret) throw new Error(`Missing Powens secrets for ${connectionId}`);\n return secret;\n}\n\nasync function enqueueWorkflow(name: string, input: Record<string, unknown>) {\n await fakeWorkflowQueue.enqueue({ name, input });\n}\n\nasync function logUnmappedEvent(_event: PowensWebhookEvent) {\n await fakeTelemetryLogger.record({\n event: 'openbanking.webhook.unmapped',\n payload: 'redacted',\n });\n}\n\nconst fakeDatabase = {\n connections: [] as (ExampleIntegrationConnection & { state: string })[],\n};\n\nconst fakeSecretStore: Record<string, ExamplePowensSecrets> = {};\n\nconst fakeWorkflowQueue = {\n enqueue: async (_payload: Record<string, unknown>) => {\n /* no-op */\n },\n};\n\nconst fakeTelemetryLogger = {\n record: async (_payload: Record<string, unknown>) => {\n /* no-op */\n },\n};\n"],"mappings":";;;;;;;;;;AAUA,eAAsB,qBAAqB,KAAc;CACvD,MAAM,YAAY,IAAI,QAAQ,IAAI,qBAAqB;CACvD,MAAM,cAAc,IAAI,QAAQ,IAAI,iBAAiB;CACrD,MAAM,UAAU,MAAM,IAAI,MAAM;AAEhC,KAAI,CAAC,aAAa,CAAC,YACjB,QAAO,IAAI,SAAS,oCAAoC,EAAE,QAAQ,KAAK,CAAC;CAG1E,MAAM,aAAa,MAAM,qBAAqB,YAAY;AAC1D,KAAI,CAAC,WACH,QAAO,IAAI,SAAS,+BAA+B,EAAE,QAAQ,KAAK,CAAC;CAGrE,MAAM,UAAU,MAAM,8BAA8B,WAAW,KAAK,GAAG;AACvE,KAAI,CAAC,gBAAgB,SAAS,WAAW,QAAQ,cAAc,CAC7D,QAAO,IAAI,SAAS,oCAAoC,EAAE,QAAQ,KAAK,CAAC;CAG1E,MAAM,QAAQ,KAAK,MAAM,QAAQ;CACjC,MAAM,WAAW,IAAI,0BAA0B;EAC7C,UAAU,QAAQ;EAClB,cAAc,QAAQ;EACtB,QAAQ,QAAQ;EAChB,aAAa,WAAW,OAAO;EAC/B,SAAS,WAAW,OAAO;EAC5B,CAAC;AAEF,SAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;AACH,SAAM,gBAAgB,0CAA0C;IAC9D,UAAU,WAAW,KAAK;IAC1B,cAAc,WAAW,KAAK;IAC9B,UAAU,MAAM;IACjB,CAAC;AACF;EAEF,KAAK;EACL,KAAK;AACH,SAAM,gBAAgB,8CAA8C;IAClE,UAAU,WAAW,KAAK;IAC1B,cAAc,WAAW,KAAK;IAC9B,UAAU,MAAM;IAChB,WAAW,MAAM;IAClB,CAAC;AACF;EAEF,QACE,OAAM,iBAAiB,MAAM;;AAGjC,KAAI,MAAM,aACR,OAAM,SAAS,YAAY;EACzB,UAAU,WAAW,KAAK;EAC1B,cAAc,WAAW,KAAK;EAC9B,WAAW,MAAM;EAClB,CAAC;AAGJ,QAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC;;AA4B5C,SAAS,gBAAgB,SAAiB,WAAmB,QAAgB;CAC3E,MAAM,SAAS,WAAW,UAAU,OAAO,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM;CACzE,MAAM,IAAI,OAAO,KAAK,QAAQ,MAAM;CACpC,MAAM,IAAI,OAAO,KAAK,WAAW,MAAM;AACvC,QAAO,EAAE,WAAW,EAAE,UAAU,gBAAgB,GAAG,EAAE;;AAGvD,eAAe,qBACb,OAC8C;AAC9C,QAAO,aAAa,YAAY,MAAM,SAAS,KAAK,UAAU,MAAM,IAAI;;AAG1E,eAAe,8BACb,cAC+B;CAC/B,MAAM,SAAS,gBAAgB;AAC/B,KAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,8BAA8B,eAAe;AAC1E,QAAO;;AAGT,eAAe,gBAAgB,MAAc,OAAgC;AAC3E,OAAM,kBAAkB,QAAQ;EAAE;EAAM;EAAO,CAAC;;AAGlD,eAAe,iBAAiB,QAA4B;AAC1D,OAAM,oBAAoB,OAAO;EAC/B,OAAO;EACP,SAAS;EACV,CAAC;;AAGJ,MAAM,eAAe,EACnB,aAAa,EAAE,EAChB;AAED,MAAM,kBAAwD,EAAE;AAEhE,MAAM,oBAAoB,EACxB,SAAS,OAAO,aAAsC,IAGvD;AAED,MAAM,sBAAsB,EAC1B,QAAQ,OAAO,aAAsC,IAGtD"}
package/package.json CHANGED
@@ -1,9 +1,8 @@
1
1
  {
2
2
  "name": "@contractspec/example.openbanking-powens",
3
- "version": "1.46.1",
3
+ "version": "1.48.0",
4
4
  "description": "OpenBanking Powens example: OAuth callback + webhook handler patterns (provider + workflows).",
5
5
  "type": "module",
6
- "main": "./dist/index.js",
7
6
  "types": "./dist/index.d.ts",
8
7
  "exports": {
9
8
  ".": "./dist/index.js",
@@ -28,13 +27,13 @@
28
27
  "test": "bun test"
29
28
  },
30
29
  "dependencies": {
31
- "@contractspec/integration.providers-impls": "1.46.1",
32
- "@contractspec/lib.contracts": "1.46.1"
30
+ "@contractspec/integration.providers-impls": "1.48.0",
31
+ "@contractspec/lib.contracts": "1.48.0"
33
32
  },
34
33
  "devDependencies": {
35
- "@contractspec/tool.tsdown": "1.46.1",
36
- "@contractspec/tool.typescript": "1.46.1",
37
- "tsdown": "^0.18.3",
34
+ "@contractspec/tool.tsdown": "1.48.0",
35
+ "@contractspec/tool.typescript": "1.48.0",
36
+ "tsdown": "^0.19.0",
38
37
  "typescript": "^5.9.3"
39
38
  },
40
39
  "publishConfig": {
@@ -50,7 +49,6 @@
50
49
  },
51
50
  "registry": "https://registry.npmjs.org/"
52
51
  },
53
- "module": "./dist/index.js",
54
52
  "license": "MIT",
55
53
  "repository": {
56
54
  "type": "git",
package/src/example.ts CHANGED
@@ -1,6 +1,6 @@
1
- import type { ExampleSpec } from '@contractspec/lib.contracts';
1
+ import { defineExample } from '@contractspec/lib.contracts';
2
2
 
3
- const example: ExampleSpec = {
3
+ const example = defineExample({
4
4
  meta: {
5
5
  key: 'openbanking-powens',
6
6
  version: '1.0.0',
@@ -27,6 +27,6 @@ const example: ExampleSpec = {
27
27
  studio: { enabled: true, installable: true },
28
28
  mcp: { enabled: true },
29
29
  },
30
- };
30
+ });
31
31
 
32
32
  export default example;