@oglofus/auth 1.1.0 → 1.1.1

package/dist/types/model.d.ts

@@ -165,6 +165,76 @@ export type OrganizationEntitlementSnapshot<Feature extends string, LimitKey ext
     features: Partial<Record<Feature, boolean>>;
     limits: Partial<Record<LimitKey, number>>;
 };
+export type StripeSubject = {
+    kind: "user";
+    userId: string;
+} | {
+    kind: "organization";
+    organizationId: string;
+};
+export type StripeReference = `user:${string}` | `organization:${string}`;
+export type StripeBillingCycle = "monthly" | "annual";
+export type StripeSubscriptionStatus = "trialing" | "active" | "past_due" | "unpaid" | "paused" | "canceled" | "incomplete" | "incomplete_expired";
+export type StripeEntitlementSnapshot<Feature extends string, LimitKey extends string> = {
+    planKey?: string;
+    status?: StripeSubscriptionStatus;
+    features: Partial<Record<Feature, boolean>>;
+    limits: Partial<Record<LimitKey, number>>;
+};
+export type StripePlan<Feature extends string, LimitKey extends string> = {
+    key: string;
+    displayName: string;
+    scope: StripeSubject["kind"];
+    prices: {
+        monthly?: {
+            priceId: string;
+        };
+        annual?: {
+            priceId: string;
+        };
+    };
+    trial?: {
+        days: number;
+        oncePerSubject?: boolean;
+    };
+    seats?: {
+        enabled: boolean;
+        minimum?: number;
+        maximum?: number;
+        limitKey?: LimitKey;
+    };
+    features?: Partial<Record<Feature, boolean>>;
+    limits?: Partial<Record<LimitKey, number>>;
+    metadata?: Record<string, string>;
+};
+export interface StripeCustomerRecord {
+    id: string;
+    subject: StripeSubject;
+    stripeCustomerId: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface StripeSubscriptionSnapshot<Feature extends string = string, LimitKey extends string = string> {
+    id: string;
+    subject: StripeSubject;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string;
+    stripePriceId: string;
+    planKey: string;
+    status: StripeSubscriptionStatus;
+    billingCycle: StripeBillingCycle;
+    seats?: number | null;
+    cancelAtPeriodEnd: boolean;
+    currentPeriodStart?: Date | null;
+    currentPeriodEnd?: Date | null;
+    trialStartedAt?: Date | null;
+    trialEndsAt?: Date | null;
+    canceledAt?: Date | null;
+    features: Partial<Record<Feature, boolean>>;
+    limits: Partial<Record<LimitKey, number>>;
+    metadata?: Record<string, string>;
+    updatedAt: Date;
+}
 export interface AuthRequestContext {
     requestId?: string;
     ip?: string;

package/dist/types/plugins.d.ts

@@ -1,11 +1,12 @@
 import type { CoreAdapters, OrganizationsPluginHandlers } from "./adapters.js";
-import type { AccountDiscoveryMode, AuthRequestContext, CompleteProfileInput, DiscoverAccountInput, DiscoverAccountDecision, MembershipBase, OrganizationBase, OrganizationEntitlementSnapshot, ProfileCompletionState, SecondFactorMethod, TwoFactorVerifyInput, UserBase } from "./model.js";
+import type { AccountDiscoveryMode, AuthRequestContext, CompleteProfileInput, DiscoverAccountDecision, DiscoverAccountInput, MembershipBase, OrganizationBase, OrganizationEntitlementSnapshot, ProfileCompletionState, SecondFactorMethod, StripeBillingCycle, StripeEntitlementSnapshot, StripePlan, StripeSubject, StripeSubscriptionSnapshot, TwoFactorVerifyInput, UserBase } from "./model.js";
 import type { AuthResult, OperationResult } from "./results.js";
 export interface AuthPluginContext<U extends UserBase> {
     adapters: CoreAdapters<U>;
     now(): Date;
     security?: AuthSecurityConfig;
     request?: AuthRequestContext;
+    getPluginApi?<T = unknown>(method: string): T | null;
 }
 export interface BasePlugin<Method extends string, U extends UserBase, ExposedApi extends object = {}> {
     kind: "auth_method" | "domain";
@@ -185,10 +186,76 @@ export interface OrganizationsPluginApi<O extends OrganizationBase, Role extends
         remaining?: number;
     }>>;
 }
+export interface StripePluginApi<Feature extends string, LimitKey extends string> {
+    createCheckoutSession(input: {
+        subject: StripeSubject;
+        planKey: string;
+        billingCycle: StripeBillingCycle;
+        successUrl: string;
+        cancelUrl: string;
+        seats?: number;
+        locale?: string;
+        metadata?: Record<string, string>;
+    }): Promise<OperationResult<{
+        url: string;
+        checkoutSessionId: string;
+    }>>;
+    createBillingPortalSession(input: {
+        subject: StripeSubject;
+        returnUrl: string;
+        locale?: string;
+    }): Promise<OperationResult<{
+        url: string;
+    }>>;
+    getSubscription(input: {
+        subject: StripeSubject;
+    }): Promise<OperationResult<{
+        subscription: StripeSubscriptionSnapshot<Feature, LimitKey> | null;
+    }>>;
+    listSubscriptions(input: {
+        subject: StripeSubject;
+    }): Promise<OperationResult<{
+        subscriptions: StripeSubscriptionSnapshot<Feature, LimitKey>[];
+    }>>;
+    cancelSubscription(input: {
+        subject: StripeSubject;
+        subscriptionId?: string;
+        atPeriodEnd?: boolean;
+    }): Promise<OperationResult<{
+        subscription: StripeSubscriptionSnapshot<Feature, LimitKey>;
+    }>>;
+    resumeSubscription(input: {
+        subject: StripeSubject;
+        subscriptionId?: string;
+    }): Promise<OperationResult<{
+        subscription: StripeSubscriptionSnapshot<Feature, LimitKey>;
+    }>>;
+    changePlan(input: {
+        subject: StripeSubject;
+        planKey: string;
+        billingCycle: StripeBillingCycle;
+        subscriptionId?: string;
+        seats?: number;
+        scheduleAtPeriodEnd?: boolean;
+    }): Promise<OperationResult<{
+        subscription: StripeSubscriptionSnapshot<Feature, LimitKey>;
+    }>>;
+    getEntitlements(input: {
+        subject: StripeSubject;
+    }): Promise<OperationResult<StripeEntitlementSnapshot<Feature, LimitKey>>>;
+    handleWebhook(input: {
+        rawBody: string | Uint8Array;
+        stripeSignature: string;
+    }): Promise<OperationResult<{
+        processed: true;
+        eventId: string;
+    }>>;
+}
 export interface OrganizationsPluginConfig<O extends OrganizationBase, Role extends string, M extends MembershipBase<Role>, Permission extends string, Feature extends string, LimitKey extends string, RequiredOrgFields extends keyof O = never> {
     organizationRequiredFields?: readonly Extract<RequiredOrgFields, string>[];
     handlers: OrganizationsPluginHandlers<O, Role, M, Permission, Feature, LimitKey>;
 }
+export type StripePlansResolver<Feature extends string, LimitKey extends string> = readonly StripePlan<Feature, LimitKey>[] | (() => Promise<readonly StripePlan<Feature, LimitKey>[]>);
 export type AuthSecurityRateLimitScope = "discover" | "register" | "authenticate" | "emailOtpRequest" | "magicLinkRequest" | "otpVerify";
 export interface AuthSecurityRateLimitPolicy {
     limit: number;

package/dist/types/results.d.ts

@@ -1,5 +1,5 @@
+import type { AuthError, ProfileCompletionRequiredError, TwoFactorRequiredError } from "../errors/index.js";
 import type { Issue } from "../issues/index.js";
-import type { ProfileCompletionRequiredError, TwoFactorRequiredError, AuthError } from "../errors/index.js";
 import type { UserBase } from "./model.js";
 export type OperationResult<TData> = {
     ok: true;

package/dist/types/results.js

@@ -1,4 +1,13 @@
-export const successResult = (user, sessionId, issues = []) => ({ ok: true, user, sessionId, issues });
+export const successResult = (user, sessionId, issues = []) => ({
+    ok: true,
+    user,
+    sessionId,
+    issues,
+});
 export const errorResult = (error, issues = error.issues) => ({ ok: false, error, issues });
-export const successOperation = (data, issues = []) => ({ ok: true, data, issues });
+export const successOperation = (data, issues = []) => ({
+    ok: true,
+    data,
+    issues,
+});
 export const errorOperation = (error, issues = error.issues) => ({ ok: false, error, issues });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oglofus/auth",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Type-safe, plugin-first authentication core",
   "homepage": "https://github.com/oglofus/auth#readme",
   "bugs": {
@@ -18,7 +18,8 @@
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.test.json",
     "test": "tsx --test test/**/*.test.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write ."
   },
   "files": [
     "dist",
@@ -27,6 +28,9 @@
   ],
   "devDependencies": {
     "@types/node": "^25.3.5",
+    "prettier": "^3.8.1",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "stripe": "^20.4.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
@@ -42,6 +46,9 @@
     "@oslojs/otp": "^1.1.0",
     "arctic": "^3.7.0"
   },
+  "peerDependencies": {
+    "stripe": "^20.4.1"
+  },
   "publishConfig": {
     "access": "public"
   }