@holo-js/core 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { GeneratedProjectRegistry, HoloRuntime, HoloSessionRuntimeBinding, HoloAuthRuntimeBinding, CreateHoloOptions } from './runtime/index.js';
-export { HoloQueueRuntimeBinding, HoloServerViewRenderInput, HoloServerViewRenderer, configureHoloRenderingRuntime, createHolo, ensureHolo, getHolo, holoRuntimeInternals, initializeHolo, loadGeneratedBroadcastManifest, loadGeneratedProjectRegistry, peekHolo, reconfigureOptionalHoloSubsystems, registryInternals, resetHoloRenderingRuntime, resetHoloRuntime, resetOptionalHoloSubsystems, resolveGeneratedProjectRegistryPath } from './runtime/index.js';
+export { GeneratedBroadcastManifest, GeneratedBroadcastManifestChannel, GeneratedBroadcastManifestEvent, HoloQueueRuntimeBinding, HoloServerViewRenderInput, HoloServerViewRenderer, configureHoloRenderingRuntime, createHolo, ensureHolo, getHolo, holoRuntimeInternals, initializeHolo, loadGeneratedBroadcastManifest, loadGeneratedProjectRegistry, peekHolo, reconfigureOptionalHoloSubsystems, registryInternals, resetHoloRenderingRuntime, resetHoloRuntime, resetOptionalHoloSubsystems, resolveGeneratedProjectRegistryPath } from './runtime/index.js';
 import { HoloConfigMap, LoadedHoloConfig, DotPath, ValueAtPath } from '@holo-js/config';
 export { createRuntimeConnectionOptions, resolveRuntimeConnectionManagerOptions } from '@holo-js/db';
 

package/dist/index.mjs

@@ -17,11 +17,11 @@ import {
   resolveGeneratedProjectRegistryPath,
   resolveRuntimeConnectionManagerOptions,
   resolveStorageKeyPath
-} from "./chunk-AD2ZYGLN.mjs";
+} from "./chunk-5ZJO35LB.mjs";
 
 // src/adapter.ts
-import { readdir, stat } from "fs/promises";
-import { extname, join, resolve } from "path";
+import { readdir, stat } from "node:fs/promises";
+import { extname, join, resolve } from "node:path";
 import { configureConfigRuntime, resolveEnvironmentFileOrder } from "@holo-js/config";
 import { configureDB } from "@holo-js/db";
 var HOLO_MINIMUM_ADAPTER_CAPABILITIES = Object.freeze({
@@ -75,12 +75,15 @@ async function resolveProjectSourceSignature(projectRoot, envName) {
 function resolveHoloFrameworkOptions(options = {}) {
   const processEnv = options.processEnv ?? process.env;
   return {
-    projectRoot: resolve(options.projectRoot ?? process.cwd()),
+    projectRoot: resolve(options.projectRoot ?? /* turbopackIgnore: true */
+    process.cwd()),
     runtime: {
       envName: options.envName,
       preferCache: options.preferCache ?? processEnv.NODE_ENV === "production",
       processEnv,
       renderView: options.renderView,
+      authRequest: options.authRequest,
+      authorizationError: options.authorizationError,
       registerProjectQueueJobs: options.registerProjectQueueJobs
     }
   };
@@ -111,6 +114,12 @@ function createHoloProjectAccessors(resolveProject) {
 async function initializeSingletonFrameworkProject(stateKey, displayName, options, createProject) {
   const resolved = resolveHoloFrameworkOptions(options);
   const state = getFrameworkAdapterStateContainer(stateKey);
+  if (state.initialization) {
+    if (state.initialization.projectRoot !== resolved.projectRoot) {
+      throw new Error(`${displayName} Holo project already initialized for "${state.initialization.projectRoot}".`);
+    }
+    return state.initialization.promise;
+  }
   if (state.project) {
     if (state.projectRoot !== resolved.projectRoot) {
       throw new Error(`${displayName} Holo project already initialized for "${state.projectRoot}".`);
@@ -135,10 +144,11 @@ async function initializeSingletonFrameworkProject(stateKey, displayName, option
       configureConfigRuntime(currentRuntime.loadedConfig.all);
       configureDB(currentRuntime.manager);
       await reconfigureOptionalHoloSubsystems(state.project.projectRoot, currentRuntime.loadedConfig, {
-        renderView: resolved.runtime.renderView
+        renderView: resolved.runtime.renderView,
+        authRequest: resolved.runtime.authRequest,
+        authorizationError: resolved.runtime.authorizationError
       });
       if (state.project.runtime !== currentRuntime) {
-        ;
         state.project = {
           ...state.project,
           config: currentRuntime.loadedConfig,
@@ -148,20 +158,38 @@ async function initializeSingletonFrameworkProject(stateKey, displayName, option
       }
       return state.project;
     }
-    ;
     state.project = void 0;
   }
-  const project = await createProject(resolved);
   state.projectRoot = resolved.projectRoot;
-  state.project = project;
-  state.sourceSignature = resolved.runtime.preferCache === false ? await resolveProjectSourceSignature(resolved.projectRoot, project.config.environment.name) : void 0;
-  return project;
+  const initialization = Promise.resolve().then(() => createProject(resolved)).then(async (project) => {
+    state.projectRoot = resolved.projectRoot;
+    state.project = project;
+    state.sourceSignature = resolved.runtime.preferCache === false ? await resolveProjectSourceSignature(resolved.projectRoot, project.config.environment.name) : void 0;
+    return project;
+  }).catch((error) => {
+    if (state.initialization?.promise === initialization) {
+      state.project = void 0;
+      state.projectRoot = void 0;
+      state.sourceSignature = void 0;
+    }
+    throw error;
+  }).finally(() => {
+    if (state.initialization?.promise === initialization) {
+      state.initialization = void 0;
+    }
+  });
+  state.initialization = {
+    projectRoot: resolved.projectRoot,
+    promise: initialization
+  };
+  return initialization;
 }
 async function resetSingletonFrameworkProject(stateKey) {
   const state = getFrameworkAdapterStateContainer(stateKey);
   state.project = void 0;
   state.projectRoot = void 0;
   state.sourceSignature = void 0;
+  state.initialization = void 0;
   await resetOptionalHoloSubsystems();
   await resetHoloRuntime();
 }
@@ -210,7 +238,9 @@ async function initializeHoloAdapterProject(projectRoot, options = {}) {
   const project = await createHoloAdapterProject(projectRoot, options);
   const runtime = await ensureHolo(project.projectRoot, options);
   await reconfigureOptionalHoloSubsystems(project.projectRoot, runtime.loadedConfig, {
-    renderView: options.renderView
+    renderView: options.renderView,
+    authRequest: options.authRequest,
+    authorizationError: options.authorizationError
   });
   return {
     ...project,

package/dist/runtime/index.d.ts

@@ -1,4 +1,4 @@
-import { HoloConfigMap, LoadedHoloConfig, DotPath, ValueAtPath } from '@holo-js/config';
+import { HoloConfigMap, LoadedHoloConfig, DotPath, ValueAtPath, AuthHostedIdentityStore } from '@holo-js/config';
 import { resolveRuntimeConnectionManagerOptions } from '@holo-js/db';
 export { RuntimeConfigInput, RuntimeConnectionConfig, RuntimeDatabaseConfig, RuntimeHoloConfig, SupportedDatabaseDriver, createAdapter, createDialect, createRuntimeConnectionOptions, createRuntimeLogger, isSupportedDatabaseDriver, parseDatabaseDriver, resolveRuntimeConnectionManagerOptions } from '@holo-js/db';
 
@@ -147,6 +147,33 @@ interface CoreNotificationDatabaseRoute {
     readonly id: string | number;
     readonly type: string;
 }
+type HoloAuthResult<TData> = {
+    readonly data: TData;
+    readonly error: null;
+} | {
+    readonly data: null;
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly status: number;
+        readonly fields: Readonly<Partial<Record<string, readonly string[]>>>;
+    };
+};
+type CoreHostedIdentityRecord = {
+    readonly provider: string;
+    readonly providerUserId: string;
+    readonly guard: string;
+    readonly authProvider: string;
+    readonly userId: string | number;
+    readonly email?: string;
+    readonly emailVerified: boolean;
+    readonly profile: Readonly<Record<string, unknown>>;
+    readonly linkedAt: Date;
+    readonly updatedAt: Date;
+};
+type CoreHostedIdentityStore = AuthHostedIdentityStore & {
+    claim(record: CoreHostedIdentityRecord): Promise<CoreHostedIdentityRecord>;
+};
 interface CoreNotificationRecord<TData extends CoreNotificationJsonValue = CoreNotificationJsonValue> {
     readonly id: string;
     readonly type?: string;
@@ -207,13 +234,13 @@ interface HoloAuthRuntimeBinding {
     login(credentials: Readonly<Record<string, unknown>> & {
         readonly password: string;
         readonly remember?: boolean;
-    }): Promise<{
+    }): Promise<HoloAuthResult<{
         readonly guard: string;
         readonly user: unknown;
         readonly sessionId: string;
         readonly rememberToken?: string;
         readonly cookies: readonly string[];
-    }>;
+    }>>;
     loginUsing(user: unknown, options?: {
         readonly remember?: boolean;
     }): Promise<{
@@ -262,7 +289,7 @@ interface HoloAuthRuntimeBinding {
         readonly password: string;
         readonly passwordConfirmation: string;
         readonly remember?: boolean;
-    }): Promise<unknown>;
+    }): Promise<HoloAuthResult<unknown>>;
     logoutAll(guardName?: string): Promise<readonly {
         readonly guard: string;
         readonly cookies: readonly string[];
@@ -276,13 +303,13 @@ interface HoloAuthRuntimeBinding {
         login(credentials: Readonly<Record<string, unknown>> & {
             readonly password: string;
             readonly remember?: boolean;
-        }): Promise<{
+        }): Promise<HoloAuthResult<{
             readonly guard: string;
             readonly user: unknown;
             readonly sessionId: string;
             readonly rememberToken?: string;
             readonly cookies: readonly string[];
-        }>;
+        }>>;
         loginUsing(user: unknown, options?: {
             readonly remember?: boolean;
         }): Promise<{
@@ -352,19 +379,33 @@ interface HoloAuthRuntimeBinding {
             readonly guard?: string;
             readonly expiresAt?: Date;
         }): Promise<unknown>;
-        consume(plainTextToken: string): Promise<unknown>;
-    };
-    passwords: {
-        request(email: string, options?: {
-            readonly broker?: string;
+        resend(options?: {
+            readonly guard?: string;
             readonly expiresAt?: Date;
-        }): Promise<void>;
-        consume(input: {
-            readonly token: string;
-            readonly password: string;
-            readonly passwordConfirmation: string;
-        }): Promise<unknown>;
+            readonly email?: string;
+        }): Promise<HoloAuthResult<unknown>>;
+        consume(plainTextToken: string): Promise<HoloAuthResult<unknown>>;
     };
+    verifyEmail(token: string): Promise<HoloAuthResult<unknown>>;
+    sendEmailVerification(email?: string, options?: {
+        readonly guard?: string;
+        readonly expiresAt?: Date;
+    }): Promise<HoloAuthResult<unknown>>;
+    resendEmailVerification(email?: string, options?: {
+        readonly guard?: string;
+        readonly expiresAt?: Date;
+    }): Promise<HoloAuthResult<unknown>>;
+    requestPasswordReset(input: {
+        readonly email: string;
+    }, options?: {
+        readonly broker?: string;
+        readonly expiresAt?: Date;
+    }): Promise<HoloAuthResult<void>>;
+    resetPassword(input: {
+        readonly token: string;
+        readonly password: string;
+        readonly passwordConfirmation: string;
+    }): Promise<HoloAuthResult<unknown>>;
 }
 interface HoloQueueRuntimeBinding {
     readonly config: LoadedHoloConfig['queue'];
@@ -623,6 +664,10 @@ type AuthorizationModule = {
             hasGuard(guardName: string): boolean;
             resolveDefaultActor(): Promise<object | null> | object | null;
             resolveGuardActor(guardName: string): Promise<object | null> | object | null;
+            createError?(decision: {
+                readonly message?: string;
+                readonly status: 200 | 403 | 404;
+            }): Error;
         };
         registerPolicyDefinition?(definition: unknown): unknown;
         registerAbilityDefinition?(definition: unknown): unknown;
@@ -630,6 +675,10 @@ type AuthorizationModule = {
             hasGuard(guardName: string): boolean;
             resolveDefaultActor(): Promise<object | null> | object | null;
             resolveGuardActor(guardName: string): Promise<object | null> | object | null;
+            createError?(decision: {
+                readonly message?: string;
+                readonly status: 200 | 403 | 404;
+            }): Error;
         }): void;
         resetAuthorizationAuthIntegration(): void;
         resetAuthorizationRuntimeState(): void;
@@ -651,6 +700,18 @@ interface CreateHoloOptions {
     readonly processEnv?: NodeJS.ProcessEnv;
     readonly registerProjectQueueJobs?: boolean;
     readonly renderView?: HoloServerViewRenderer;
+    readonly authRequest?: {
+        readonly getCookie?: (name: string) => string | undefined | Promise<string | undefined>;
+        readonly getHeader?: (name: string) => string | undefined | Promise<string | undefined>;
+        readonly appendResponseCookie?: (cookie: string) => void | Promise<void>;
+        readonly redirectResponse?: (url: string, status?: 301 | 302 | 303 | 307 | 308) => void | Promise<void>;
+    };
+    readonly authorizationError?: {
+        readonly createError?: (decision: {
+            readonly message?: string;
+            readonly status: 200 | 403 | 404;
+        }) => Error;
+    };
 }
 interface HoloRuntime<TCustom extends HoloConfigMap = HoloConfigMap> {
     readonly projectRoot: string;
@@ -675,9 +736,6 @@ declare function resetHoloRenderingRuntime(): void;
 declare function importOptionalModule<TModule>(specifier: string, options?: {
     readonly projectRoot?: string;
 }): Promise<TModule | undefined>;
-declare function bindAuthRuntimeToContext(runtime: HoloAuthRuntimeBinding, authContext: {
-    activate(): void;
-}): HoloAuthRuntimeBinding;
 declare function loadAuthorizationModule(required?: boolean): Promise<AuthorizationModule | undefined>;
 declare function resolveAuthorizationDefinitionExport(moduleValue: unknown, exportName: string | undefined, matcher: (value: unknown) => boolean): unknown | undefined;
 declare function normalizeNotificationRecordFromRow(row: Record<string, unknown>): CoreNotificationRecord<CoreNotificationJsonValue>;
@@ -698,7 +756,7 @@ declare function createCoreSessionStores<TCustom extends HoloConfigMap>(projectR
     delete(sessionId: string): Promise<void>;
 }>>>;
 declare function createCoreNotificationStore<TCustom extends HoloConfigMap>(loadedConfig: LoadedHoloConfig<TCustom>): CoreNotificationStore;
-declare function createAuthNotificationsDeliveryHook(notificationsModule: NotificationsModule): {
+declare function createAuthNotificationsDeliveryHook(notificationsModule: NotificationsModule, appUrl: string, projectRoot?: string): {
     sendEmailVerification(input: {
         readonly provider: string;
         readonly user: unknown;
@@ -708,8 +766,10 @@ declare function createAuthNotificationsDeliveryHook(notificationsModule: Notifi
             readonly plainTextToken: string;
             readonly expiresAt: Date;
         };
+        readonly route: string;
     }): Promise<void>;
     sendPasswordReset(input: {
+        readonly broker: string;
         readonly provider: string;
         readonly email: string;
         readonly token: {
@@ -717,6 +777,7 @@ declare function createAuthNotificationsDeliveryHook(notificationsModule: Notifi
             readonly plainTextToken: string;
             readonly expiresAt: Date;
         };
+        readonly route: string;
     }): Promise<void>;
 };
 declare function createCoreNotificationBroadcaster(broadcastModule: BroadcastModule): {
@@ -755,7 +816,7 @@ declare function createCoreNotificationMailSender(mailModule: MailModule): {
         };
     }): Promise<void>;
 };
-declare function createAuthMailDeliveryHook(mailModule: MailModule): {
+declare function createAuthMailDeliveryHook(mailModule: MailModule, appUrl: string): {
     sendEmailVerification(input: {
         readonly provider: string;
         readonly user: unknown;
@@ -765,8 +826,10 @@ declare function createAuthMailDeliveryHook(mailModule: MailModule): {
             readonly plainTextToken: string;
             readonly expiresAt: Date;
         };
+        readonly route: string;
     }): Promise<void>;
     sendPasswordReset(input: {
+        readonly broker: string;
         readonly provider: string;
         readonly email: string;
         readonly token: {
@@ -774,6 +837,7 @@ declare function createAuthMailDeliveryHook(mailModule: MailModule): {
             readonly plainTextToken: string;
             readonly expiresAt: Date;
         };
+        readonly route: string;
     }): Promise<void>;
 };
 declare function loadConfiguredSocialProviders<TCustom extends HoloConfigMap>(projectRootOrLoadedConfig: string | LoadedHoloConfig<TCustom>, maybeLoadedConfig?: LoadedHoloConfig<TCustom>): Promise<Readonly<Record<string, unknown>>>;
@@ -805,6 +869,7 @@ declare function createCoreSocialBindings<TCustom extends HoloConfigMap>(project
             readonly state: string;
             readonly codeVerifier: string;
             readonly guard: string;
+            readonly browserBinding?: string;
             readonly createdAt: Date;
         }): Promise<void>;
         read(provider: string, state: string): Promise<{
@@ -812,6 +877,7 @@ declare function createCoreSocialBindings<TCustom extends HoloConfigMap>(project
             readonly state: string;
             readonly codeVerifier: string;
             readonly guard: string;
+            readonly browserBinding?: string;
             readonly createdAt: Date;
         } | null>;
         delete(provider: string, state: string): Promise<void>;
@@ -822,11 +888,7 @@ declare function createCoreSocialBindings<TCustom extends HoloConfigMap>(project
     };
 }>;
 declare function fromHostedIdentityProviderValue(namespace: string, provider: string): string;
-declare function createCoreHostedIdentityStore(namespace: string): {
-    findByProviderUserId(provider: string, providerUserId: string): Promise<unknown | null>;
-    findByUserId(provider: string, authProvider: string, userId: string | number): Promise<unknown | null>;
-    save(record: unknown): Promise<void>;
-};
+declare function createCoreHostedIdentityStore(namespace: string): CoreHostedIdentityStore;
 declare function createCoreAuthStores<TCustom extends HoloConfigMap>(loadedConfig: LoadedHoloConfig<TCustom>): {
     readonly tokens: {
         create(record: unknown): Promise<void>;
@@ -864,12 +926,15 @@ declare function registerProjectAuthorizationDefinitions(projectRoot: string, re
 declare function unregisterProjectAuthorizationDefinitions(authorizationModule: AuthorizationModule | undefined, policyNames: readonly string[], abilityNames: readonly string[]): void;
 declare function reconfigureOptionalHoloSubsystems<TCustom extends HoloConfigMap = HoloConfigMap>(projectRoot: string, loadedConfig: LoadedHoloConfig<TCustom>, options?: {
     readonly renderView?: HoloServerViewRenderer;
+    readonly authRequest?: CreateHoloOptions['authRequest'];
+    readonly authorizationError?: CreateHoloOptions['authorizationError'];
 }): Promise<{
     readonly queueModule?: QueueModule;
     readonly session?: HoloSessionRuntimeBinding;
     readonly auth?: HoloAuthRuntimeBinding;
     readonly authContext?: {
         activate(): void;
+        setRequestAccessors?(accessors?: CreateHoloOptions['authRequest']): void;
     };
 }>;
 declare function resetOptionalHoloSubsystems(): Promise<void>;
@@ -886,7 +951,6 @@ declare const holoRuntimeInternals: {
     createAuthNotificationsDeliveryHook: typeof createAuthNotificationsDeliveryHook;
     createCoreNotificationBroadcaster: typeof createCoreNotificationBroadcaster;
     createCoreNotificationMailSender: typeof createCoreNotificationMailSender;
-    bindAuthRuntimeToContext: typeof bindAuthRuntimeToContext;
     createCoreAuthProviders: typeof createCoreAuthProviders;
     createCoreAuthStores: typeof createCoreAuthStores;
     createCoreHostedIdentityStore: typeof createCoreHostedIdentityStore;

package/dist/runtime/index.mjs

@@ -22,7 +22,7 @@ import {
   resetOptionalHoloSubsystems,
   resolveGeneratedProjectRegistryPath,
   resolveRuntimeConnectionManagerOptions
-} from "../chunk-AD2ZYGLN.mjs";
+} from "../chunk-5ZJO35LB.mjs";
 export {
   configureHoloRenderingRuntime,
   createAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/core",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Holo-JS Framework - Portable runtime core",
   "type": "module",
   "license": "MIT",
@@ -28,22 +28,26 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/config": "^0.1.3",
-    "@holo-js/db": "^0.1.3",
+    "@holo-js/config": "^0.1.5",
+    "@holo-js/db": "^0.1.5",
     "esbuild": "^0.27.4"
   },
   "peerDependencies": {
-    "@holo-js/auth": "^0.1.3",
-    "@holo-js/auth-clerk": "^0.1.3",
-    "@holo-js/auth-social": "^0.1.3",
-    "@holo-js/auth-workos": "^0.1.3",
-    "@holo-js/authorization": "^0.1.3",
-    "@holo-js/mail": "^0.1.3",
-    "@holo-js/notifications": "^0.1.3",
-    "@holo-js/queue": "^0.1.3",
-    "@holo-js/security": "^0.1.3",
-    "@holo-js/session": "^0.1.3",
-    "@holo-js/storage": "^0.1.3"
+    "@holo-js/auth": "^0.1.5",
+    "@holo-js/auth-clerk": "^0.1.5",
+    "@holo-js/auth-social": "^0.1.5",
+    "@holo-js/auth-workos": "^0.1.5",
+    "@holo-js/authorization": "^0.1.5",
+    "@holo-js/broadcast": "^0.1.5",
+    "@holo-js/cache": "^0.1.5",
+    "@holo-js/events": "^0.1.5",
+    "@holo-js/mail": "^0.1.5",
+    "@holo-js/notifications": "^0.1.5",
+    "@holo-js/queue": "^0.1.5",
+    "@holo-js/queue-db": "^0.1.5",
+    "@holo-js/security": "^0.1.5",
+    "@holo-js/session": "^0.1.5",
+    "@holo-js/storage": "^0.1.5"
   },
   "peerDependenciesMeta": {
     "@holo-js/auth": {
@@ -61,6 +65,15 @@
     "@holo-js/authorization": {
       "optional": true
     },
+    "@holo-js/broadcast": {
+      "optional": true
+    },
+    "@holo-js/cache": {
+      "optional": true
+    },
+    "@holo-js/events": {
+      "optional": true
+    },
     "@holo-js/mail": {
       "optional": true
     },
@@ -70,6 +83,9 @@
     "@holo-js/queue": {
       "optional": true
     },
+    "@holo-js/queue-db": {
+      "optional": true
+    },
     "@holo-js/security": {
       "optional": true
     },
@@ -81,17 +97,18 @@
     }
   },
   "devDependencies": {
-    "@holo-js/auth": "^0.1.3",
-    "@holo-js/authorization": "^0.1.3",
-    "@holo-js/events": "^0.1.3",
-    "@holo-js/mail": "^0.1.3",
-    "@holo-js/notifications": "^0.1.3",
-    "@holo-js/queue-db": "^0.1.3",
-    "@holo-js/session": "^0.1.3",
-    "@holo-js/storage": "^0.1.3",
+    "@holo-js/auth": "^0.1.5",
+    "@holo-js/auth-social-google": "^0.1.5",
+    "@holo-js/authorization": "^0.1.5",
+    "@holo-js/events": "^0.1.5",
+    "@holo-js/mail": "^0.1.5",
+    "@holo-js/notifications": "^0.1.5",
+    "@holo-js/queue-db": "^0.1.5",
+    "@holo-js/session": "^0.1.5",
+    "@holo-js/storage": "^0.1.5",
     "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.5"
   }
 }