authhero 0.291.0 → 0.291.2

package/dist/authhero.d.ts

@@ -18041,6 +18041,117 @@ export declare function parseUserId(user_id: string): {
 	connection: string;
 	id: string;
 };
+/**
+ * Configuration for a secondary adapter in passthrough mode.
+ */
+export interface SecondaryAdapterConfig<T> {
+	/**
+	 * The secondary adapter to sync writes to.
+	 * Can be a partial implementation - only implemented methods will be called.
+	 */
+	adapter: Partial<T>;
+	/**
+	 * If true, wait for the secondary write to complete before returning.
+	 * Default: false (fire-and-forget)
+	 */
+	blocking?: boolean;
+	/**
+	 * Called when a secondary write fails.
+	 * @param error - The error that occurred
+	 * @param method - The method name that failed
+	 * @param args - The arguments passed to the method
+	 */
+	onError?: (error: Error, method: string, args: unknown[]) => void;
+}
+/**
+ * Configuration for creating a passthrough adapter that syncs writes to multiple destinations.
+ *
+ * @template T - The adapter interface type (e.g., LogsDataAdapter, UsersDataAdapter)
+ */
+export interface PassthroughConfig<T> {
+	/**
+	 * Primary adapter - all reads come from here, writes go here first.
+	 */
+	primary: T;
+	/**
+	 * Secondary adapters to sync writes to.
+	 */
+	secondaries: SecondaryAdapterConfig<T>[];
+	/**
+	 * Methods that should be synced to secondaries.
+	 * Default: ["create", "update", "remove", "delete", "set"]
+	 */
+	syncMethods?: string[];
+}
+/**
+ * Creates a passthrough adapter that syncs write operations to multiple destinations.
+ *
+ * Reads always come from the primary adapter.
+ * Writes go to the primary first, then are synced to all secondaries.
+ *
+ * @example Logs adapter with database primary and Analytics Engine secondary
+ * ```typescript
+ * import { createPassthroughAdapter } from "@authhero/adapter-interfaces";
+ *
+ * const logsAdapter = createPassthroughAdapter({
+ *   primary: databaseLogsAdapter,
+ *   secondaries: [
+ *     {
+ *       adapter: analyticsEngineAdapter,
+ *       onError: (err) => console.error("Analytics sync failed:", err),
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Cache adapter with multiple backends
+ * ```typescript
+ * const cacheAdapter = createPassthroughAdapter({
+ *   primary: redisCacheAdapter,
+ *   secondaries: [
+ *     { adapter: memcachedAdapter, blocking: true },
+ *     { adapter: localCacheAdapter },
+ *   ],
+ *   syncMethods: ["set", "delete"],
+ * });
+ * ```
+ *
+ * @example Users adapter with search index sync
+ * ```typescript
+ * const usersAdapter = createPassthroughAdapter({
+ *   primary: databaseUsersAdapter,
+ *   secondaries: [
+ *     {
+ *       adapter: elasticsearchAdapter,
+ *       blocking: true, // Wait for search index to update
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export declare function createPassthroughAdapter<T extends object>(config: PassthroughConfig<T>): T;
+/**
+ * Creates a write-only adapter that only implements specific methods.
+ * Useful for creating secondary adapters that only need to handle synced writes.
+ *
+ * @example
+ * ```typescript
+ * const webhookNotifier = createWriteOnlyAdapter<LogsDataAdapter>({
+ *   create: async (tenantId, log) => {
+ *     await fetch("https://webhook.example.com/logs", {
+ *       method: "POST",
+ *       body: JSON.stringify({ tenantId, log }),
+ *     });
+ *   },
+ * });
+ *
+ * const logsAdapter = createPassthroughAdapter({
+ *   primary: databaseLogsAdapter,
+ *   secondaries: [{ adapter: webhookNotifier }],
+ * });
+ * ```
+ */
+export declare function createWriteOnlyAdapter<T>(implementation: Partial<T>): Partial<T>;
 export interface CacheItem<T = any> {
 	value: T;
 	expiresAt?: Date;