polen 0.11.0-next.13 → 0.11.0-next.15

package/src/cli-effect/commands/open.ts

@@ -0,0 +1,183 @@
+import { Api } from '#api/index'
+import { Vite } from '#dep/vite/index'
+import { Grafaid } from '#lib/grafaid'
+import { GraphqlSchemaLoader } from '#lib/graphql-schema-loader'
+import { toViteUserConfig } from '#vite/config'
+import { Command, Options } from '@effect/cli'
+import { Err, Fs, Json, Path, Rec } from '@wollybeard/kit'
+import { Effect, Option } from 'effect'
+import { homedir } from 'node:os'
+import { allowGlobalParameter } from '../_/parameters.js'
+
+// Define introspection headers option
+const introspectionHeaders = Options.text('introspection-headers').pipe(
+  Options.withAlias('inh'),
+  Options.optional,
+  Options.withDescription(
+    'Include headers in the introspection query request sent when using --introspection-url. Format is JSON Object.',
+  ),
+)
+
+// Define mutually exclusive source options
+const introspectUrl = Options.text('introspect').pipe(
+  Options.withAlias('in'),
+  Options.withAlias('i'),
+  Options.optional,
+  Options.withDescription('Get the schema by sending a GraphQL introspection query to this URL.'),
+)
+
+const sdlPath = Options.text('sdl').pipe(
+  Options.withAlias('s'),
+  Options.optional,
+  Options.withDescription(
+    'Get the schema from a GraphQL Schema Definition Language file. Can be a path to a local file or an HTTP URL to a remote one.',
+  ),
+)
+
+const namedSchema = Options.choice('name', ['github', 'hive']).pipe(
+  Options.withAlias('n'),
+  Options.optional,
+  Options.withDescription(
+    'Pick from a well known public API. Polen already knows how to fetch the schema for these APIs.',
+  ),
+)
+
+const cache = Options.boolean('cache').pipe(
+  Options.withDefault(true),
+  Options.withDescription('Enable or disable caching. By default this command caches fetched schemas for re-use.'),
+)
+
+// Cache implementation
+const cacheDir = Path.join(homedir(), '.polen', 'cache', 'cli', 'open')
+
+const base64Codec = {
+  encode: (str: string) => Buffer.from(str).toString('base64'),
+  decode: (str: string) => Buffer.from(str, 'base64').toString('utf-8'),
+}
+
+const cacheWrite = async (source: string, schema: Grafaid.Schema.Schema, useCache: boolean) => {
+  if (!useCache) return
+
+  await Err.tryCatchIgnore(async () => {
+    const fileName = base64Codec.encode(source)
+    const filePath = Path.join(cacheDir, fileName)
+    const sdl = Grafaid.Schema.print(schema)
+    await Fs.write({ path: filePath, content: sdl })
+  })
+}
+
+const cacheRead = async (source: string, useCache: boolean) => {
+  if (!useCache) return null
+
+  return Err.tryCatchIgnore(async () => {
+    const fileName = base64Codec.encode(source)
+    const filePath = Path.join(cacheDir, fileName)
+    const sdl = await Fs.read(filePath)
+    if (!sdl) return null
+    const documentNode = await Effect.runPromise(Grafaid.Schema.AST.parse(sdl))
+    return await Effect.runPromise(Grafaid.Schema.fromAST(documentNode))
+  })
+}
+
+const wrapCache = (fn: typeof GraphqlSchemaLoader.load, useCache: boolean) => {
+  const wrapped = (...args: Parameters<typeof GraphqlSchemaLoader.load>) =>
+    Effect.gen(function*() {
+      const cacheKey = JSON.stringify(args)
+      const cachedSchema = yield* Effect.promise(() => cacheRead(cacheKey, useCache))
+
+      if (cachedSchema) {
+        return cachedSchema
+      }
+
+      // GraphqlSchemaLoader.load returns Effect<GraphQLSchema, Error, FileSystem>
+      const value = yield* fn(...args)
+
+      yield* Effect.promise(() => cacheWrite(cacheKey, value, useCache))
+
+      return value
+    })
+
+  return wrapped
+}
+
+const parseHeaders = (headersJsonEncoded: string): Record<string, string> => {
+  const headersJson = Json.codec.decode(headersJsonEncoded)
+  if (!Rec.is(headersJson)) {
+    throw new Error('--introspection-headers must be a JSON object.')
+  }
+  return headersJson as any
+}
+
+export const open = Command.make(
+  'open',
+  {
+    introspectionHeaders,
+    introspectUrl,
+    sdlPath,
+    namedSchema,
+    cache,
+    allowGlobal: allowGlobalParameter,
+  },
+  ({ introspectionHeaders, introspectUrl, sdlPath, namedSchema, cache, allowGlobal }) =>
+    Effect.gen(function*() {
+      // Validate that exactly one source option is provided
+      const introspectValue = Option.getOrUndefined(introspectUrl)
+      const sdlValue = Option.getOrUndefined(sdlPath)
+      const namedValue = Option.getOrUndefined(namedSchema)
+      const headersValue = Option.getOrUndefined(introspectionHeaders)
+
+      const sources = [introspectValue, sdlValue, namedValue].filter(Boolean)
+      if (sources.length === 0) {
+        return yield* Effect.fail(new Error('Must specify one of: --introspect, --sdl, or --name'))
+      }
+      if (sources.length > 1) {
+        return yield* Effect.fail(new Error('Cannot specify multiple source options'))
+      }
+
+      // Determine source type and value
+      let sourceConfig: any
+
+      if (introspectValue) {
+        sourceConfig = {
+          type: 'introspect',
+          url: introspectValue,
+          headers: headersValue ? parseHeaders(headersValue) : undefined,
+        }
+      } else if (sdlValue) {
+        sourceConfig = {
+          type: 'sdl',
+          pathOrUrl: sdlValue,
+        }
+      } else if (namedValue) {
+        sourceConfig = {
+          type: 'name',
+          name: namedValue,
+        }
+      }
+
+      const load = wrapCache(GraphqlSchemaLoader.load, cache)
+      const schema = yield* load(sourceConfig)
+
+      const tempDir = yield* Effect.promise(() => Fs.makeTemporaryDirectory())
+      const config = yield* Api.ConfigResolver.fromMemory({
+        schema: {
+          sources: {
+            memory: {
+              revisions: [
+                {
+                  date: new Date(),
+                  value: schema,
+                },
+              ],
+            },
+          },
+        },
+      }, tempDir)
+
+      const viteConfig = toViteUserConfig(config)
+      const viteDevServer = yield* Effect.promise(() => Vite.createServer(viteConfig))
+
+      yield* Effect.promise(() => viteDevServer.listen())
+      viteDevServer.printUrls()
+    }),
+)

package/src/cli-effect/commands/static/rebase.ts

@@ -0,0 +1,66 @@
+import { Api } from '#api/index'
+import { Args, Command, Options } from '@effect/cli'
+import { Effect, Option } from 'effect'
+import { allowGlobalParameter } from '../../_/parameters.js'
+
+const source = Args.text({ name: 'source' }).pipe(
+  Args.withDescription('Path to the Polen build directory to rebase'),
+)
+
+const newBasePath = Args.text({ name: 'newBasePath' }).pipe(
+  Args.withDescription('New base path for the build (e.g., /new-path/)'),
+)
+
+const target = Options.text('target').pipe(
+  Options.withAlias('t'),
+  Options.optional,
+  Options.withDescription('Target directory for copy mode (if not provided, mutate in place)'),
+)
+
+export const staticRebase = Command.make(
+  'rebase',
+  {
+    source,
+    newBasePath,
+    target,
+    allowGlobal: allowGlobalParameter,
+  },
+  ({ source, newBasePath, target, allowGlobal }) =>
+    Effect.gen(function*() {
+      const targetPath = Option.getOrUndefined(target)
+      const plan: Api.Static.RebasePlan = targetPath
+        ? {
+          changeMode: 'copy',
+          sourcePath: source,
+          targetPath: targetPath,
+          newBasePath,
+        }
+        : {
+          changeMode: 'mutate',
+          sourcePath: source,
+          newBasePath,
+        }
+
+      // Direct Effect execution with timing and error handling
+      const start = Date.now()
+
+      const result = yield* Effect.promise(() => Api.Static.rebase(plan))
+        .pipe(
+          Effect.tap(() => {
+            const duration = Date.now() - start
+            console.log(`Task: rebase`)
+            console.log(`Duration: ${duration}ms`)
+            console.log(`Input: ${JSON.stringify(plan, null, 2)}`)
+          }),
+          Effect.tapError((error) => {
+            const duration = Date.now() - start
+            console.error(`Task: rebase failed`)
+            console.error(`Duration: ${duration}ms`)
+            console.error(`Error:`, error)
+            return Effect.succeed(undefined)
+          }),
+        )
+
+      return result
+    }),
+)

package/src/cli-effect/commands/static.ts

@@ -0,0 +1,39 @@
+import { Command } from '@effect/cli'
+import $ from 'ansis'
+import { Console, Effect } from 'effect'
+
+// Import subcommands
+import { staticRebase } from './static/rebase.js'
+
+const h2 = (str: string) => {
+  return $.bold.black.bgWhiteBright(` ${str.toUpperCase()} `)
+}
+
+const code = (str: string) => {
+  if (!$.isSupported()) return `\`${str}\``
+  return $.magenta(str)
+}
+
+// Default static command that shows usage
+const staticDefault = Command.make(
+  'static',
+  {},
+  () =>
+    Effect.gen(function*() {
+      yield* Console.log(`${$.bold.redBright`POLEN 🌺`} ${$.dim(`static commands`)}`)
+      yield* Console.log('Manage static builds and deployments.')
+      yield* Console.log('')
+      yield* Console.log('')
+      yield* Console.log(`${h2('commands')}`)
+      yield* Console.log('')
+      yield* Console.log(`${$.dim`$ polen static`} ${$.cyanBright('rebase')}`)
+      yield* Console.log('')
+      yield* Console.log(`${$.dim`Get help for a command with ${code('polen static <command> --help')}`}`)
+      yield* Console.log('')
+    }),
+)
+
+// Export the static command with subcommands
+export const staticCommand = staticDefault.pipe(
+  Command.withSubcommands([staticRebase]),
+)

package/src/cli-effect/index.ts

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+import { checkGlobalVsLocal } from '#lib/kit-temp'
+import { Command } from '@effect/cli'
+import { NodeContext, NodeRuntime } from '@effect/platform-node'
+import { Console, Effect } from 'effect'
+import manifest from '../../package.json' with { type: 'json' }
+import { allowGlobalParameter } from './_/parameters.js'
+
+// Import all commands
+import { build } from './commands/build.js'
+import { cache } from './commands/cache.js'
+import { config } from './commands/config.js'
+import { create } from './commands/create.js'
+import { dev } from './commands/dev.js'
+import { open } from './commands/open.js'
+import { staticCommand } from './commands/static.js'
+
+// Define the main Polen command
+const polenMain = Command.make(
+  'polen',
+  { allowGlobal: allowGlobalParameter },
+  ({ allowGlobal }) => Console.log('Polen Effect CLI - Use --help to see available commands'),
+)
+
+// Combine all commands into the main CLI
+const command = polenMain.pipe(
+  Command.withSubcommands([
+    dev,
+    build,
+    create,
+    open,
+    cache,
+    config,
+    staticCommand,
+  ]),
+)
+
+// Set up and run the CLI application
+const cli = Command.run(command, {
+  name: 'Polen Effect CLI',
+  version: manifest.version,
+})
+
+// Handle version flag manually since Effect CLI handles it differently
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  console.log(manifest.version)
+  process.exit(0)
+}
+
+// Check for global vs local Polen conflict
+try {
+  await checkGlobalVsLocal({
+    packageName: 'polen',
+    currentExecutablePath: process.argv[1] ?? '',
+    errorMessageTemplate: {
+      title: 'Global Polen detected in project with local Polen',
+      explanation:
+        'You are running the global Polen CLI in a project that has Polen installed locally. This can cause version mismatches, cache conflicts, and unexpected behavior.',
+      solutions: [
+        'pnpm exec polen <command>',
+        'npx polen <command>',
+        './node_modules/.bin/polen <command>',
+      ],
+    },
+  })
+} catch (error) {
+  process.exit(1)
+}
+
+// Remove --allow-global from argv before dispatching to commands
+// This prevents "Unknown flag" errors in individual commands
+const filteredArgv = process.argv.filter(arg => arg !== '--allow-global')
+
+NodeRuntime.runMain(
+  cli(filteredArgv).pipe(
+    Effect.provide(NodeContext.layer),
+  ),
+)

package/src/dep/tiny-globby/index.ts

@@ -1 +1,2 @@
 export * as TinyGlobby from './tiny-globby.js'
+export { EffectGlobby } from './tiny-globby.js'

package/src/dep/tiny-globby/tiny-globby.ts

@@ -1 +1,28 @@
+import { Effect } from 'effect'
+import * as TinyGlobbyLib from 'tinyglobby'
+
+// Re-export original API for backwards compatibility
 export * from 'tinyglobby'
+
+// Effect-based wrappers
+export namespace EffectGlobby {
+  /**
+   * Effect-based wrapper for TinyGlobby.glob
+   */
+  export const glob = (
+    pattern: string | string[],
+    options?: Omit<TinyGlobbyLib.GlobOptions, 'patterns'>,
+  ): Effect.Effect<string[], Error> => Effect.promise(() => TinyGlobbyLib.glob(pattern, options))
+
+  /**
+   * Effect-based wrapper for TinyGlobby.globSync (wrapped as Effect for consistency)
+   */
+  export const globSync = (
+    pattern: string | string[],
+    options?: Omit<TinyGlobbyLib.GlobOptions, 'patterns'>,
+  ): Effect.Effect<string[], Error> =>
+    Effect.try({
+      try: () => TinyGlobbyLib.globSync(pattern, options),
+      catch: (error) => error instanceof Error ? error : new Error(String(error)),
+    })
+}

package/src/exports/polen.ts

@@ -1,3 +1,3 @@
-export { defineConfig } from '#api/config/config'
-export { type ConfigInput } from '#api/config/configurator'
-export { Main as VitePlugin } from '#api/vite/plugins/main'
+export { type ConfigInput, defineConfig } from '#api/config/input'
+export { Hooks } from '#api/hooks/helpers'
+export { Main as VitePlugin } from '#vite/plugins/main'

package/src/exports/radix-ui/react-icons.ts

@@ -0,0 +1,3 @@
+// Re-export Radix UI icons that users might want to use in their navbar
+// This allows users to import from 'polen/radix-ui/react-icons' without installing @radix-ui/react-icons
+export * from '@radix-ui/react-icons'

package/src/exports/radix-ui/themes.ts

@@ -0,0 +1,3 @@
+// Re-export Radix UI themes that Polen uses internally
+// This allows users to import from 'polen/radix-ui/themes' without installing @radix-ui/themes
+export * from '@radix-ui/themes'

package/src/lib/catalog/$.ts

@@ -0,0 +1 @@
+export * as Catalog from './catalog.js'

package/src/lib/catalog/catalog.ts

@@ -0,0 +1,73 @@
+import { S } from '#lib/kit-temp/effect'
+import { Schema } from '#lib/schema/$'
+import { Version } from '#lib/version/$'
+import * as Unversioned from './unversioned.js'
+import * as Versioned from './versioned.js'
+
+export * as Unversioned from './unversioned.js'
+export * as Versioned from './versioned.js'
+
+// ============================================================================
+// Schema
+// ============================================================================
+
+export const Catalog = S.Union(Versioned.Versioned, Unversioned.Unversioned).annotations({
+  identifier: 'Catalog',
+  title: 'Schema Catalog',
+  description: 'A catalog of GraphQL schemas and their revision history',
+})
+
+export type Catalog = S.Schema.Type<typeof Catalog>
+
+// ============================================================================
+// Type Guard
+// ============================================================================
+
+export const is = S.is(Catalog)
+
+// ============================================================================
+// Pattern Matching
+// ============================================================================
+
+export const fold = <$A>(
+  onVersioned: (catalog: Versioned.Versioned) => $A,
+  onUnversioned: (catalog: Unversioned.Unversioned) => $A,
+) =>
+(catalog: Catalog): $A => catalog._tag === 'CatalogVersioned' ? onVersioned(catalog) : onUnversioned(catalog)
+
+// ============================================================================
+// Codec
+// ============================================================================
+
+export const decode = S.decode(Catalog)
+export const encode = S.encode(Catalog)
+
+// ============================================================================
+// Equivalence
+// ============================================================================
+
+export const equivalence = S.equivalence(Catalog)
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Get the number of versions in a catalog.
+ * For versioned catalogs, this is the number of entries.
+ * For unversioned catalogs, this is always 1.
+ */
+export const getVersionCount = (catalog: Catalog): number =>
+  fold(
+    (versioned) => versioned.entries.length,
+    (_unversioned) => 1, // Unversioned catalog is effectively one version
+  )(catalog)
+
+/**
+ * Get the version string from a schema.
+ * Returns the stringified version for versioned schemas, or '__UNVERSIONED__' for unversioned schemas.
+ */
+export const getSchemaVersionString = (schema: Schema.Schema): string => {
+  const version = Schema.getVersion(schema)
+  return version ? Version.toString(version) : '__UNVERSIONED__'
+}

package/src/lib/catalog/unversioned.ts

@@ -0,0 +1,42 @@
+import { S } from '#lib/kit-temp/effect'
+import { Schema } from '../schema/$.js'
+
+// ============================================================================
+// Schema
+// ============================================================================
+
+export const Unversioned = S.TaggedStruct('CatalogUnversioned', {
+  schema: Schema.Unversioned.Unversioned,
+}).annotations({
+  identifier: 'CatalogUnversioned',
+  title: 'Unversioned Catalog',
+  description: 'A catalog of an unversioned GraphQL schema with its revision history',
+  adt: { name: 'Catalog' },
+})
+
+export type Unversioned = S.Schema.Type<typeof Unversioned>
+
+// ============================================================================
+// Constructors
+// ============================================================================
+
+export const make = Unversioned.make
+
+// ============================================================================
+// Guards
+// ============================================================================
+
+export const is = S.is(Unversioned)
+
+// ============================================================================
+// Codecs
+// ============================================================================
+
+export const decode = S.decode(Unversioned)
+export const encode = S.encode(Unversioned)
+
+// ============================================================================
+// Equivalence
+// ============================================================================
+
+export const equivalence = S.equivalence(Unversioned)

package/src/lib/catalog/versioned.ts

@@ -0,0 +1,42 @@
+import { S } from '#lib/kit-temp/effect'
+import { Schema } from '../schema/$.js'
+
+// ============================================================================
+// Schema
+// ============================================================================
+
+export const Versioned = S.TaggedStruct('CatalogVersioned', {
+  entries: S.Array(Schema.Versioned.Versioned),
+}).annotations({
+  identifier: 'CatalogVersioned',
+  title: 'Versioned Catalog',
+  description: 'A catalog of versioned GraphQL schemas with their revision history',
+  adt: { name: 'Catalog' },
+})
+
+export type Versioned = S.Schema.Type<typeof Versioned>
+
+// ============================================================================
+// Constructors
+// ============================================================================
+
+export const make = Versioned.make
+
+// ============================================================================
+// Guards
+// ============================================================================
+
+export const is = S.is(Versioned)
+
+// ============================================================================
+// Codecs
+// ============================================================================
+
+export const decode = S.decode(Versioned)
+export const encode = S.encode(Versioned)
+
+// ============================================================================
+// Equivalence
+// ============================================================================
+
+export const equivalence = S.equivalence(Versioned)

package/src/lib/change/$$.ts

@@ -0,0 +1,3 @@
+export { calcChangeset } from './calc-changeset.js'
+export * from './change.js'
+export * as Criticality from './criticality.js'

package/src/lib/change/$.ts

@@ -0,0 +1 @@
+export * as Change from './$$.js'