ras-stack 0.7.0 → 0.8.1

package/README.md

@@ -93,15 +93,14 @@ Only enable `trustForwardedHeaders` behind a proxy that replaces incoming forwar
 Applications choose their channel names, authorize subscriptions, and define payloads. `ras-stack` handles Centrifugo's HTTP publication, signed tokens, and repeated browser lifecycle mechanics:
 
 ```ts
+import { CentrifugoPublisher, signRealtimeToken } from 'ras-stack/realtime'
 import {
-  CentrifugoPublisher,
   connectRealtimeClient,
   createSameOriginRealtimeClient,
   openRealtimeSubscription,
   requestRealtimeTicket,
-  signRealtimeToken,
   watchSubscriptionPresence,
-} from 'ras-stack/realtime'
+} from 'ras-stack/realtime/client'
 
 const publisher = new CentrifugoPublisher({
   apiUrl,
@@ -182,6 +181,28 @@ Extend the supplied configuration and override anything specific to the applicat
 
 TypeScript bases are also available at `ras-stack/config/typescript/browser` and `ras-stack/config/typescript/library`.
 
+The TypeScript configs compose by runtime role:
+
+- `base` contains runtime-neutral strictness and module-safety options.
+- `bundler` adds ESM bundler resolution without assuming DOM or Node globals.
+- `browser` adds DOM, JSX, and no-emit defaults.
+- `tanstack` adds Vite and Node types to the browser role.
+- `node-bundler` targets bundled Node 24 workers and scripts.
+- `library` uses NodeNext resolution and declaration-friendly strictness.
+
+Oxlint applications can extend the strict default plus independent layers for shared application preferences and generated TanStack files:
+
+```json
+{
+  "extends": ["./node_modules/ras-stack/config/oxlint/application.json", "./node_modules/ras-stack/config/oxlint/tanstack.json"],
+  "rules": {
+    "application-specific-rule": "off"
+  }
+}
+```
+
+These configs do not set include paths, aliases, generated directories outside TanStack's route tree, or framework-specific worker globals. Keep those differences in the consuming repository.
+
 ## Repository policy
 
 Policy files which cannot inherit can stay committed while being checked against the shared source. Select only the policies a repository wants in `ras-stack.policy.json`:

package/config/oxlint/application.json

@@ -0,0 +1,16 @@
+{
+  "extends": ["../oxlint.json"],
+  "rules": {
+    "no-console": "off",
+    "no-await-in-loop": "off",
+    "no-underscore-dangle": "off",
+    "unicorn/require-post-message-target-origin": "off",
+    "vitest/require-to-throw-message": "off",
+    "vitest/no-conditional-expect": "off",
+    "unicorn/no-array-sort": "off",
+    "oxc/no-map-spread": "off",
+    "unicorn/consistent-function-scoping": "off",
+    "unicorn/prefer-add-event-listener": "off",
+    "typescript/no-unnecessary-type-parameters": "off"
+  }
+}

package/config/oxlint/tanstack.json

@@ -0,0 +1,4 @@
+{
+  "extends": ["../oxlint.json"],
+  "ignorePatterns": ["src/routeTree.gen.ts", ".output/**", "node_modules/**"]
+}

package/config/typescript/base.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/config/typescript/browser.json

@@ -1,15 +1,8 @@
 {
+  "extends": "./bundler.json",
   "compilerOptions": {
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "esModuleInterop": true,
     "jsx": "react-jsx",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "target": "ES2023",
     "lib": ["ES2023", "DOM", "DOM.Iterable"],
-    "skipLibCheck": true,
-    "noEmit": true,
-    "verbatimModuleSyntax": true
+    "noEmit": true
   }
 }

package/config/typescript/bundler.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "target": "ES2023",
+    "lib": ["ES2023"]
+  }
+}

package/config/typescript/library.json

@@ -1,13 +1,11 @@
 {
+  "extends": "./base.json",
   "compilerOptions": {
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
     "exactOptionalPropertyTypes": true,
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
     "target": "ES2024",
     "lib": ["ES2024", "DOM", "DOM.Iterable"],
-    "skipLibCheck": true,
-    "verbatimModuleSyntax": true
+    "skipLibCheck": true
   }
 }

package/config/typescript/node-bundler.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./bundler.json",
+  "compilerOptions": {
+    "target": "ES2024",
+    "lib": ["ES2024"],
+    "types": ["node"],
+    "noEmit": true
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
   "keywords": [
     "authentication",
@@ -42,6 +42,10 @@
       "types": "./dist/realtime/index.d.ts",
       "default": "./dist/realtime/index.js"
     },
+    "./realtime/client": {
+      "types": "./dist/realtime/client.d.ts",
+      "default": "./dist/realtime/client.js"
+    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "default": "./dist/server/index.js"
@@ -59,8 +63,13 @@
       "default": "./dist/uploads/index.js"
     },
     "./config/oxlint": "./config/oxlint.json",
+    "./config/oxlint/application": "./config/oxlint/application.json",
+    "./config/oxlint/tanstack": "./config/oxlint/tanstack.json",
+    "./config/typescript/base": "./config/typescript/base.json",
     "./config/typescript/browser": "./config/typescript/browser.json",
+    "./config/typescript/bundler": "./config/typescript/bundler.json",
     "./config/typescript/library": "./config/typescript/library.json",
+    "./config/typescript/node-bundler": "./config/typescript/node-bundler.json",
     "./config/typescript/tanstack": "./config/typescript/tanstack.json"
   },
   "publishConfig": {
@@ -68,7 +77,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
-    "config:check": "tsc -p test/config-consumer/tsconfig.json",
+    "config:check": "tsc -p test/config-consumer/tsconfig.json && tsc -p test/config-consumer/tsconfig-bundler.json && tsc -p test/config-consumer/tsconfig-node-bundler.json && tsc -p test/config-consumer/tsconfig-library.json && oxlint --config config/oxlint/application.json --print-config > /dev/null && oxlint --config config/oxlint/tanstack.json --print-config > /dev/null",
     "typecheck": "tsc --noEmit",
     "lint": "oxlint --type-aware --deny-warnings .",
     "format": "oxfmt --write .",