@ogcio/building-blocks-sdk 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,142 @@
+# Building Blocks SDK - README
+
+## Overview
+
+The Building Blocks SDK is the `TypeScript` client for integrating with the various building blocks within the OGCIO ecosystem. It helps developers interact different modules in a streamlined way, providing a unified API for seamless integration.
+
+## Features
+
+- Proxy Client: Acts as a middleware to interact with various services via the SDK.
+- Modular Design: Allows integration of different components (building blocks) to extend functionality as needed.
+- Enables both authenticated and non-authenticated usage
+
+### Usage
+
+Install the package via:
+
+```bash
+npm install @ogcio/building-blocks-sdk
+```
+
+SDK initialization:
+
+```typescript
+const sdk = getBuildingBlockSDK({
+  services: {
+    upload: {
+      baseUrl: "http://localhost:8008",
+    },
+  },
+});
+```
+
+This snippet creates the SDK with configuration for the upload API building block. The SDK accepts a configuration for each building block API.
+
+At the present time available building blocks are:
+
+- payments
+- messaging
+- upload
+- profile
+- scheduler
+
+### Authentication
+
+Access to building-blocks api is granted through access token in the `Authorization` header.
+
+Users can pass the `getTokenFn` function to the SDK. The SDK client will call this function when it needs an access token. The SDK will provide the service name of the service for which it is requesting the token:
+
+```typescript
+const sdk = getBuildingBlockSDK({
+  services: {
+    upload: {
+      baseUrl: "http://localhost:8008",
+    },
+  },
+  getTokenFn: async (serviceName: SERVICE_NAME) => {
+    if (serviceName === UPLOAD) {
+      return "TOKEN_FOR_UPLOAD";
+    }
+  },
+});
+```
+
+This approach allows users of this library to plug-in their preferred authentication mechanism as long as a string is returned by the `getTokenFn`.
+
+### M2M Authentication
+
+In order to use the library in your server applications you can install the peer dependency `@logto/node` via:
+
+```bash
+npm i @logto/node
+```
+
+and use the `getM2MTokenFn` utility function. This function accepts the M2M configuration parameters for each of the building-blocks api and returns a `getTokenFn` compliant function that will handle Logto m2m retrieval for you:
+
+```typescript
+const sdk = getBuildingBlockSDK({
+  services: {
+    upload: {
+      baseUrl: "http://localhost:8008",
+    },
+  },
+  getTokenFn: await getM2MTokenFn({
+    services: {
+      upload: {
+        getOrganizationTokenParams: {
+          applicationId: "APPLICATION_ID",
+          applicationSecret: "APPLICATION_SECRET",
+          logtoOidcEndpoint: "http://localhost:3301/oidc",
+          organizationId: "ogcio",
+        },
+      },
+    },
+  }),
+});
+```
+
+Using the m2m utility function like this will cause the SDK to request all the scopes available for the building-block, scopes can be overridden when passed as parameter:
+
+```typescript
+const sdk = getBuildingBlockSDK({
+  services: {
+    upload: {
+      baseUrl: "http://localhost:8008",
+    },
+  },
+  getTokenFn: await getM2MTokenFn({
+    services: {
+      upload: {
+        getOrganizationTokenParams: {
+          applicationId: "APPLICATION_ID",
+          applicationSecret: "APPLICATION_SECRET",
+          logtoOidcEndpoint: "http://localhost:3301/oidc",
+          organizationId: "ogcio",
+          scopes: ["custom:role:1", "custom:role:2"],
+        },
+      },
+    },
+  }),
+});
+```
+
+## Development
+
+This project is built with the latest Node LTS, clone this repository and install the dependencies with:
+
+```bash
+npm install
+```
+
+The code is formatted and linted with [biome](https://biomejs.dev/).
+
+The clients schemas are auto generated using open `openapi-typescript`.
+
+you can update the json configuration clients for each client under: `src/clients-configuration/clients-configuration.json`,
+then run:
+
+```bash
+npm run clients:update
+```
+
+to update the schemas. At this point you are ready to modify clients files and use the newly generated schemas

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogcio/building-blocks-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -30,7 +30,7 @@
     "typescript": "^5.6.3"
   },
   "peerDependencies": {
-    "@logto/node": "^2.5.8"
+    "@logto/node": "2.5.5"
   },
   "peerDependenciesMeta": {
     "@logto/node": {

package/src/client/auth/index.ts

@@ -68,9 +68,9 @@ const getOrganizationToken = async (
   const tokenResponse = await fetchToken({
     ...params,
     scopes: [
-      ...scopesToUse,
       UserScope.OrganizationRoles,
       UserScope.Organizations,
+      ...scopesToUse,
     ],
     specificBodyFields: {
       organization_id: params.organizationId,

package/src/clients-configurations/clients-configuration.json

@@ -11,8 +11,6 @@
         "messaging:citizen.self:write"
       ],
       "publicServantPermissions": [
-        "urn:logto:scope:organizations",
-        "urn:logto:scope:organization_roles",
         "messaging:message:*",
         "messaging:provider:*",
         "messaging:template:*",
@@ -26,12 +24,7 @@
       "openApiDefinitionUrl": "https://raw.githubusercontent.com/ogcio/life-events/refs/heads/dev/apps/upload-api/openapi-definition.yml",
       "openApiDefinitionFormat": "yaml",
       "citizenPermissions": ["upload:file.self:write", "upload:file.self:read"],
-      "publicServantPermissions": [
-        "urn:logto:scope:organizations",
-        "urn:logto:scope:organization_roles",
-        "upload:file:*",
-        "profile:user:read"
-      ],
+      "publicServantPermissions": ["upload:file:*", "profile:user:read"],
       "updateDefinitions": true
     },
     {
@@ -45,8 +38,6 @@
         "payments:provider.public:read"
       ],
       "publicServantPermissions": [
-        "urn:logto:scope:organizations",
-        "urn:logto:scope:organization_roles",
         "payments:provider:*",
         "payments:payment_request:*",
         "payments:payment_request.public:read",
@@ -59,11 +50,7 @@
       "openApiDefinitionUrl": "https://raw.githubusercontent.com/ogcio/life-events/refs/heads/dev/apps/scheduler-api/openapi-definition.yml",
       "openApiDefinitionFormat": "yaml",
       "citizenPermissions": ["scheduler:jobs:write"],
-      "publicServantPermissions": [
-        "urn:logto:scope:organizations",
-        "urn:logto:scope:organization_roles",
-        "scheduler:jobs:write"
-      ],
+      "publicServantPermissions": ["scheduler:jobs:write"],
       "updateDefinitions": true
     },
     {
@@ -80,8 +67,6 @@
         "profile:user:read"
       ],
       "publicServantPermissions": [
-        "urn:logto:scope:organizations",
-        "urn:logto:scope:organization_roles",
         "profile:user:*",
         "profile:address:*",
         "profile:entitlement:*"