@boon4681/giri 0.0.3-alpha-2 → 0.0.3-alpha-4

package/README.md

@@ -228,6 +228,46 @@ yarn sync
 yarn dev
 ```
 
+## Portable runtime
+
+`@boon4681/giri/runtime` is the portable composition layer for generated integrations. It does
+not implement routing itself: it accepts a complete `GiriAdapter`, creates that adapter's app, and
+registers statically imported route modules. Hono is the supported adapter today:
+
+```ts
+import { createApp } from "@boon4681/giri/runtime";
+import { hono } from "@boon4681/giri/adapters/hono";
+import * as rootShared from "./src/routes/+shared";
+import * as usersGet from "./src/routes/users/+get";
+
+export const app = createApp({
+    adapter: hono(),
+    services: { source: "playground" },
+    routes: [
+        {
+            method: "GET",
+            path: "/api/users",
+            module: usersGet,
+            shared: [rootShared],
+        },
+    ],
+});
+```
+
+The result is a normal Fetch application:
+
+```ts
+const response = await app.fetch(new Request("https://example.test/api/users"));
+```
+
+`app` is the native Hono application, so SvelteKit or Next.js can forward a framework request
+directly to `app.fetch(request)`. This is the low-level target for virtual modules such as
+`@giri/project-1`; the Vite integration should generate the route descriptor array.
+
+The shipped Hono adapter also owns its Node server binding. A browser playground should provide a
+different `GiriAdapter` implementation whose `createApp`, `register`, `fetch`, and `serve` methods
+bind to the desired browser runtime; `createApp` itself does not special-case that environment.
+
 ## License
 
-MIT
+MIT

package/dist/adapters/hono.d.ts

@@ -1,5 +1,5 @@
 import { ContextVariableMap, Hono, MiddlewareHandler } from 'hono';
-import { M as Middleware, V as ValidatedInput, G as GiriAdapter } from '../types-BvRph0mx.js';
+import { M as Middleware, V as ValidatedInput, G as GiriAdapter } from '../types-DZ-14IP6.js';
 
 type HonoGiriApp = Hono;
 type HonoContextVars = {

package/dist/cli.js

@@ -1421,7 +1421,12 @@ function inputToJsonSchema(schema) {
   if (!isGiriInputSchema(schema)) {
     return void 0;
   }
-  return sanitize(schema.toJsonSchema());
+  try {
+    return sanitize(schema.toJsonSchema());
+  } catch (error) {
+    console.warn(`giri: skipped a request schema that can't be represented as JSON Schema (${error.message}).`);
+    return void 0;
+  }
 }
 function bodyToJsonSchemas(value) {
   if (!isGiriBodySchema(value)) {
@@ -1437,6 +1442,46 @@ function bodyToJsonSchemas(value) {
   return Object.keys(out).length > 0 ? out : void 0;
 }
 
+// src/generator/schema/route-openapi.ts
+var import_typebox2 = require("@sinclair/typebox");
+var import_value2 = require("@sinclair/typebox/value");
+var StringSchema = import_typebox2.Type.String();
+var BooleanSchema = import_typebox2.Type.Boolean();
+var StringArraySchema = import_typebox2.Type.Array(StringSchema);
+var routeOpenApiSchema = import_typebox2.Type.Object(
+  {
+    hidden: import_typebox2.Type.Optional(BooleanSchema),
+    tags: import_typebox2.Type.Optional(StringArraySchema),
+    summary: import_typebox2.Type.Optional(StringSchema),
+    description: import_typebox2.Type.Optional(StringSchema),
+    deprecated: import_typebox2.Type.Optional(BooleanSchema),
+    operationId: import_typebox2.Type.Optional(StringSchema)
+  },
+  { additionalProperties: true }
+);
+function pick(schema, value) {
+  return import_value2.Value.Check(schema, value) ? value : void 0;
+}
+function parseRouteOpenApi(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const o = value;
+  const parsed = {};
+  if ("hidden" in o) {
+    parsed.hidden = Boolean(o.hidden);
+  }
+  const tags = pick(StringArraySchema, o.tags);
+  if (tags) {
+    parsed.tags = tags;
+  }
+  parsed.summary = pick(StringSchema, o.summary);
+  parsed.description = pick(StringSchema, o.description);
+  parsed.operationId = pick(StringSchema, o.operationId);
+  parsed.deprecated = pick(BooleanSchema, o.deprecated);
+  return parsed;
+}
+
 // src/generator/route-meta.ts
 function loadModule2(file) {
   const resolved = require.resolve(file);
@@ -1749,27 +1794,27 @@ function resolveOpenApi(route, routeModule, loadShared) {
       hidden = false;
       return;
     }
-    if (!value || typeof value !== "object") {
+    const parsed = parseRouteOpenApi(value);
+    if (!parsed) {
       return;
     }
-    const o = value;
-    if ("hidden" in o) {
-      hidden = Boolean(o.hidden);
+    if (parsed.hidden !== void 0) {
+      hidden = parsed.hidden;
     }
-    if (Array.isArray(o.tags)) {
-      tags.push(...o.tags.filter((tag2) => typeof tag2 === "string"));
+    if (parsed.tags) {
+      tags.push(...parsed.tags);
     }
-    if (typeof o.summary === "string") {
-      meta.summary = o.summary;
+    if (parsed.summary !== void 0) {
+      meta.summary = parsed.summary;
     }
-    if (typeof o.description === "string") {
-      meta.description = o.description;
+    if (parsed.description !== void 0) {
+      meta.description = parsed.description;
     }
-    if (typeof o.deprecated === "boolean") {
-      meta.deprecated = o.deprecated;
+    if (parsed.deprecated !== void 0) {
+      meta.deprecated = parsed.deprecated;
     }
-    if (isVerb && typeof o.operationId === "string") {
-      meta.operationId = o.operationId;
+    if (isVerb && parsed.operationId !== void 0) {
+      meta.operationId = parsed.operationId;
     }
   };
   for (const file of route.sharedFiles) {