@effect/platform 0.69.10 → 0.69.11

package/dist/esm/internal/httpApiSwagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpApiSwagger.js","names":["javascript","css"],"sources":["../../../src/internal/httpApiSwagger.ts"],"sourcesContent":[null],"mappings":"AAAA,qBAEA,gBACA,MAAO,MAAM,CAAAA,UAAU,CAAG,m1lpDAAm1lpD,CAE72lpD,gBACA,MAAO,MAAM,CAAAC,GAAG,CAAG,wopJAAwopJ","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect/platform",
-  "version": "0.69.10",
+  "version": "0.69.11",
   "description": "Unified interfaces for common platform-specific services",
   "license": "MIT",
   "repository": {
@@ -14,7 +14,7 @@
     "multipasta": "^0.2.5"
   },
   "peerDependencies": {
-    "effect": "^3.10.5"
+    "effect": "^3.10.6"
   },
   "publishConfig": {
     "provenance": true
@@ -109,6 +109,11 @@
       "import": "./dist/esm/HttpApiMiddleware.js",
       "default": "./dist/cjs/HttpApiMiddleware.js"
     },
+    "./HttpApiScalar": {
+      "types": "./dist/dts/HttpApiScalar.d.ts",
+      "import": "./dist/esm/HttpApiScalar.js",
+      "default": "./dist/cjs/HttpApiScalar.js"
+    },
     "./HttpApiSchema": {
       "types": "./dist/dts/HttpApiSchema.d.ts",
       "import": "./dist/esm/HttpApiSchema.js",
@@ -345,6 +350,9 @@
       "HttpApiMiddleware": [
         "./dist/dts/HttpApiMiddleware.d.ts"
       ],
+      "HttpApiScalar": [
+        "./dist/dts/HttpApiScalar.d.ts"
+      ],
       "HttpApiSchema": [
         "./dist/dts/HttpApiSchema.d.ts"
       ],

package/src/HttpApiError.ts

@@ -90,7 +90,7 @@ export class HttpApiDecodeError extends Schema.TaggedError<HttpApiDecodeError>()
   },
   HttpApiSchema.annotations({
     status: 400,
-    description: "HttpApiDecodeError: The request did not match the expected schema"
+    description: "The request did not match the expected schema"
   })
 ) {
   /**

package/src/HttpApiScalar.ts

@@ -0,0 +1,187 @@
+/**
+ * @since 1.0.0
+ */
+import * as Effect from "effect/Effect"
+import type { Layer } from "effect/Layer"
+import { Api } from "./HttpApi.js"
+import { Router } from "./HttpApiBuilder.js"
+import * as HttpServerResponse from "./HttpServerResponse.js"
+import * as internal from "./internal/httpApiScalar.js"
+import * as OpenApi from "./OpenApi.js"
+
+/**
+ * @since 1.0.0
+ * @category model
+ */
+export type ScalarThemeId =
+  | "alternate"
+  | "default"
+  | "moon"
+  | "purple"
+  | "solarized"
+  | "bluePlanet"
+  | "deepSpace"
+  | "saturn"
+  | "kepler"
+  | "mars"
+  | "none"
+
+/**
+ * @since 1.0.0
+ * @category model
+ *
+ * cdn: `https://cdn.jsdelivr.net/npm/@scalar/api-reference@${source.version}/dist/browser/standalone.min.js`
+ */
+export type ScalarScriptSource =
+  | string
+  | { type: "default" }
+  | {
+    type: "cdn"
+    version?: "latest" | (string & {})
+  }
+
+/**
+ * @since 1.0.0
+ * @category model
+ * @see https://github.com/scalar/scalar/blob/main/documentation/configuration.md
+ */
+export type ScalarConfig = {
+  /** A string to use one of the color presets */
+  theme?: ScalarThemeId
+  /** The layout to use for the references */
+  layout?: "modern" | "classic"
+  /** URL to a request proxy for the API client */
+  proxy?: string
+  /** Whether the spec input should show */
+  isEditable?: boolean
+  /** Whether to show the sidebar */
+  showSidebar?: boolean
+  /**
+   * Whether to show models in the sidebar, search, and content.
+   *
+   * @default false
+   */
+  hideModels?: boolean
+  /**
+   * Whether to show the “Download OpenAPI Document” button
+   *
+   * @default false
+   */
+  hideDownloadButton?: boolean
+  /**
+   * Whether to show the “Test Request” button
+   *
+   * @default: false
+   */
+  hideTestRequestButton?: boolean
+  /**
+   * Whether to show the sidebar search bar
+   *
+   * @default: false
+   */
+  hideSearch?: boolean
+  /** Whether dark mode is on or off initially (light mode) */
+  darkMode?: boolean
+  /** forceDarkModeState makes it always this state no matter what*/
+  forceDarkModeState?: "dark" | "light"
+  /** Whether to show the dark mode toggle */
+  hideDarkModeToggle?: boolean
+  /**
+   * Path to a favicon image
+   *
+   * @default undefined
+   * @example '/favicon.svg'
+   */
+  favicon?: string
+  /** Custom CSS to be added to the page */
+  customCss?: string
+  /**
+   * The baseServerURL is used when the spec servers are relative paths and we are using SSR.
+   * On the client we can grab the window.location.origin but on the server we need
+   * to use this prop.
+   *
+   * @default undefined
+   * @example 'http://localhost:3000'
+   */
+  baseServerURL?: string
+  /**
+   * We’re using Inter and JetBrains Mono as the default fonts. If you want to use your own fonts, set this to false.
+   *
+   * @default true
+   */
+  withDefaultFonts?: boolean
+  /**
+   * By default we only open the relevant tag based on the url, however if you want all the tags open by default then set this configuration option :)
+   *
+   * @default false
+   */
+  defaultOpenAllTags?: boolean
+}
+
+/**
+ * @since 1.0.0
+ * @category layers
+ */
+export const layer = (options?: {
+  readonly path?: `/${string}` | undefined
+  readonly source?: ScalarScriptSource
+  readonly scalar?: ScalarConfig
+}): Layer<never, never, Api> =>
+  Router.use((router) =>
+    Effect.gen(function*() {
+      const { api } = yield* Api
+      const spec = OpenApi.fromApi(api)
+
+      const source = options?.source
+      const defaultScript = internal.javascript
+      const src: string | null = source
+        ? typeof source === "string"
+          ? source
+          : source.type === "cdn"
+          ? `https://cdn.jsdelivr.net/npm/@scalar/api-reference@${
+            source.version ?? "latest"
+          }/dist/browser/standalone.min.js`
+          : null
+        : null
+
+      const scalarConfig = {
+        _integration: "http",
+        ...options?.scalar
+      }
+
+      const response = HttpServerResponse.html(`<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>${spec.info.title}</title>
+    ${
+        !spec.info.description
+          ? ""
+          : `<meta name="description" content="${spec.info.description}"/>`
+      }
+    ${
+        !spec.info.description
+          ? ""
+          : `<meta name="og:description" content="${spec.info.description}"/>`
+      }
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1" />
+  </head>
+  <body>
+    <script id="api-reference" type="application/json">
+      ${JSON.stringify(spec)}
+    </script>
+    <script>
+      document.getElementById('api-reference').dataset.configuration = JSON.stringify(${JSON.stringify(scalarConfig)})
+    </script>
+    ${
+        src
+          ? `<script src="${src}" crossorigin></script>`
+          : `<script>${defaultScript}</script>`
+      }
+  </body>
+</html>`)
+      yield* router.get(options?.path ?? "/docs", Effect.succeed(response))
+    })
+  )

package/src/HttpApiSwagger.ts

@@ -6,7 +6,7 @@ import type { Layer } from "effect/Layer"
 import { Api } from "./HttpApi.js"
 import { Router } from "./HttpApiBuilder.js"
 import * as HttpServerResponse from "./HttpServerResponse.js"
-import * as internal from "./internal/apiSwagger.js"
+import * as internal from "./internal/httpApiSwagger.js"
 import * as OpenApi from "./OpenApi.js"
 
 /**

package/src/index.ts

@@ -78,6 +78,11 @@ export * as HttpApiGroup from "./HttpApiGroup.js"
  */
 export * as HttpApiMiddleware from "./HttpApiMiddleware.js"
 
+/**
+ * @since 1.0.0
+ */
+export * as HttpApiScalar from "./HttpApiScalar.js"
+
 /**
  * @since 1.0.0
  */