@feasibleone/blong-openapi 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.2.1](https://github.com/feasibleone/blong/compare/blong-openapi-v1.2.0...blong-openapi-v1.2.1) (2026-09-10)
+
+
+### Bug Fixes
+
+* split core to folders ([3900de8](https://github.com/feasibleone/blong/commit/3900de88defe8a3e9c492c5cf9388ac4ee81d781))
+
 ## [1.2.0](https://github.com/feasibleone/blong/compare/blong-openapi-v1.1.4...blong-openapi-v1.2.0) (2026-05-19)
 
 

package/README.md

@@ -13,15 +13,13 @@ OpenAPI/Swagger integration for the Blong framework
 
 ## Overview
 
-`@feasibleone/blong-openapi` provides seamless integration with external REST
-APIs using OpenAPI 2.0/3.0 (Swagger) definitions. It automatically generates
-type-safe handlers from API specifications, enabling you to call external
-services without writing manual HTTP request code.
+`@feasibleone/blong-openapi` provides seamless integration with external REST APIs using OpenAPI
+2.0/3.0 (Swagger) definitions. It automatically generates type-safe handlers from API
+specifications, enabling you to call external services without writing manual HTTP request code.
 
 ## Features
 
-- **Automatic Handler Generation**: Parse OpenAPI/Swagger definitions and
-  generate callable handlers
+- **Automatic Handler Generation**: Parse OpenAPI/Swagger definitions and generate callable handlers
 - **Type-Safe Integration**: Use `operationId` from API specs as handler names
 - **Multiple API Support**: Configure multiple API namespaces in a single orchestrator
 - **URL & File Support**: Load specifications from local files or remote URLs
@@ -99,13 +97,13 @@ const result = await this.bus.weatherGetCurrentWeather({
 
 ```yaml
 openapi:
-  logLevel: info                    # Log level for the orchestrator
-  namespace: ['api']                # Namespace prefix for calling handlers
-  api:
-    namespace:
-      weather:                      # API namespace identifier
-        - ./api/weather.yaml        # OpenAPI/Swagger definition (local)
-        - https://api.example.com/swagger.json  # or remote URL
+    logLevel: info # Log level for the orchestrator
+    namespace: ['api'] # Namespace prefix for calling handlers
+    api:
+        namespace:
+            weather: # API namespace identifier
+                - ./api/weather.yaml # OpenAPI/Swagger definition (local)
+                - https://api.example.com/swagger.json # or remote URL
 ```
 
 ### Advanced Configuration
@@ -114,22 +112,22 @@ Configure multiple APIs with custom settings:
 
 ```yaml
 openapi:
-  api:
-    namespace:
-      # External API with custom server override
-      payment:
-        - https://payment-api.example.com/openapi.json
-        - host: 'api.production.com'
-          basePath: '/v2'
-          x-blong:
-            destination: 'paymentService'
-            namespace: 'payment'
-
-      # Kubernetes API integration
-      k8s:
-        - https://kubernetes.io/api/v1/swagger.json
-        - servers:
-            - url: 'https://k8s-cluster:6443'
+    api:
+        namespace:
+            # External API with custom server override
+            payment:
+                - https://payment-api.example.com/openapi.json
+                - host: 'api.production.com'
+                  basePath: '/v2'
+                  x-blong:
+                      destination: 'paymentService'
+                      namespace: 'payment'
+
+            # Kubernetes API integration
+            k8s:
+                - https://kubernetes.io/api/v1/swagger.json
+                - servers:
+                      - url: 'https://k8s-cluster:6443'
 ```
 
 ### Multiple Definition Files
@@ -138,12 +136,12 @@ Split large API definitions across multiple files:
 
 ```yaml
 api:
-  namespace:
-    time:
-      - ./api/world-time.yaml              # Base OpenAPI definition
-      - ./api/world-time.operations.yaml   # Additional operationId mappings
-      - servers:
-          - url: 'http://worldtimeapi.org'
+    namespace:
+        time:
+            - ./api/world-time.yaml # Base OpenAPI definition
+            - ./api/world-time.operations.yaml # Additional operationId mappings
+            - servers:
+                  - url: 'http://worldtimeapi.org'
 ```
 
 ## Usage Patterns
@@ -184,9 +182,9 @@ Deploy as standalone microservice:
 
 ```yaml
 microservice:
-  orchestrator: true      # Enable orchestrator mode
-  gateway:
-    port: 8081           # Expose on port 8081
+    orchestrator: true # Enable orchestrator mode
+    gateway:
+        port: 8081 # Expose on port 8081
 ```
 
 ### Custom Operation IDs
@@ -196,10 +194,10 @@ If API doesn't define `operationId`, create mapping file:
 ```yaml
 # weather-operations.yaml
 paths:
-  /weather/current:
-    get:
-      operationId: getCurrentWeather
-      x-blong-method: weatherCurrent    # Alternative method name
+    /weather/current:
+        get:
+            operationId: getCurrentWeather
+            x-blong-method: weatherCurrent # Alternative method name
 ```
 
 ## Handler Naming Convention
@@ -208,11 +206,11 @@ Generated handlers follow the pattern: `{namespace}{operationId}`
 
 **Examples:**
 
-| Namespace | operationId | Handler Name |
-| ----------- | ------------- | -------------- |
-| weather | GetForecast | `weatherGetForecast` |
-| payment | CreateTransaction | `paymentCreateTransaction` |
-| k8s | listNamespaces | `k8sListNamespaces` |
+| Namespace | operationId       | Handler Name               |
+| --------- | ----------------- | -------------------------- |
+| weather   | GetForecast       | `weatherGetForecast`       |
+| payment   | CreateTransaction | `paymentCreateTransaction` |
+| k8s       | listNamespaces    | `k8sListNamespaces`        |
 
 Names are case-sensitive and trimmed of whitespace.
 
@@ -237,21 +235,19 @@ Configure incoming webhooks with OpenAPI definitions:
 
 ```yaml
 webhook:
-  imports: ['codec.openapi']
-  'codec.openapi':
-    namespace:
-      github:
-        - ./api/github-webhooks.yaml
+    imports: ['codec.openapi']
+    'codec.openapi':
+        namespace:
+            github:
+                - ./api/github-webhooks.yaml
 ```
 
 ## Related Packages
 
-- **[@feasibleone/blong](https://www.npmjs.com/package/@feasibleone/blong)** -
-  Core framework
-- **[@feasibleone/blong-gogo](https://www.npmjs.com/package/@feasibleone/blong-gogo)** -
-  Contains base `orchestrator.openapi` and `codec.openapi`
-- **[openapi-types](https://www.npmjs.com/package/openapi-types)** - TypeScript
-  types for OpenAPI
+- **[@feasibleone/blong](https://www.npmjs.com/package/@feasibleone/blong)** - Core framework
+- **[@feasibleone/blong-gogo](https://www.npmjs.com/package/@feasibleone/blong-gogo)** - Contains
+  base `orchestrator.openapi` and `codec.openapi`
+- **[openapi-types](https://www.npmjs.com/package/openapi-types)** - TypeScript types for OpenAPI
 
 ## Documentation
 
@@ -262,5 +258,5 @@ webhook:
 
 ## Example Projects
 
-See the [test/api](../../core/test/api/) folder for working examples with
-world-time API integration.
+See the [test/api](../../test/framework/demo/api/) folder for working examples with world-time API
+integration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong-openapi",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "repository": {
     "url": "git+https://github.com/feasibleone/blong.git"
   },
@@ -22,8 +22,8 @@
     "@rushstack/heft": "^1.2.6",
     "@rushstack/heft-lint-plugin": "^1.2.6",
     "@rushstack/heft-typescript-plugin": "^1.3.1",
-    "typescript": "^5.9.3",
-    "@feasibleone/blong-dev": "1.0.0"
+    "typescript": "^6.0.3",
+    "@feasibleone/blong-dev": "1.2.2"
   },
   "scripts": {
     "build": "heft build --clean",

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-type Load = (...params: unknown[]) => Promise<{
-    start: () => Promise<unknown>;
-}>;
-declare const _default: (load: Load) => Promise<void>;
-export default _default;
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAaA,KAAK,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAC,CAAC,CAAC;yBASzD,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;AAAhD,wBAeO"}

package/dist/index.js

@@ -1,34 +0,0 @@
-import { server } from '@feasibleone/blong';
-const openapiServer = server(blong => ({
-    url: import.meta.url,
-    validation: blong.type.Object({
-        openapi: blong.type.Object({}),
-    }),
-    children: ['../blong-openapi'],
-    config: {
-        default: {},
-    },
-}));
-const openapi = async (load, config) => {
-    const platforms = await Promise.all([
-        load(openapiServer, 'impl', config, ['microservice', 'integration', 'dev']),
-    ]);
-    for (const platform of platforms)
-        await platform.start();
-};
-export default async (load) => openapi(load, {
-    'blong-openapi': {
-        openapi: {
-            api: {
-                namespace: {
-                    time: [
-                        '../test/api/world-time.yaml',
-                        '../test/api/world-time.operations.yaml',
-                        // {servers: [{url: 'http://localhost:8081'}]},
-                    ],
-                },
-            },
-        },
-    },
-});
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;IACpB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE,CAAC,kBAAkB,CAAC;IAC9B,MAAM,EAAE;QACJ,OAAO,EAAE,EAAE;KACd;CACJ,CAAC,CAAC,CAAC;AAIJ,MAAM,OAAO,GAAG,KAAK,EAAE,IAAU,EAAE,MAAe,EAAiB,EAAE;IACjE,MAAM,SAAS,GAAuC,MAAM,OAAO,CAAC,GAAG,CAAC;QACpE,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;KAC9E,CAAC,CAAC;IACH,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC7D,CAAC,CAAC;AAEF,eAAe,KAAK,EAAE,IAAU,EAAiB,EAAE,CAC/C,OAAO,CAAC,IAAI,EAAE;IACV,eAAe,EAAE;QACb,OAAO,EAAE;YACL,GAAG,EAAE;gBACD,SAAS,EAAE;oBACP,IAAI,EAAE;wBACF,6BAA6B;wBAC7B,wCAAwC;wBACxC,+CAA+C;qBAClD;iBACJ;aACJ;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/dist/orchestrator/openapi.d.ts

@@ -1,7 +0,0 @@
-declare const _default: import("@feasibleone/blong").IAdapterFactory<{
-    logLevel: "info";
-}, import("@feasibleone/blong").AdapterContext> & {
-    [x: symbol]: "orchestrator";
-};
-export default _default;
-//# sourceMappingURL=openapi.d.ts.map

package/dist/orchestrator/openapi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../orchestrator/openapi.ts"],"names":[],"mappings":";;;;;AAEA,wBAOI"}

package/dist/orchestrator/openapi.js

@@ -1,10 +0,0 @@
-import { orchestrator } from '@feasibleone/blong';
-export default orchestrator(() => ({
-    extends: 'orchestrator.openapi',
-    activation: {
-        default: {
-            logLevel: 'info',
-        },
-    },
-}));
-//# sourceMappingURL=openapi.js.map

package/dist/orchestrator/openapi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../orchestrator/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEhD,eAAe,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,sBAAsB;IAC/B,UAAU,EAAE;QACR,OAAO,EAAE;YACL,QAAQ,EAAE,MAAM;SACnB;KACJ;CACJ,CAAC,CAAC,CAAC"}

package/dist/package.json

@@ -1,33 +0,0 @@
-{
-    "name": "@feasibleone/blong-openapi",
-    "version": "1.2.0",
-    "repository": {
-        "url": "git+https://github.com/feasibleone/blong.git"
-    },
-    "type": "module",
-    "exports": {
-        "./server.js": "./dist/server.js",
-        "./server.d.ts": "./dist/server.d.ts",
-        "./server.ts": "./server.ts",
-        "./browser.js": "./dist/browser.js",
-        "./browser.d.ts": "./dist/browser.d.ts",
-        "./browser.ts": "./browser.ts",
-        "./dist/package.json": "./package.json",
-        "./package.json": "./package.json"
-    },
-    "scripts": {
-        "build": "heft build --clean",
-        "ci-lint": "blong-dev lint",
-        "ci-publish": "node ../../common/scripts/install-run-rush-pnpm.js publish --access public --provenance"
-    },
-    "dependencies": {
-        "@feasibleone/blong": "workspace:^1.0.0"
-    },
-    "devDependencies": {
-        "@feasibleone/blong-dev": "workspace:*",
-        "@rushstack/heft": "^1.2.6",
-        "@rushstack/heft-lint-plugin": "^1.2.6",
-        "@rushstack/heft-typescript-plugin": "^1.3.1",
-        "typescript": "^5.9.3"
-    }
-}

package/dist/server.d.ts

@@ -1,7 +0,0 @@
-declare const _default: import("@feasibleone/blong").SolutionFactory<import("typebox").TObject<{
-    openapi: import("typebox").TObject<{}>;
-}>> & {
-    [x: symbol]: "solution";
-};
-export default _default;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":";;;;;AAEA,wBAiBI"}

package/dist/server.js

@@ -1,20 +0,0 @@
-import { realm } from '@feasibleone/blong';
-export default realm(blong => ({
-    url: import.meta.url,
-    validation: blong.type.Object({
-        openapi: blong.type.Object({}),
-    }),
-    children: ['./orchestrator'],
-    config: {
-        default: {},
-        dev: {},
-        microservice: {
-            orchestrator: true,
-            gateway: {
-                port: 8081,
-            },
-        },
-        integration: {},
-    },
-}));
-//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AAEzC,eAAe,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;IACpB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE,CAAC,gBAAgB,CAAC;IAC5B,MAAM,EAAE;QACJ,OAAO,EAAE,EAAE;QACX,GAAG,EAAE,EAAE;QACP,YAAY,EAAE;YACV,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE;gBACL,IAAI,EAAE,IAAI;aACb;SACJ;QACD,WAAW,EAAE,EAAE;KAClB;CACJ,CAAC,CAAC,CAAC"}