@authhero/adapter-interfaces 4.18.0 → 4.20.0

package/dist/types/adapters/PromptPartials.d.ts

@@ -0,0 +1,9 @@
+import { CreateOptions, PromptPartials } from "../types";
+export interface PromptPartialsAdapter {
+    get(tenant_id: string, prompt: string): Promise<PromptPartials | null>;
+    /** Replace all partials stored for a prompt. */
+    set(tenant_id: string, prompt: string, partials: PromptPartials, options?: CreateOptions): Promise<void>;
+    delete(tenant_id: string, prompt: string): Promise<void>;
+    /** List prompts with stored partials for tenant export. */
+    list(tenant_id: string): Promise<string[]>;
+}

package/dist/types/adapters/RolePermissions.d.ts

@@ -1,8 +1,22 @@
 import { ListParams } from "../types/ListParams";
 import { RolePermissionInsert, RolePermissionList } from "../types/RolePermission";
 import { CreateOptions } from "../types/ImportMetadata";
+export interface ListRolePermissionsCheckpointResponse {
+    permissions: RolePermissionList;
+    /** Opaque checkpoint cursor for the next page; absent on the last page. */
+    next?: string;
+}
 export interface RolePermissionsAdapter {
     assign(tenant_id: string, role_id: string, permissions: RolePermissionInsert[], options?: CreateOptions): Promise<boolean>;
     remove(tenant_id: string, role_id: string, permissions: Pick<RolePermissionInsert, "resource_server_identifier" | "permission_name">[]): Promise<boolean>;
     list(tenant_id: string, role_id: string, params?: ListParams): Promise<RolePermissionList>;
+    /**
+     * Checkpoint (from/take) pagination over a role's permissions, ordered by
+     * (resource_server_identifier, permission_name) ascending — the composite
+     * key, so the order is unique without a surrogate id. Separate from `list`
+     * because that returns a bare array with nowhere to carry `next`. Optional
+     * so existing adapter implementations keep compiling; the management API
+     * answers checkpoint requests with 501 when it is missing.
+     */
+    listCheckpoint?(tenant_id: string, role_id: string, params?: ListParams): Promise<ListRolePermissionsCheckpointResponse>;
 }

package/dist/types/adapters/index.d.ts

@@ -50,6 +50,7 @@ import { StatsAdapter } from "./Stats";
 import { AnalyticsAdapter } from "./Analytics";
 import { UniversalLoginTemplatesAdapter } from "./UniversalLoginTemplates";
 import { CustomTextAdapter } from "./CustomText";
+import { PromptPartialsAdapter } from "./PromptPartials";
 import { EmailServiceAdapter } from "./EmailService";
 import { SmsServiceAdapter } from "./SmsService";
 import { OutboxAdapter } from "./Outbox";
@@ -100,6 +101,8 @@ export interface DataAdapters {
     migrationSources?: MigrationSourcesAdapter;
     passwords: PasswordsAdapter;
     promptSettings: PromptSettingsAdapter;
+    /** Optional tenant-level storage for Auth0-compatible prompt partials. */
+    promptPartials?: PromptPartialsAdapter;
     /**
      * Optional adapter for managing reverse-proxy route configuration per tenant.
      * When set, AuthHero mounts the `/api/v2/proxy-routes` management API. A
@@ -248,6 +251,7 @@ export * from "./ActionVersions";
 export * from "./Flows";
 export * from "./Cache";
 export * from "./Clients";
+export * from "./PromptPartials";
 export * from "./ClientConnections";
 export * from "./ClientGrants";
 export * from "./ClientRegistrationTokens";

package/dist/types/types/Forms.d.ts

@@ -1,4 +1,5 @@
 import { z } from "@hono/zod-openapi";
+import type { PromptPartialInsertionPoint } from "./PromptPartials";
 declare const dividerComponent: z.ZodObject<{
     id: z.ZodString;
     order: z.ZodOptional<z.ZodNumber>;
@@ -4651,6 +4652,13 @@ export declare const screenLinkSchema: z.ZodObject<{
     linkText: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ScreenLink = z.infer<typeof screenLinkSchema>;
+/**
+ * Auth0 prompt partials attached to a rendered screen.
+ *
+ * This is a single screen's insertion points, rather than the complete
+ * prompt -> screen -> insertion point object persisted by adapters.
+ */
+export declare const uiScreenPartialsSchema: z.ZodType<Partial<Record<PromptPartialInsertionPoint, string>>>;
 /**
  * Screen sent to the widget (simplified STEP for rendering)
  * This is what the API returns to the widget - no flow routing logic
@@ -5288,6 +5296,7 @@ export declare const uiScreenSchema: z.ZodObject<{
         href: z.ZodString;
         linkText: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    partials: z.ZodOptional<z.ZodType<Partial<Record<"form-content-start" | "form-content-end" | "form-footer-start" | "form-footer-end" | "secondary-actions-start" | "secondary-actions-end", string>>, unknown, z.core.$ZodTypeInternals<Partial<Record<"form-content-start" | "form-content-end" | "form-footer-start" | "form-footer-end" | "secondary-actions-start" | "secondary-actions-end", string>>, unknown>>>;
     footer: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type UiScreen = z.infer<typeof uiScreenSchema>;

package/dist/types/types/PromptPartials.d.ts

@@ -0,0 +1,22 @@
+import { z } from "@hono/zod-openapi";
+export declare const promptPartialInsertionPoints: readonly ["form-content-start", "form-content-end", "form-footer-start", "form-footer-end", "secondary-actions-start", "secondary-actions-end"];
+export type PromptPartialInsertionPoint = (typeof promptPartialInsertionPoints)[number];
+/**
+ * Auth0-compatible prompt partials, keyed by screen and insertion point.
+ *
+ * @example
+ * ```ts
+ * {
+ *   signup: {
+ *     "form-content-end": "<input name=\"ulp-first-name\">"
+ *   }
+ * }
+ * ```
+ */
+export type PromptPartials = Record<string, Partial<Record<PromptPartialInsertionPoint, string>>>;
+export declare const promptPartialsSchema: z.ZodType<PromptPartials>;
+export declare const promptPartialsEntrySchema: z.ZodObject<{
+    prompt: z.ZodString;
+    partials: z.ZodType<PromptPartials, unknown, z.core.$ZodTypeInternals<PromptPartials, unknown>>;
+}, z.core.$strip>;
+export type PromptPartialsEntry = z.infer<typeof promptPartialsEntrySchema>;

package/dist/types/types/ProxyRoute.d.ts

@@ -50,7 +50,6 @@ export declare const proxyRouteSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ProxyRoute = z.infer<typeof proxyRouteSchema>;
 export declare const proxyRouteUpdateSchema: z.ZodObject<{
-    priority: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     match: z.ZodOptional<z.ZodObject<{
         hosts: z.ZodOptional<z.ZodArray<z.ZodString>>;
         methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -58,6 +57,7 @@ export declare const proxyRouteUpdateSchema: z.ZodObject<{
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>>;
+    priority: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     handlers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodString;
         options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/types/types/index.d.ts

@@ -60,6 +60,7 @@ export * from "./TenantSettings";
 export * from "./Stats";
 export * from "./Analytics";
 export * from "./CustomText";
+export * from "./PromptPartials";
 export * from "./Strategy";
 export * from "./AuthenticationMethod";
 export * from "./ImportMetadata";

package/package.json

@@ -9,9 +9,9 @@
   "homepage": "https://authhero.net",
   "repository": {
     "type": "git",
-    "url": "https://github.com/markusahlstrand/authhero"
+    "url": "https://github.com/sesamyab/authhero"
   },
-  "version": "4.18.0",
+  "version": "4.20.0",
   "files": [
     "dist"
   ],