rari 0.13.1

rari: Runtime Accelerated Rendering Infrastructure - A high-performance React Server Components framework powered by Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

/* eslint-disable node/prefer-global/process */
if (!globalThis['~rari'])
  globalThis['~rari'] = {}

globalThis['~rari'].componentLoader = {
  async registerComponent(moduleSpecifier, componentId, skipGlobalBinding = false) {
    try {
      const moduleNamespace = await import(moduleSpecifier)

      const isApiRoute = componentId.includes('/route') || componentId.startsWith('api/')
      const isServerAction = componentId.startsWith('actions/')

      if (!skipGlobalBinding) {
        if (moduleNamespace.default && typeof moduleNamespace.default === 'function') {
          if (componentId in globalThis) {
            return {
              success: false,
              error: `Component ${componentId} would overwrite existing global`,
            }
          }
          globalThis[componentId] = moduleNamespace.default
        }
        else if (!isApiRoute && !isServerAction) {
          const exports = Object.values(moduleNamespace).filter(v => typeof v === 'function')

          if (exports.length > 0) {
            if (componentId in globalThis) {
              return {
                success: false,
                error: `Component ${componentId} would overwrite existing global`,
              }
            }
            globalThis[componentId] = exports[0]
          }
          else {
            return {
              success: false,
              error: `No default export or function exports found in component ${componentId}`,
            }
          }
        }
      }

      const exportOwners = globalThis['~rari'].exportOwners ||= Object.create(null)

      if (!skipGlobalBinding && !isApiRoute && !isServerAction) {
        const isDebugLogging = (() => {
          try {
            const rustLog = globalThis.Deno?.env?.get('RUST_LOG')
              || globalThis.process?.env?.RUST_LOG
            return rustLog === 'debug' || rustLog === 'trace'
          }
          catch {
            return false
          }
        })()

        for (const [key, value] of Object.entries(moduleNamespace)) {
          if (key !== 'default' && typeof value === 'function') {
            if (!(key in globalThis)) {
              globalThis[key] = value
              exportOwners[key] = componentId
            }
            else if (isDebugLogging) {
              const existingOwner = Object.hasOwn(exportOwners, key)
                ? exportOwners[key]
                : null
              if (existingOwner) {
                console.warn(
                  `Export name collision detected: "${key}" from component "${componentId}" `
                  + `already came from component "${existingOwner}". Keeping the first-registered value.`,
                )
              }
              else {
                console.warn(
                  `Export name collision detected: "${key}" from component "${componentId}" `
                  + `collides with existing globalThis property. Export will not be registered.`,
                )
              }
            }
          }
        }
      }

      if (!globalThis['~rsc'])
        globalThis['~rsc'] = {}
      if (!globalThis['~rsc'].modules)
        globalThis['~rsc'].modules = {}

      globalThis['~rsc'].modules[componentId] = moduleNamespace

      const exportNames = Object.keys(moduleNamespace)

      return {
        success: true,
        hasDefault: !!moduleNamespace.default,
        exportCount: exportNames.length,
      }
    }
    catch (error) {
      console.error(`Failed to register component ${componentId}:`, error)
      return {
        success: false,
        error: error.message,
      }
    }
  },
}