@bleedingdev/modern-js-renderer-octane 0.0.0-stage → 3.9.3-ultramodern.10

package/dist/types/worker-federation.d.ts

@@ -0,0 +1,20 @@
+import type { NativeWorkerDispatchOptions } from '@modern-js/renderer-core/server';
+import { type AdmitWorkerRendererContract, createWorkerFederationHandler } from '@modern-js/renderer-core/worker-federation';
+import { prepareExternalSnapshotRequest } from 'octane/server';
+type NativeSnapshotRequest = Awaited<ReturnType<typeof prepareExternalSnapshotRequest>>;
+type HandlerOptions = Parameters<typeof createWorkerFederationHandler<NativeSnapshotRequest>>[0];
+/** The compiled registry pins its renderer publication and literal imports. */
+export interface OctaneWorkerFederationRegistry {
+    initialize(options: Omit<HandlerOptions, 'publication' | 'exposes'> & {
+        publication: unknown;
+    }): (request: Request) => Promise<Response | undefined>;
+}
+/** Created per dispatch; no publisher or native snapshot cache crosses documents. */
+export declare function createNativeWorkerFederationRuntime<Bindings extends object>(options: NativeWorkerDispatchOptions<Bindings>, compiler: {
+    readonly admitRendererContract: AdmitWorkerRendererContract;
+    readonly registry?: OctaneWorkerFederationRegistry;
+}): {
+    transport: import("@modern-js/renderer-core/worker-federation").WorkerFederationTransport | undefined;
+    handleRequest: (request: Request) => Promise<Response | undefined>;
+};
+export {};

package/package.json

@@ -1,6 +1,280 @@
 {
   "name": "@bleedingdev/modern-js-renderer-octane",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.9.3-ultramodern.10",
+  "description": "UltraModern native Octane application adapter.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
+    "directory": "packages/runtime/renderer-octane"
+  },
+  "files": [
+    "dist",
+    "src",
+    "bin"
+  ],
+  "main": "./dist/cjs/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./client": {
+      "import": {
+        "types": "./dist/types/client.d.ts",
+        "default": "./dist/esm/client.mjs"
+      },
+      "require": {
+        "types": "./dist/types/client.d.ts",
+        "default": "./dist/cjs/client.js"
+      }
+    },
+    "./federation": {
+      "import": {
+        "types": "./dist/types/federation.d.ts",
+        "default": "./dist/esm/federation.mjs"
+      },
+      "require": {
+        "types": "./dist/types/federation.d.ts",
+        "default": "./dist/cjs/federation.js"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/types/server.d.ts",
+        "default": "./dist/esm/server.mjs"
+      },
+      "require": {
+        "types": "./dist/types/server.d.ts",
+        "default": "./dist/cjs/server.js"
+      }
+    },
+    "./router": {
+      "import": {
+        "types": "./dist/types/router.d.ts",
+        "default": "./dist/esm/router.mjs"
+      },
+      "require": {
+        "types": "./dist/types/router.d.ts",
+        "default": "./dist/cjs/router.js"
+      }
+    },
+    "./router-client": {
+      "import": {
+        "types": "./dist/types/router-client.d.ts",
+        "default": "./dist/esm/router-client.mjs"
+      },
+      "require": {
+        "types": "./dist/types/router-client.d.ts",
+        "default": "./dist/cjs/router-client.js"
+      }
+    },
+    "./router-server": {
+      "import": {
+        "types": "./dist/types/router-server.d.ts",
+        "default": "./dist/esm/router-server.mjs"
+      },
+      "require": {
+        "types": "./dist/types/router-server.d.ts",
+        "default": "./dist/cjs/router-server.js"
+      }
+    },
+    "./manifest": {
+      "import": {
+        "types": "./dist/types/manifest.d.ts",
+        "default": "./dist/esm/manifest.mjs"
+      },
+      "require": {
+        "types": "./dist/types/manifest.d.ts",
+        "default": "./dist/cjs/manifest.js"
+      }
+    },
+    "./typecheck": {
+      "types": "./dist/types/typecheck.d.ts",
+      "node": {
+        "import": "./dist/esm-node/typecheck.mjs",
+        "require": "./dist/cjs/typecheck.js"
+      }
+    },
+    "./i18n": {
+      "import": {
+        "types": "./dist/types/i18n/index.d.ts",
+        "default": "./dist/esm/i18n/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/i18n/index.d.ts",
+        "default": "./dist/cjs/i18n/index.js"
+      }
+    },
+    "./entry-client": {
+      "import": {
+        "types": "./dist/types/entry-client.d.ts",
+        "default": "./dist/esm/entry-client.mjs"
+      },
+      "require": {
+        "types": "./dist/types/entry-client.d.ts",
+        "default": "./dist/cjs/entry-client.js"
+      }
+    },
+    "./entry-server": {
+      "import": {
+        "types": "./dist/types/entry-server.d.ts",
+        "default": "./dist/esm/entry-server.mjs"
+      },
+      "require": {
+        "types": "./dist/types/entry-server.d.ts",
+        "default": "./dist/cjs/entry-server.js"
+      }
+    },
+    "./plugin": {
+      "import": {
+        "types": "./dist/types/plugin/index.d.ts",
+        "default": "./dist/esm-node/plugin/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/plugin/index.d.ts",
+        "default": "./dist/cjs/plugin/index.js"
+      }
+    },
+    "./package.json": "./package.json",
+    "./router-external-snapshot": {
+      "import": {
+        "types": "./dist/types/router-external-snapshot.d.ts",
+        "default": "./dist/esm/router-external-snapshot.mjs"
+      },
+      "require": {
+        "types": "./dist/types/router-external-snapshot.d.ts",
+        "default": "./dist/cjs/router-external-snapshot.js"
+      }
+    },
+    "./i18n-external-snapshot": {
+      "import": {
+        "types": "./dist/types/i18n-external-snapshot.d.ts",
+        "default": "./dist/esm/i18n-external-snapshot.mjs"
+      },
+      "require": {
+        "types": "./dist/types/i18n-external-snapshot.d.ts",
+        "default": "./dist/cjs/i18n-external-snapshot.js"
+      }
+    },
+    "./worker-federation-contexts": {
+      "import": {
+        "types": "./dist/types/worker-federation-contexts.d.ts",
+        "default": "./dist/esm/worker-federation-contexts.mjs"
+      },
+      "require": {
+        "types": "./dist/types/worker-federation-contexts.d.ts",
+        "default": "./dist/cjs/worker-federation-contexts.js"
+      }
+    }
+  },
+  "bin": {
+    "octane-tsc": "bin/octane-tsc.mjs"
+  },
+  "engines": {
+    "node": ">=26.12.0"
+  },
+  "dependencies": {
+    "@modern-js/renderer-core": "npm:@bleedingdev/modern-js-renderer-core@3.9.3-ultramodern.10",
+    "@volar/language-core": "2.4.28",
+    "jsonc-parser": "3.3.1",
+    "seroval": "1.6.9",
+    "seroval-plugins": "1.6.9",
+    "typescript": "7.0.2"
+  },
+  "peerDependencies": {
+    "@modern-js/i18n-runtime-extensions": "3.9.3-ultramodern.10",
+    "@octanejs/rspack-plugin": "0.2.4",
+    "@octanejs/tanstack-router": "0.2.10",
+    "@rsbuild/core": "2.2.13",
+    "@tanstack/router-core": "1.171.38",
+    "@tsrx/oxc": "0.20.0",
+    "i18next": ">=25.7.4",
+    "octane": "0.13.8"
+  },
+  "peerDependenciesMeta": {
+    "@modern-js/i18n-runtime-extensions": {
+      "optional": true
+    },
+    "@octanejs/rspack-plugin": {
+      "optional": true
+    },
+    "@octanejs/tanstack-router": {
+      "optional": true
+    },
+    "@rsbuild/core": {
+      "optional": true
+    },
+    "@tsrx/oxc": {
+      "optional": true
+    },
+    "i18next": {
+      "optional": true
+    },
+    "octane": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@modern-js/i18n-runtime-extensions": "npm:@bleedingdev/modern-js-i18n-runtime-extensions@3.9.3-ultramodern.10",
+    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.3-ultramodern.10",
+    "@octanejs/rspack-plugin": "https://github.com/BleedingDev/octane/releases/download/ultramodern-octane-2383d2ab1e70/octanejs-rspack-plugin-0.2.4.tgz",
+    "@octanejs/tanstack-router": "https://github.com/BleedingDev/octane/releases/download/ultramodern-octane-2383d2ab1e70/octanejs-tanstack-router-0.2.10.tgz",
+    "@rsbuild/core": "2.2.13",
+    "@rslib/core": "1.0.3",
+    "@scripts/rstest-config": "2.66.0",
+    "@tanstack/router-core": "https://github.com/BleedingDev/router/releases/download/ultramodern-router-core-585d3233f7f5/tanstack-router-core-1.171.38.tgz",
+    "@tsrx/oxc": "0.20.0",
+    "@types/jsdom": "27.0.0",
+    "@types/node": "^26.6.5",
+    "happy-dom": "^21.0.4",
+    "i18next": "26.4.6",
+    "jsdom": "30.0.1",
+    "octane": "https://github.com/BleedingDev/octane/releases/download/ultramodern-octane-2383d2ab1e70/octane-0.13.8.tgz",
+    "typescript": "7.0.2"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "ultramodern": {
+    "nativeArtifacts": {
+      "octane": {
+        "request": "https://github.com/BleedingDev/octane/releases/download/ultramodern-octane-2383d2ab1e70/octane-0.13.8.tgz",
+        "version": "0.13.8",
+        "integrity": "sha512-ryNxtzX4pwMVHNhWyEYG8VnpRUByWUDhtVDpYlQkeqipTSF7s8cP86CzBl/miNCruE48D27mnR7E8UW6V1fEnA=="
+      },
+      "@octanejs/tanstack-router": {
+        "request": "https://github.com/BleedingDev/octane/releases/download/ultramodern-octane-2383d2ab1e70/octanejs-tanstack-router-0.2.10.tgz",
+        "version": "0.2.10",
+        "integrity": "sha512-wdnPhVZSQqZg2DDllUyz4RZufn7I0GEnPKrb/CB21Z8JYKnunAtZn41Dma/+xhg5xvN/USnIg9Eyyf2nbJgxMQ=="
+      },
+      "@octanejs/rspack-plugin": {
+        "request": "https://github.com/BleedingDev/octane/releases/download/ultramodern-octane-2383d2ab1e70/octanejs-rspack-plugin-0.2.4.tgz",
+        "version": "0.2.4",
+        "integrity": "sha512-I8m/d/oj3Qh8nG5nqkWD90m8qgNwlPK9oNh5tlVvGNdSYCTLddRG7Og8wpYKFAGxe2D+0zOIhYGarC0ZKZgSzw=="
+      },
+      "@tanstack/router-core": {
+        "request": "https://github.com/BleedingDev/router/releases/download/ultramodern-router-core-585d3233f7f5/tanstack-router-core-1.171.38.tgz",
+        "version": "1.171.38",
+        "integrity": "sha512-d/aGvcyEVwDh2Cn9MuZM1n1dqTIqkFYi7AHY2Na/6x/a0jVSDVTNVVVY7QEsuKFXktaJF9zjVwetaRm/0MALZg=="
+      }
+    },
+    "sourceName": "@modern-js/renderer-octane"
+  },
+  "scripts": {
+    "build": "rslib build && tsc -p tsconfig.types.json",
+    "test": "rstest"
+  },
+  "homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/ultramodernjs/ultramodern.js/issues"
+  }
+}

package/src/bootstrap.ts

@@ -0,0 +1,60 @@
+import {
+  type DocumentBootstrap,
+  readDocumentBootstrap,
+} from '@modern-js/renderer-core/document';
+import {
+  type RendererIdentity,
+  readRendererIdentity,
+} from '@modern-js/renderer-core/identity';
+
+export interface OctaneDocumentBootstrap extends DocumentBootstrap {
+  /** Actual native client compilation hash, separate from application identity. */
+  readonly nativeHydrationBuildId: string;
+}
+
+export function assertNativeHydrationBuildId(
+  value: unknown,
+): asserts value is string {
+  if (typeof value !== 'string' || value.trim().length === 0) {
+    throw new Error(
+      'An Octane document requires its native client compilation identity.',
+    );
+  }
+}
+
+export function assertOctaneIdentity(identity: RendererIdentity): void {
+  readRendererIdentity(identity, identity);
+  if (identity.renderer !== 'octane') {
+    throw new Error(
+      'An Octane application requires an Octane renderer identity.',
+    );
+  }
+}
+
+/** Read the server's bootstrap and require this exact native client build. */
+export function readOctaneDocumentBootstrap(
+  document: Document,
+  expectedIdentity: RendererIdentity,
+  expectedNativeHydrationBuildId?: string,
+): OctaneDocumentBootstrap {
+  assertOctaneIdentity(expectedIdentity);
+  const { identity, documentId, hydrating, nativeHydrationBuildId } =
+    readDocumentBootstrap(document, expectedIdentity, [
+      'nativeHydrationBuildId',
+    ]);
+  assertNativeHydrationBuildId(nativeHydrationBuildId);
+  if (
+    expectedNativeHydrationBuildId !== undefined &&
+    nativeHydrationBuildId !== expectedNativeHydrationBuildId
+  ) {
+    throw new Error(
+      'Octane hydration bytes belong to a different native client compilation.',
+    );
+  }
+  return Object.freeze({
+    identity,
+    documentId,
+    hydrating,
+    nativeHydrationBuildId,
+  });
+}