@od-oneapp/config 2026.2.2001-canary.1

package/tsdown/base.mjs

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Base tsdown configuration - platform-agnostic defaults
+ *
+ * This mirrors the tsconfig pattern: base.json contains all shared settings,
+ * platform presets (node, browser, react) extend with minimal overrides.
+ *
+ * @example
+ * ```javascript
+ * import { base } from '@od-oneapp/config/tsdown'
+ *
+ * export default {
+ *   ...base,
+ *   entry: ['src/index.ts'],
+ *   external: ['some-dep'],
+ * }
+ * ```
+ */
+
+/**
+ * Base configuration shared across all packages.
+ * Contains format, output, and quality settings.
+ * @type {import('tsdown').UserConfig}
+ */
+export const base = {
+  // Output format - ESM only (CJS not supported due to top-level await usage)
+  format: ['esm'],
+
+  // Output configuration
+  outDir: 'dist',
+  clean: true,
+
+  // Code splitting - extract shared chunks across entry points for tree-shaking
+  splitting: true,
+
+  // Generate .d.ts for IDE autocomplete
+  dts: { eager: true },
+
+  // Source maps for debugging
+  sourcemap: true,
+
+  // Reduce log verbosity
+  logLevel: 'warn',
+  report: false,
+
+  // Consistent .mjs output extension (tsdown uses outExtensions plural)
+  outExtensions: () => ({ js: '.mjs', dts: '.d.mts' }),
+};
+
+/**
+ * ESM-only configuration for packages that don't need CJS support.
+ * Use this when all consumers are modern ESM bundlers.
+ * @type {import('tsdown').UserConfig}
+ */
+export const baseESMOnly = {
+  // Output format - ESM only for modern consumers
+  format: ['esm'],
+
+  // Output configuration
+  outDir: 'dist',
+  clean: true,
+
+  // Code splitting - extract shared chunks across entry points for tree-shaking
+  splitting: true,
+
+  // Generate .d.ts for IDE autocomplete
+  dts: { eager: true },
+
+  // Source maps for debugging
+  sourcemap: true,
+
+  // Reduce log verbosity
+  logLevel: 'warn',
+  report: false,
+
+  // Consistent .mjs output extension (tsdown uses outExtensions plural)
+  outExtensions: () => ({ js: '.mjs', dts: '.d.mts' }),
+};

package/tsdown/browser.mjs

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Browser platform preset - extends base with browser settings
+ *
+ * Use for: Browser libraries, utilities that run in browser context
+ *
+ * @example
+ * ```javascript
+ * import { browser } from '@od-oneapp/config/tsdown'
+ *
+ * export default {
+ *   ...browser,
+ *   entry: ['src/index.ts'],
+ *   external: ['zod'],
+ * }
+ * ```
+ */
+
+import { base } from './base.mjs';
+
+/**
+ * Browser platform configuration.
+ * Extends base with browser target and platform.
+ * @type {import('tsdown').UserConfig & { external: (string | RegExp)[] }}
+ */
+export const browser = {
+  ...base,
+
+  // Target modern browsers (ES2022)
+  target: 'es2022',
+  platform: 'browser',
+
+  // No default externals for browser
+  external: [],
+};

package/tsdown/client.mjs

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Client component preset - extends react with 'use client' banner
+ *
+ * Use for: React client components that need the 'use client' directive
+ *
+ * @example
+ * ```javascript
+ * import { client } from '@od-oneapp/config/tsdown'
+ *
+ * export default {
+ *   ...client,
+ *   entry: ['src/index.ts'],
+ *   external: [...client.external, '@mantine/core'],
+ * }
+ * ```
+ */
+
+import { react } from './react.mjs';
+
+/**
+ * Client component configuration.
+ * Extends react with 'use client' banner for Next.js App Router.
+ * @type {import('tsdown').UserConfig & { external: (string | RegExp)[] }}
+ */
+export const client = {
+  ...react,
+
+  // Add 'use client' directive to all output files
+  banner: {
+    js: "'use client';",
+  },
+};

package/tsdown/dist.mjs

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview Distribution build helper for @od-oneapp/* packages
+ *
+ * Use this for packages that need to be published to npmjs.
+ * Key differences from platform presets:
+ * - Bundles internal @repo/* dependencies INTO the output
+ * - Externalizes frameworks and peer dependencies
+ * - Rewrites @repo/* imports to @od-oneapp/* for unresolved externals
+ *
+ * @example
+ * ```javascript
+ * import { createDistConfig } from '@od-oneapp/config/tsdown/dist'
+ *
+ * export default createDistConfig('node', {
+ *   index: 'src/index.ts',
+ *   client: 'src/client.ts',
+ * }, {
+ *   external: ['better-auth', 'zod'],
+ * })
+ * ```
+ */
+
+import { browser } from './browser.mjs';
+import { client } from './client.mjs';
+import { node } from './node.mjs';
+import { react } from './react.mjs';
+
+/**
+ * Rolldown plugin to rewrite @repo/* imports to @od-oneapp/* in output.
+ * This ensures consumers can resolve workspace dependencies via published packages.
+ *
+ * Uses two hooks:
+ * 1. resolveId - catches imports that couldn't be bundled
+ * 2. renderChunk - rewrites any remaining @repo/* in final output
+ *
+ * @returns {import('rolldown').Plugin}
+ */
+function rewriteRepoImportsPlugin() {
+  return {
+    name: 'rewrite-repo-imports',
+    resolveId: {
+      order: 'post',
+      handler(source) {
+        if (source.startsWith('@repo/')) {
+          return { id: source.replace(/^@repo\//, '@od-oneapp/'), external: true };
+        }
+        if (source.startsWith('@integrations/')) {
+          return { id: source.replace(/^@integrations\//, '@od-oneapp/integration-'), external: true };
+        }
+        return null;
+      },
+    },
+    renderChunk(code) {
+      let newCode = code;
+      if (newCode.includes('@repo/')) {
+        newCode = newCode.replace(/@repo\//g, '@od-oneapp/');
+      }
+      if (newCode.includes('@integrations/')) {
+        newCode = newCode.replace(/@integrations\//g, '@od-oneapp/integration-');
+      }
+      return newCode !== code ? { code: newCode, map: null } : null;
+    },
+  };
+}
+
+/**
+ * Platform presets for distribution builds
+ */
+const platforms = {
+  node,
+  browser,
+  react,
+  client,
+};
+
+/**
+ * Common externals for distribution builds.
+ * These are expected to be installed by consumers.
+ * @type {(string | RegExp)[]}
+ */
+export const distExternals = [
+  // Frameworks - consumer's app provides these
+  'next',
+  /^next\/.*/,
+  'react',
+  'react-dom',
+  /^react\/.*/,
+
+  // Database - has native binaries
+  '@prisma/client',
+  /^@prisma\/client\/.*/,
+  'prisma',
+
+  // Node built-ins
+  /^node:/,
+
+  // Server-only marker (Next.js handles this)
+  'server-only',
+
+  // Validation — universal across all dist packages
+  'zod',
+  /^zod\/.*/,
+  '@t3-oss/env-core',
+  '@t3-oss/env-nextjs',
+  /^@od-oneapp\/integration-.*/,
+];
+
+/**
+ * Vercel AI SDK externals.
+ * Use in packages that depend on `ai` / `@ai-sdk/*`.
+ * @type {(string | RegExp)[]}
+ */
+export const aiSdkExternals = ['ai', /^ai\/.*/, /^@ai-sdk\/.*/];
+
+/**
+ * Prisma type-only externals — avoids dts generation issues with generated files.
+ * @type {string[]}
+ */
+export const prismaTypeExternals = [
+  '@od-oneapp/db-prisma/client',
+  '@od-oneapp/db-prisma/enums',
+  '@od-oneapp/db-prisma/types',
+];
+
+/**
+ * Internal workspace packages that should be bundled INTO the output.
+ * This reduces install friction for external consumers.
+ * @type {RegExp[]}
+ */
+export const internalPackages = [
+  /^@repo\/.*/, // Deprecated old namespace
+  /^@integrations\/.*/, // Deprecated old namespace
+  /^@od-oneapp\/(?!integration-).*/, // New workspace packages namespace
+];
+
+/**
+ * Creates a distribution build configuration.
+ *
+ * @param {'node' | 'browser' | 'react' | 'client'} platform - Target platform
+ * @param {Record<string, string>} entry - Entry points mapping
+ * @param {object} [options] - Additional options
+ * @param {(string | RegExp)[]} [options.external] - Additional externals
+ * @param {boolean} [options.keepRepoExternal] - Keep @repo/* as external (for monorepo use)
+ * @param {import('tsdown').UserConfig} [options.config] - Additional tsdown config
+ * @returns {import('tsdown').UserConfig}
+ */
+export function createDistConfig(platform, entry, options = {}) {
+  const base = platforms[platform];
+  if (!base) {
+    throw new Error(
+      `Unknown platform: ${platform}. Use one of: ${Object.keys(platforms).join(', ')}`,
+    );
+  }
+
+  const { external = [], keepRepoExternal = false, config = {} } = options;
+
+  return {
+    ...base,
+    entry,
+
+    // Bundle internal packages INTO the output (unless keepRepoExternal is true)
+    noExternal: keepRepoExternal ? [] : [...internalPackages],
+
+    // Externalize frameworks + package-specific deps (add @repo/* when keeping external)
+    external: [...distExternals, ...external, ...(keepRepoExternal ? [/^@repo\/.*/] : [])],
+
+    // Plugins for distribution builds (skip rewrite plugin when keeping @repo/* external)
+    plugins: keepRepoExternal
+      ? [...(config.plugins || [])]
+      : [rewriteRepoImportsPlugin(), ...(config.plugins || [])],
+
+    // Additional config overrides
+    inlineOnly: false,
+    ...config,
+
+    // Always output .mjs/.d.mts for published packages (never .js) - must override any preset
+    outExtensions: () => ({ js: '.mjs', dts: '.d.mts' }),
+  };
+}

package/tsdown/index.mjs

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview tsdown configuration exports
+ *
+ * Platform-based presets (mirrors tsconfig pattern):
+ * - base: Core settings (format, dts, sourcemap, clean)
+ * - node: Node.js packages (target: node20)
+ * - browser: Browser libraries (target: es2022)
+ * - react: React libraries (browser + react externals)
+ * - client: Client components (react + 'use client' banner)
+ *
+ * Distribution builds (for @od-oneapp/* publishing):
+ * - createDistConfig: Bundles @repo/*, externalizes frameworks
+ *
+ * @example
+ * ```javascript
+ * // Internal package (typical usage)
+ * import { node } from '@od-oneapp/config/tsdown'
+ *
+ * export default {
+ *   ...node,
+ *   entry: ['src/index.ts'],
+ *   external: [...node.external, 'vitest'],
+ * }
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // Distribution package (@od-oneapp/*)
+ * import { createDistConfig } from '@od-oneapp/config/tsdown'
+ *
+ * export default createDistConfig('node', {
+ *   index: 'src/index.ts',
+ * }, {
+ *   external: ['better-auth'],
+ * })
+ * ```
+ */
+
+// Platform presets
+export { base } from './base.mjs';
+export { browser } from './browser.mjs';
+export { client } from './client.mjs';
+export { node } from './node.mjs';
+export { react } from './react.mjs';
+
+// Distribution build helper
+export {
+  createDistConfig,
+  distExternals,
+  internalPackages,
+  aiSdkExternals,
+  prismaTypeExternals,
+} from './dist.mjs';

package/tsdown/node.mjs

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Node.js platform preset - extends base with Node.js settings
+ *
+ * Use for: CLI tools, server libraries, testing utilities
+ *
+ * @example
+ * ```javascript
+ * import { node } from '@od-oneapp/config/tsdown'
+ *
+ * export default {
+ *   ...node,
+ *   entry: ['src/index.ts'],
+ *   external: [...node.external, 'vitest'],
+ * }
+ * ```
+ */
+
+import { base } from './base.mjs';
+
+/**
+ * Node.js platform configuration.
+ * Extends base with Node.js target and platform.
+ * @type {import('tsdown').UserConfig & { external: (string | RegExp)[] }}
+ */
+export const node = {
+  ...base,
+
+  // Target Node.js 20+ (current LTS)
+  target: 'node20',
+  platform: 'node',
+
+  // Add node: protocol for clarity in ESM
+  nodeProtocol: true,
+
+  // Common Node.js externals
+  external: [
+    /^node:/, // Node built-ins
+  ],
+};

package/tsdown/react.mjs

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview React library preset - extends browser with React externals
+ *
+ * Use for: React component libraries, hooks, contexts
+ *
+ * @example
+ * ```javascript
+ * import { react } from '@od-oneapp/config/tsdown'
+ *
+ * export default {
+ *   ...react,
+ *   entry: { index: 'src/index.ts' },
+ *   external: [...react.external, '@od-oneapp/uni-ui'],
+ * }
+ * ```
+ */
+
+import { browser } from './browser.mjs';
+
+/**
+ * React library configuration.
+ * Extends browser with React peer dependencies externalized.
+ * @type {import('tsdown').UserConfig & { external: (string | RegExp)[] }}
+ */
+export const react = {
+  ...browser,
+
+  // React peer dependencies - consumers provide these
+  external: [...browser.external, 'react', 'react-dom', /^react\//, /^react-dom\//],
+};

package/typescript/base.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    // Target: ES2024 for Node 22+ and modern browsers
+    "target": "ES2024",
+    "lib": ["ES2024"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "moduleDetection": "force",
+
+    // JavaScript support
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": false,
+
+    // JSX: preserve by default, overridden in react/nextjs configs
+    "jsx": "preserve",
+
+    // Output
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "removeComments": true,
+
+    // Interop
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+
+    // Strict mode (all strict checks enabled)
+    "strict": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "allowUnusedLabels": false,
+    "allowUnreachableCode": false,
+
+    // Unused variables: delegated to ESLint (unused-imports plugin)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+
+    // Module system
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+
+    // Performance
+    "skipLibCheck": true,
+    "incremental": true
+  },
+  "exclude": ["node_modules", "dist", ".next", "out", "build", "**/*.mjs"]
+}

package/typescript/dist/__tests__/browser-stub.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-stub.test.d.ts.map

package/typescript/dist/__tests__/browser-stub.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-stub.test.d.ts","sourceRoot":"","sources":["../../../../core-utils/__tests__/browser-stub.test.ts"],"names":[],"mappings":""}

package/typescript/dist/__tests__/browser-stub.test.js

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest';
+describe('browser-stub', () => {
+    it('throws clear error when trying to import server modules in browser environment', async () => {
+        const { notSupported } = await import('../src/server/browser-stub');
+        expect(() => notSupported()).toThrowError('@repo/core-utils/server/* modules are not available in browser/edge environments');
+    });
+    it('exports all expected server functions as stubs', async () => {
+        const stub = await import('../src/server/browser-stub');
+        expect(() => stub.BoundedCache()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.CacheRegistry()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.globalCacheRegistry()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.AsyncLogger()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.LoggerRegistry()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.globalLoggerRegistry()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.safeStringifyAdvanced()).toThrowError(/not available in browser\/edge environments/);
+        expect(() => stub.SafeStringifier()).toThrowError(/not available in browser\/edge environments/);
+    });
+    it('provides helpful error messages', async () => {
+        const { notSupported } = await import('../src/server/browser-stub');
+        expect(() => notSupported()).toThrowError(/Use @repo\/core-utils\/shared\/\* for environment-neutral utilities/);
+    });
+    it('throws error when calling PathSecurity.validatePath', async () => {
+        const { PathSecurity } = await import('../src/server/browser-stub');
+        expect(() => PathSecurity.validatePath('/some/path')).toThrowError(/not available in browser\/edge environments/);
+    });
+    it('throws error when calling PathSecurity.clearCachesForTests', async () => {
+        const { PathSecurity } = await import('../src/server/browser-stub');
+        expect(() => PathSecurity.clearCachesForTests()).toThrowError(/not available in browser\/edge environments/);
+    });
+    it('throws error when calling SafeRegexExecutor.execute', async () => {
+        const { SafeRegexExecutor } = await import('../src/server/browser-stub');
+        expect(() => SafeRegexExecutor.execute()).toThrowError(/not available in browser\/edge environments/);
+    });
+    it('exports default as notSupported', async () => {
+        const stubModule = await import('../src/server/browser-stub');
+        const notSupported = stubModule.default;
+        expect(() => notSupported()).toThrowError(/not available in browser\/edge environments/);
+    });
+});
+//# sourceMappingURL=browser-stub.test.js.map

package/typescript/dist/__tests__/browser-stub.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-stub.test.js","sourceRoot":"","sources":["../../../../core-utils/__tests__/browser-stub.test.ts"],"names":[],"mappings":"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"}

package/typescript/dist/__tests__/runtime/lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.test.d.ts.map

package/typescript/dist/__tests__/runtime/lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.d.ts","sourceRoot":"","sources":["../../../../../core-utils/__tests__/runtime/lifecycle.test.ts"],"names":[],"mappings":""}