@holo-js/core 0.1.8 → 0.2.0

package/dist/{chunk-OAA4RKVE.mjs → chunk-F423SU6D.mjs}

@@ -98,6 +98,7 @@ function createGeneratedBroadcastManifest(registry) {
     channels: Object.freeze(registry.channels.map((entry) => Object.freeze({
       name: entry.pattern,
       pattern: entry.pattern,
+      ...typeof entry.guard === "undefined" ? {} : { guard: entry.guard },
       type: entry.type,
       params: Object.freeze([...entry.params]),
       whispers: Object.freeze([...entry.whispers])
@@ -519,6 +520,10 @@ function closeSessionRedisAdapter(adapter) {
   return adapter.disconnect?.() || adapter.close?.();
 }
 var CORE_BROADCAST_PUBLISHER_MARKER = /* @__PURE__ */ Symbol.for("holo-js.core.broadcast.publisher");
+var frameworkBuildEnvKey = "HOLO_INTERNAL_FRAMEWORK_BUILD";
+function shouldBootRuntimeServices(processEnv = process.env) {
+  return processEnv[frameworkBuildEnvKey] !== "1";
+}
 function getRuntimeState() {
   const runtime = globalThis;
   runtime.__holoRuntime__ ??= {};
@@ -654,6 +659,11 @@ function createRequestAwareAuthContext(context, accessors) {
       requestAccessorStorage.enterWith({
         accessors: nextAccessors
       });
+    },
+    async runWithRequestAccessors(nextAccessors, callback) {
+      return await requestAccessorStorage.run({
+        accessors: nextAccessors
+      }, callback);
     }
   });
 }
@@ -2607,6 +2617,10 @@ async function createHolo(projectRoot, options = {}) {
     setAuthRequestAccessors(authRequest) {
       activeAuthContext?.setRequestAccessors?.(authRequest);
     },
+    async runWithAuthRequestAccessors(authRequest, callback) {
+      const runner = activeAuthContext?.runWithRequestAccessors;
+      return runner ? await runner(authRequest, callback) : await callback();
+    },
     async initialize() {
       if (runtime.initialized) {
         throw new Error("Holo runtime is already initialized.");
@@ -2625,49 +2639,51 @@ async function createHolo(projectRoot, options = {}) {
         });
       }
       try {
-        await manager.initializeAll();
-        const optionalSubsystems = await reconfigureOptionalHoloSubsystems(projectRoot, loadedConfig, {
-          renderView: options.renderView,
-          authRequest: options.authRequest,
-          authorizationError: options.authorizationError
-        });
-        activeQueueModule = optionalSubsystems.queueModule;
-        activeSessionRuntime = optionalSubsystems.session;
-        activeAuthRuntime = optionalSubsystems.auth;
-        activeAuthContext = optionalSubsystems.authContext;
-        const optionalEventsModule = activeQueueModule ? await loadEventsModule() : void 0;
-        if (activeQueueModule && optionalEventsModule) {
-          await optionalEventsModule.ensureEventsQueueJobRegisteredAsync?.();
-        }
-        if (registryHasEvents(registry)) {
-          const eventsModule = await loadEventsModule(true);
-          if (!eventsModule) {
-            throw new Error("[@holo-js/core] Events support requires @holo-js/events to be installed.");
+        if (shouldBootRuntimeServices(options.processEnv)) {
+          await manager.initializeAll();
+          const optionalSubsystems = await reconfigureOptionalHoloSubsystems(projectRoot, loadedConfig, {
+            renderView: options.renderView,
+            authRequest: options.authRequest,
+            authorizationError: options.authorizationError
+          });
+          activeQueueModule = optionalSubsystems.queueModule;
+          activeSessionRuntime = optionalSubsystems.session;
+          activeAuthRuntime = optionalSubsystems.auth;
+          activeAuthContext = optionalSubsystems.authContext;
+          const optionalEventsModule = activeQueueModule ? await loadEventsModule() : void 0;
+          if (activeQueueModule && optionalEventsModule) {
+            await optionalEventsModule.ensureEventsQueueJobRegisteredAsync?.();
+          }
+          if (registryHasEvents(registry)) {
+            const eventsModule = await loadEventsModule(true);
+            if (!eventsModule) {
+              throw new Error("[@holo-js/core] Events support requires @holo-js/events to be installed.");
+            }
+            activeEventsModule = eventsModule;
+            const eventRegistration = await registerProjectEventsAndListeners(
+              projectRoot,
+              registry,
+              eventsModule,
+              activeQueueModule
+            );
+            runtimeOwnedEventNames.splice(0, runtimeOwnedEventNames.length, ...eventRegistration.eventNames);
+            runtimeOwnedListenerIds.splice(0, runtimeOwnedListenerIds.length, ...eventRegistration.listenerIds);
           }
-          activeEventsModule = eventsModule;
-          const eventRegistration = await registerProjectEventsAndListeners(
+          activeAuthorizationModule = await loadAuthorizationModule();
+          const authorizationRegistration = await registerProjectAuthorizationDefinitions(
             projectRoot,
             registry,
-            eventsModule,
-            activeQueueModule
+            activeAuthorizationModule
           );
-          runtimeOwnedEventNames.splice(0, runtimeOwnedEventNames.length, ...eventRegistration.eventNames);
-          runtimeOwnedListenerIds.splice(0, runtimeOwnedListenerIds.length, ...eventRegistration.listenerIds);
-        }
-        activeAuthorizationModule = await loadAuthorizationModule();
-        const authorizationRegistration = await registerProjectAuthorizationDefinitions(
-          projectRoot,
-          registry,
-          activeAuthorizationModule
-        );
-        runtimeOwnedAuthorizationPolicyNames.splice(0, runtimeOwnedAuthorizationPolicyNames.length, ...authorizationRegistration.policyNames);
-        runtimeOwnedAuthorizationAbilityNames.splice(0, runtimeOwnedAuthorizationAbilityNames.length, ...authorizationRegistration.abilityNames);
-        if (options.registerProjectQueueJobs === true && registryHasJobs(registry)) {
-          if (!activeQueueModule) {
-            throw new Error("[@holo-js/core] Project jobs require @holo-js/queue to be installed.");
+          runtimeOwnedAuthorizationPolicyNames.splice(0, runtimeOwnedAuthorizationPolicyNames.length, ...authorizationRegistration.policyNames);
+          runtimeOwnedAuthorizationAbilityNames.splice(0, runtimeOwnedAuthorizationAbilityNames.length, ...authorizationRegistration.abilityNames);
+          if (options.registerProjectQueueJobs === true && registryHasJobs(registry)) {
+            if (!activeQueueModule) {
+              throw new Error("[@holo-js/core] Project jobs require @holo-js/queue to be installed.");
+            }
+            runtimeOwnedQueueJobNames.splice(0, runtimeOwnedQueueJobNames.length);
+            runtimeOwnedQueueJobNames.push(...await registerProjectQueueJobs(projectRoot, registry, activeQueueModule));
           }
-          runtimeOwnedQueueJobNames.splice(0, runtimeOwnedQueueJobNames.length);
-          runtimeOwnedQueueJobNames.push(...await registerProjectQueueJobs(projectRoot, registry, activeQueueModule));
         }
         runtime.initialized = true;
         getRuntimeState().current = runtime;

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+type HoloHttpErrorStatus = 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+type NormalizedHoloHttpError = {
+    readonly status: HoloHttpErrorStatus;
+    readonly message: string;
+    readonly code?: string;
+    readonly cause: unknown;
+};
+declare function isHoloHttpErrorStatus(status: number): status is HoloHttpErrorStatus;
+declare function normalizeHoloHttpError(error: unknown): NormalizedHoloHttpError | undefined;
+
+export { type HoloHttpErrorStatus, type NormalizedHoloHttpError, isHoloHttpErrorStatus, normalizeHoloHttpError };

package/dist/errors.mjs

@@ -0,0 +1,106 @@
+// src/errors.ts
+var httpStatuses = /* @__PURE__ */ new Set([
+  400,
+  401,
+  402,
+  403,
+  404,
+  405,
+  406,
+  407,
+  408,
+  409,
+  410,
+  411,
+  412,
+  413,
+  414,
+  415,
+  416,
+  417,
+  418,
+  421,
+  422,
+  423,
+  424,
+  425,
+  426,
+  428,
+  429,
+  431,
+  451,
+  500,
+  501,
+  502,
+  503,
+  504,
+  505,
+  506,
+  507,
+  508,
+  510,
+  511
+]);
+function isObject(value) {
+  return !!value && typeof value === "object";
+}
+function readNumber(value) {
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+}
+function readString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function readStatus(error) {
+  if (!isObject(error)) {
+    return void 0;
+  }
+  const directStatus = readNumber(error.status);
+  if (directStatus) {
+    return directStatus;
+  }
+  const statusCode = readNumber(error.statusCode);
+  if (statusCode) {
+    return statusCode;
+  }
+  const digest = readString(error.digest);
+  const nextHttpStatus = digest?.match(/^NEXT_HTTP_ERROR_FALLBACK;(\d{3})$/)?.[1];
+  return nextHttpStatus ? Number(nextHttpStatus) : void 0;
+}
+function readMessage(error) {
+  if (error instanceof Error && error.message.length > 0) {
+    return error.message;
+  }
+  if (isObject(error)) {
+    const message = readString(error.message);
+    if (message) {
+      return message;
+    }
+    const statusText = readString(error.statusText);
+    if (statusText) {
+      return statusText;
+    }
+  }
+  return "An unexpected error occurred.";
+}
+function readCode(error) {
+  return isObject(error) ? readString(error.code) : void 0;
+}
+function isHoloHttpErrorStatus(status) {
+  return httpStatuses.has(status);
+}
+function normalizeHoloHttpError(error) {
+  const status = readStatus(error);
+  if (!status || !isHoloHttpErrorStatus(status)) {
+    return void 0;
+  }
+  return {
+    status,
+    message: readMessage(error),
+    code: readCode(error),
+    cause: error
+  };
+}
+export {
+  isHoloHttpErrorStatus,
+  normalizeHoloHttpError
+};

package/dist/index.mjs

@@ -17,7 +17,7 @@ import {
   resolveGeneratedProjectRegistryPath,
   resolveRuntimeConnectionManagerOptions,
   resolveStorageKeyPath
-} from "./chunk-OAA4RKVE.mjs";
+} from "./chunk-F423SU6D.mjs";
 
 // src/adapter.ts
 import { readdir, stat } from "node:fs/promises";

package/dist/runtime/index.d.ts

@@ -55,6 +55,7 @@ interface GeneratedChannelRegistryEntry {
     readonly sourcePath: string;
     readonly pattern: string;
     readonly exportName?: string;
+    readonly guard?: string;
     readonly type: 'private' | 'presence';
     readonly params: readonly string[];
     readonly whispers: readonly string[];
@@ -111,6 +112,7 @@ interface GeneratedBroadcastManifestEvent {
 interface GeneratedBroadcastManifestChannel {
     readonly name: string;
     readonly pattern: string;
+    readonly guard?: string;
     readonly type: 'private' | 'presence';
     readonly params: readonly string[];
     readonly whispers: readonly string[];
@@ -745,6 +747,7 @@ interface HoloRuntime<TCustom extends HoloConfigMap = HoloConfigMap> {
     readonly initialized: boolean;
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
+    runWithAuthRequestAccessors<TValue>(accessors: NonNullable<CreateHoloOptions['authRequest']>, callback: () => Promise<TValue>): Promise<TValue>;
     useConfig<TKey extends Extract<keyof RuntimeConfigRegistry<TCustom>, string>>(key: TKey): RuntimeConfigRegistry<TCustom>[TKey];
     useConfig<TPath extends DotPath<RuntimeConfigRegistry<TCustom>>>(path: TPath): ValueAtPath<RuntimeConfigRegistry<TCustom>, TPath>;
     config<TPath extends DotPath<RuntimeConfigRegistry<TCustom>>>(path: TPath): ValueAtPath<RuntimeConfigRegistry<TCustom>, TPath>;
@@ -955,6 +958,7 @@ declare function reconfigureOptionalHoloSubsystems<TCustom extends HoloConfigMap
     readonly authContext?: {
         activate(): void;
         setRequestAccessors?(accessors?: CreateHoloOptions['authRequest']): void;
+        runWithRequestAccessors?<TValue>(accessors: NonNullable<CreateHoloOptions['authRequest']>, callback: () => Promise<TValue>): Promise<TValue>;
     };
 }>;
 declare function resetOptionalHoloSubsystems(): Promise<void>;

package/dist/runtime/index.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/core",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Holo-JS Framework - Portable runtime core",
   "type": "module",
   "license": "MIT",
@@ -10,6 +10,11 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.mjs",
+      "default": "./dist/errors.mjs"
+    },
     "./runtime": {
       "types": "./dist/runtime/index.d.ts",
       "import": "./dist/runtime/index.mjs",
@@ -28,26 +33,26 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/config": "^0.1.8",
-    "@holo-js/db": "^0.1.8",
+    "@holo-js/config": "^0.2.0",
+    "@holo-js/db": "^0.2.0",
     "esbuild": "^0.27.4"
   },
   "peerDependencies": {
-    "@holo-js/auth": "^0.1.8",
-    "@holo-js/auth-clerk": "^0.1.8",
-    "@holo-js/auth-social": "^0.1.8",
-    "@holo-js/auth-workos": "^0.1.8",
-    "@holo-js/authorization": "^0.1.8",
-    "@holo-js/broadcast": "^0.1.8",
-    "@holo-js/cache": "^0.1.8",
-    "@holo-js/events": "^0.1.8",
-    "@holo-js/mail": "^0.1.8",
-    "@holo-js/notifications": "^0.1.8",
-    "@holo-js/queue": "^0.1.8",
-    "@holo-js/queue-db": "^0.1.8",
-    "@holo-js/security": "^0.1.8",
-    "@holo-js/session": "^0.1.8",
-    "@holo-js/storage": "^0.1.8"
+    "@holo-js/auth": "^0.2.0",
+    "@holo-js/auth-clerk": "^0.2.0",
+    "@holo-js/auth-social": "^0.2.0",
+    "@holo-js/auth-workos": "^0.2.0",
+    "@holo-js/authorization": "^0.2.0",
+    "@holo-js/broadcast": "^0.2.0",
+    "@holo-js/cache": "^0.2.0",
+    "@holo-js/events": "^0.2.0",
+    "@holo-js/mail": "^0.2.0",
+    "@holo-js/notifications": "^0.2.0",
+    "@holo-js/queue": "^0.2.0",
+    "@holo-js/queue-db": "^0.2.0",
+    "@holo-js/security": "^0.2.0",
+    "@holo-js/session": "^0.2.0",
+    "@holo-js/storage": "^0.2.0"
   },
   "peerDependenciesMeta": {
     "@holo-js/auth": {
@@ -97,15 +102,15 @@
     }
   },
   "devDependencies": {
-    "@holo-js/auth": "^0.1.8",
-    "@holo-js/auth-social-google": "^0.1.8",
-    "@holo-js/authorization": "^0.1.8",
-    "@holo-js/events": "^0.1.8",
-    "@holo-js/mail": "^0.1.8",
-    "@holo-js/notifications": "^0.1.8",
-    "@holo-js/queue-db": "^0.1.8",
-    "@holo-js/session": "^0.1.8",
-    "@holo-js/storage": "^0.1.8",
+    "@holo-js/auth": "^0.2.0",
+    "@holo-js/auth-social-google": "^0.2.0",
+    "@holo-js/authorization": "^0.2.0",
+    "@holo-js/events": "^0.2.0",
+    "@holo-js/mail": "^0.2.0",
+    "@holo-js/notifications": "^0.2.0",
+    "@holo-js/queue-db": "^0.2.0",
+    "@holo-js/session": "^0.2.0",
+    "@holo-js/storage": "^0.2.0",
     "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",