@flink-app/oauth-plugin 0.13.1 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @flink-app/oauth-plugin
 
+## 1.0.0
+
+### Minor Changes
+
+-   Align minor version, from now all packages in monorepo will have same version
+
+### Patch Changes
+
+-   ee21c29: Normalize query parameters to predictable string types
+
+    Query parameters are now automatically normalized to `string | string[]` types before reaching handlers:
+
+    -   Single values: converted to strings (e.g., `?page=1` → `{ page: "1" }`)
+    -   Repeated parameters: converted to string arrays (e.g., `?tag=a&tag=b` → `{ tag: ["a", "b"] }`)
+    -   All types (numbers, booleans, etc.) from Express parser are converted to strings
+
+    **Breaking Change (Minor):**
+
+    -   `Query` type changed from `{ [x: string]: string | string[] | undefined }` to `Record<string, string | string[]>`
+    -   `Params` type changed from `Request["params"]` to explicit `Record<string, string>`
+    -   Removed `undefined` from query/param types since normalization ensures values are never undefined
+    -   Updated OAuth and OIDC plugin query type definitions to satisfy new Query constraint
+
+    This ensures predictable query and path parameter handling regardless of Express parser configuration. Handlers can reliably parse string values as needed using `Number()`, `parseInt()`, boolean comparisons, etc.
+
+## 0.14.1
+
+### Patch Changes
+
+-   fix: restore compatibility between core framework and plugins after 0.14.0 release
+
 ## 0.13.1
 
 ### Patch Changes

package/dist/schemas/CallbackRequest.d.ts

@@ -1,15 +1,18 @@
 /**
  * Query parameters for OAuth callback request
+ *
+ * Note: All query parameters are normalized to strings or string arrays by Flink.
+ * Providers may send additional query parameters beyond those listed here.
  */
-export default interface CallbackRequest {
+type CallbackRequest = Record<string, string | string[]> & {
     /**
      * Authorization code from OAuth provider
      */
-    code: string;
+    code?: string;
     /**
      * CSRF protection state parameter
      */
-    state: string;
+    state?: string;
     /**
      * Optional error from OAuth provider
      * Common values: access_denied, invalid_request, unauthorized_client, etc.
@@ -26,7 +29,7 @@ export default interface CallbackRequest {
     /**
      * Response type - 'json' returns JSON instead of redirect
      */
-    response_type?: "json";
+    response_type?: "json" | string;
     /**
      * Granted scopes (provider-specific)
      * May be sent by GitHub, Google, and other providers
@@ -49,5 +52,5 @@ export default interface CallbackRequest {
      * Session state or other provider-specific parameters
      */
     session_state?: string;
-    [key: string]: string | undefined;
-}
+};
+export default CallbackRequest;

package/dist/schemas/InitiateRequest.d.ts

@@ -1,10 +1,12 @@
 /**
  * Query parameters for OAuth initiate request
+ *
+ * Note: All query parameters are normalized to strings or string arrays by Flink.
  */
-export default interface InitiateRequest {
+type InitiateRequest = Record<string, string | string[]> & {
     /**
      * Optional redirect URI to return to after OAuth flow completes
      */
     redirectUri?: string;
-    [key: string]: string | undefined;
-}
+};
+export default InitiateRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flink-app/oauth-plugin",
-  "version": "0.13.1",
+  "version": "1.0.0",
   "description": "Flink plugin for OAuth 2.0 authentication with GitHub and Google providers",
   "author": "joel@frost.se",
   "license": "MIT",
@@ -19,9 +19,9 @@
     "jwt-simple": "^0.5.6",
     "ts-node": "^10.9.2",
     "tsc-watch": "^4.2.9",
-    "@flink-app/flink": "0.13.1",
-    "@flink-app/test-utils": "0.13.1",
-    "@flink-app/jwt-auth-plugin": "0.13.1"
+    "@flink-app/flink": "1.0.0",
+    "@flink-app/jwt-auth-plugin": "1.0.0",
+    "@flink-app/test-utils": "1.0.0"
   },
   "gitHead": "4243e3b3cd6d4e1ca001a61baa8436bf2bbe4113",
   "scripts": {

package/src/schemas/CallbackRequest.ts

@@ -1,16 +1,19 @@
 /**
  * Query parameters for OAuth callback request
+ *
+ * Note: All query parameters are normalized to strings or string arrays by Flink.
+ * Providers may send additional query parameters beyond those listed here.
  */
-export default interface CallbackRequest {
+type CallbackRequest = Record<string, string | string[]> & {
     /**
      * Authorization code from OAuth provider
      */
-    code: string;
+    code?: string;
 
     /**
      * CSRF protection state parameter
      */
-    state: string;
+    state?: string;
 
     /**
      * Optional error from OAuth provider
@@ -31,7 +34,7 @@ export default interface CallbackRequest {
     /**
      * Response type - 'json' returns JSON instead of redirect
      */
-    response_type?: "json";
+    response_type?: "json" | string;
 
     /**
      * Granted scopes (provider-specific)
@@ -59,6 +62,6 @@ export default interface CallbackRequest {
      * Session state or other provider-specific parameters
      */
     session_state?: string;
+};
 
-    [key: string]: string | undefined;
-}
+export default CallbackRequest;

package/src/schemas/InitiateRequest.ts

@@ -1,10 +1,13 @@
 /**
  * Query parameters for OAuth initiate request
+ *
+ * Note: All query parameters are normalized to strings or string arrays by Flink.
  */
-export default interface InitiateRequest {
+type InitiateRequest = Record<string, string | string[]> & {
     /**
      * Optional redirect URI to return to after OAuth flow completes
      */
     redirectUri?: string;
-    [key: string]: string | undefined;
-}
+};
+
+export default InitiateRequest;