@sesamy/sesamy-js 1.95.0 → 1.97.0

package/dist/sesamy-js.d.ts

@@ -414,7 +414,12 @@ export declare interface HeaderCondition {
     contains: string;
 }
 
-export declare function init(config: Config): Promise<SesamyAPI>;
+export declare function init(config: Config, options?: InitOptions): Promise<SesamyAPI>;
+
+export declare interface InitOptions {
+    /** Provide an auth plugin directly instead of relying on `registerAuthPlugin()` or the window factory. */
+    authPlugin?: AuthPlugin;
+}
 
 declare function isAuthenticated(): Promise<boolean>;
 
@@ -1117,20 +1122,17 @@ declare function registerAPI(config: ApiConfig): {
 
 /**
  * Register an auth plugin. Must be called before `sesamy.init()` to take
- * effect. The scripts-host bundle registers the Auth0 plugin by default so
- * that existing publishers are unaffected.
+ * effect.
  *
- * @example
- * ```html
- * <!-- Load the auth0 plugin first, then the main bundle -->
- * <script src="https://scripts.sesamy.com/s/vendor/bundle/stable.js"></script>
- * ```
+ * Prefer passing `authPlugin` directly to `init()` for explicit wiring.
+ * This function remains available for backwards compatibility and for the
+ * DOM-based auto-init path (where init() is never called manually).
  *
  * @example
  * ```ts
- * import { registerAuthPlugin } from '@sesamy/sesamy-js';
+ * import { init } from '@sesamy/sesamy-js';
  * import { createAuth0Plugin } from '@sesamy/sesamy-js/auth0-plugin';
- * registerAuthPlugin(createAuth0Plugin());
+ * await init(config, { authPlugin: createAuth0Plugin() });
  * ```
  */
 export declare function registerAuthPlugin(plugin: AuthPlugin): void;