@codefox-inc/oauth-provider 0.2.0

package/dist/component/handlers.d.ts

@@ -0,0 +1,143 @@
+import type { ActionCtx } from "./_generated/server";
+import type { OAuthConfig, UserProfile } from "../lib/oauth.js";
+import type { RunQueryCtx, RunMutationCtx } from "../lib/convex-types.js";
+/**
+ * Component API references (passed from SDK)
+ *
+ * Note: Uses RunQueryCtx/RunMutationCtx as the base context types.
+ * ActionCtx extends these types, so handlers can pass ActionCtx to these functions.
+ */
+export interface OAuthComponentAPI {
+    queries: {
+        getClient: (ctx: RunQueryCtx, args: {
+            clientId: string;
+        }) => Promise<{
+            clientId: string;
+            type: "confidential" | "public";
+            redirectUris: string[];
+            allowedScopes: string[];
+        } | null>;
+        getRefreshToken: (ctx: RunQueryCtx, args: {
+            refreshToken: string;
+        }) => Promise<{
+            refreshToken?: string;
+            clientId: string;
+            userId: string;
+            scopes: string[];
+            refreshTokenExpiresAt?: number;
+        } | null>;
+        getTokensByUser: (ctx: RunQueryCtx, args: {
+            userId: string;
+        }) => Promise<Array<{
+            _id: string;
+            clientId: string;
+            userId: string;
+            scopes: string[];
+            accessTokenExpiresAt: number;
+            refreshTokenExpiresAt?: number;
+        }>>;
+    };
+    mutations: {
+        issueAuthorizationCode: (ctx: RunMutationCtx, args: {
+            clientId: string;
+            userId: string;
+            scopes: string[];
+            redirectUri: string;
+            codeChallenge: string;
+            codeChallengeMethod: string;
+            nonce?: string;
+        }) => Promise<string>;
+        consumeAuthCode: (ctx: RunMutationCtx, args: {
+            code: string;
+            clientId: string;
+            redirectUri?: string;
+            codeVerifier: string;
+        }) => Promise<{
+            userId: string;
+            scopes: string[];
+            codeChallenge: string;
+            codeChallengeMethod: string;
+            redirectUri: string;
+            nonce?: string;
+            codeHash: string;
+        }>;
+        saveTokens: (ctx: RunMutationCtx, args: {
+            accessToken: string;
+            refreshToken?: string;
+            clientId: string;
+            userId: string;
+            scopes: string[];
+            expiresAt: number;
+            refreshTokenExpiresAt?: number;
+            authorizationCode?: string;
+        }) => Promise<void>;
+        rotateRefreshToken: (ctx: RunMutationCtx, args: {
+            oldRefreshToken: string;
+            accessToken: string;
+            refreshToken: string;
+            clientId: string;
+            userId: string;
+            scopes: string[];
+            expiresAt: number;
+            refreshTokenExpiresAt: number;
+        }) => Promise<void>;
+        upsertAuthorization: (ctx: RunMutationCtx, args: {
+            userId: string;
+            clientId: string;
+            scopes: string[];
+        }) => Promise<string>;
+        updateAuthorizationLastUsed: (ctx: RunMutationCtx, args: {
+            userId: string;
+            clientId: string;
+        }) => Promise<void>;
+    };
+    clientManagement: {
+        registerClient: (ctx: RunMutationCtx, args: {
+            name: string;
+            redirectUris: string[];
+            scopes: string[];
+            type: "confidential" | "public";
+            website?: string;
+            logoUrl?: string;
+            tosUrl?: string;
+            policyUrl?: string;
+        }) => Promise<{
+            clientId: string;
+            clientSecret?: string;
+            clientIdIssuedAt: number;
+        }>;
+        verifyClientSecret: (ctx: RunMutationCtx, args: {
+            clientId: string;
+            clientSecret: string;
+        }) => Promise<boolean>;
+    };
+}
+/**
+ * Authorization Endpoint
+ */
+export declare function authorizeHandler(ctx: ActionCtx, request: Request, config: OAuthConfig, api: OAuthComponentAPI): Promise<Response>;
+/**
+ * OpenID Configuration (Discovery Endpoint)
+ */
+export declare function openIdConfigurationHandler(_ctx: ActionCtx, request: Request, config: OAuthConfig): Promise<Response>;
+/**
+ * JWKS Endpoint
+ */
+export declare function jwksHandler(_ctx: ActionCtx, request: Request, config: OAuthConfig): Promise<Response>;
+/**
+ * Token Endpoint
+ */
+export declare function tokenHandler(ctx: ActionCtx, request: Request, config: OAuthConfig, api: OAuthComponentAPI): Promise<Response>;
+/**
+ * UserInfo Endpoint
+ */
+export declare function userInfoHandler(ctx: ActionCtx, request: Request, config: OAuthConfig, getUserProfile: (userId: string) => Promise<UserProfile | null>): Promise<Response>;
+/**
+ * Register Endpoint (Dynamic Client Registration)
+ */
+export declare function registerHandler(ctx: ActionCtx, request: Request, config: OAuthConfig, api: OAuthComponentAPI): Promise<Response>;
+/**
+ * Protected Resource Metadata (RFC 9728)
+ */
+export declare function oauthProtectedResourceHandler(_ctx: ActionCtx, request: Request, config: OAuthConfig): Promise<Response>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/component/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/component/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAerD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAgB,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAwFxF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE;QACL,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC;YACjE,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAC;YAChC,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,aAAa,EAAE,MAAM,EAAE,CAAC;SAC3B,GAAG,IAAI,CAAC,CAAC;QACV,eAAe,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC;YAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;SAClC,GAAG,IAAI,CAAC,CAAC;QACV,eAAe,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,KAAK,CAAC;YAC3E,GAAG,EAAE,MAAM,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC,CAAC;KACP,CAAC;IACF,SAAS,EAAE;QACP,sBAAsB,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YAChD,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,CAAC;YACtB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YACzC,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,YAAY,EAAE,MAAM,CAAC;SACxB,KAAK,OAAO,CAAC;YACV,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,aAAa,EAAE,MAAM,CAAC;YACtB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;QACH,UAAU,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YACpC,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC;YAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;YAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC9B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YAC5C,eAAe,EAAE,MAAM,CAAC;YACxB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;YACrB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC;YAClB,qBAAqB,EAAE,MAAM,CAAC;SACjC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,mBAAmB,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,EAAE,CAAC;SACpB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,2BAA2B,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YACrD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;SACpB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACvB,CAAC;IACF,gBAAgB,EAAE;QACd,cAAc,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YACxC,IAAI,EAAE,MAAM,CAAC;YACb,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAC;YAChC,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;SACtB,KAAK,OAAO,CAAC;YACV,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,gBAAgB,EAAE,MAAM,CAAC;SAC5B,CAAC,CAAC;QACH,kBAAkB,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;YAC5C,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC;SACxB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC1B,CAAC;CACL;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,iBAAiB,GACvB,OAAO,CAAC,QAAQ,CAAC,CAoInB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC5C,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC,CAiCnB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAC9B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,iBAAiB,GACvB,OAAO,CAAC,QAAQ,CAAC,CAmUnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAChE,OAAO,CAAC,QAAQ,CAAC,CAgFnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,iBAAiB,GACvB,OAAO,CAAC,QAAQ,CAAC,CAsFnB;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAC/C,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC,CAkBnB"}