@fragno-dev/core 0.1.11 → 0.2.0

package/src/mod-client.ts

@@ -35,7 +35,7 @@ export function defineFragment(_name: string) {
     name: _name,
   };
 
-  const stub = {
+  const stubMethods = {
     withDependencies: () => stub,
     providesBaseService: () => stub,
     providesService: () => stub,
@@ -48,7 +48,21 @@ export function defineFragment(_name: string) {
     withLinkedFragment: () => stub,
     extend: () => stub,
     build: () => definitionStub,
+    // From fragno-db
+    provideHooks: () => stub,
   };
+
+  // Wrap with Proxy to handle any additional methods (e.g. from extend())
+  const stub: object = new Proxy(stubMethods, {
+    get(target, prop) {
+      if (prop in target) {
+        return target[prop as keyof typeof target];
+      }
+      // Return a function that returns the stub for method chaining
+      return () => stub;
+    },
+  });
+
   return stub;
 }
 
@@ -58,7 +72,7 @@ export { FragmentDefinitionBuilder } from "./api/fragment-definition-builder";
 // Stub implementation for instantiate
 // This is stripped by unplugin-fragno in browser builds
 export function instantiate(_definition: unknown) {
-  const fragmentStub: IFragnoInstantiatedFragment = {
+  const fragmentStubMethods = {
     [instantiatedFragmentFakeSymbol]: instantiatedFragmentFakeSymbol,
     name: "",
     routes: [],
@@ -71,10 +85,7 @@ export function instantiate(_definition: unknown) {
         linkedFragments: {},
       };
     },
-    withMiddleware: () => {
-      // throw new Error("withMiddleware is not supported in browser builds");
-      return fragmentStub;
-    },
+    withMiddleware: () => fragmentStub,
     inContext: <T>(callback: () => T) => callback(),
     handlersFor: () => ({}),
     handler: async () => new Response(),
@@ -82,7 +93,21 @@ export function instantiate(_definition: unknown) {
     callRouteRaw: async () => new Response(),
   };
 
-  const builderStub: IFragmentInstantiationBuilder = {
+  // Wrap with Proxy to handle any additional methods
+  const fragmentStub: IFragnoInstantiatedFragment = new Proxy(
+    fragmentStubMethods as IFragnoInstantiatedFragment,
+    {
+      get(target, prop) {
+        if (prop in target) {
+          return target[prop as keyof typeof target];
+        }
+        // Return a function that returns the stub for method chaining
+        return () => fragmentStub;
+      },
+    },
+  );
+
+  const builderStubMethods = {
     withConfig: () => builderStub,
     withRoutes: () => builderStub,
     withOptions: () => builderStub,
@@ -94,6 +119,20 @@ export function instantiate(_definition: unknown) {
     options: undefined,
   };
 
+  // Wrap with Proxy to handle any additional methods
+  const builderStub: IFragmentInstantiationBuilder = new Proxy(
+    builderStubMethods as IFragmentInstantiationBuilder,
+    {
+      get(target, prop) {
+        if (prop in target) {
+          return target[prop as keyof typeof target];
+        }
+        // Return a function that returns the stub for method chaining
+        return () => builderStub;
+      },
+    },
+  );
+
   return builderStub;
 }
 
@@ -102,6 +141,11 @@ export function instantiate(_definition: unknown) {
 // ============================================================================
 export type { FragnoPublicConfig } from "./api/shared-types";
 
+// ============================================================================
+// Runtime
+// ============================================================================
+export { defaultFragnoRuntime, type FragnoRuntime } from "./runtime";
+
 // ============================================================================
 // Route Definition
 // ============================================================================

package/src/mod.ts

@@ -25,6 +25,11 @@ export {
 // ============================================================================
 export type { FragnoPublicConfig } from "./api/shared-types";
 
+// ============================================================================
+// Runtime
+// ============================================================================
+export { defaultFragnoRuntime, type FragnoRuntime } from "./runtime";
+
 // ============================================================================
 // Route Definition
 // ============================================================================
@@ -35,4 +40,4 @@ export {
   type RouteFactoryContext,
 } from "./api/route";
 
-export { type FragnoRouteConfig, type RequestThisContext } from "./api/api";
+export { type FragnoRouteConfig, type RequestThisContext, type RouteContentType } from "./api/api";

package/src/runtime.ts

@@ -0,0 +1,48 @@
+import { createId } from "@paralleldrive/cuid2";
+
+export type FragnoRuntime = {
+  time: {
+    now: () => Date;
+  };
+  random: {
+    float: () => number;
+    uuid: () => string;
+    cuid: () => string;
+  };
+};
+
+const fallbackUuid = () => {
+  const bytes = new Uint8Array(16);
+  for (let i = 0; i < bytes.length; i += 1) {
+    bytes[i] = Math.floor(Math.random() * 256);
+  }
+
+  // RFC 4122 variant + version 4
+  bytes[6] = (bytes[6] & 0x0f) | 0x40;
+  bytes[8] = (bytes[8] & 0x3f) | 0x80;
+
+  const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0"));
+  return [
+    hex.slice(0, 4).join(""),
+    hex.slice(4, 6).join(""),
+    hex.slice(6, 8).join(""),
+    hex.slice(8, 10).join(""),
+    hex.slice(10, 16).join(""),
+  ].join("-");
+};
+
+const defaultUuid = () => {
+  const cryptoApi = globalThis.crypto;
+  return cryptoApi?.randomUUID ? cryptoApi.randomUUID() : fallbackUuid();
+};
+
+export const defaultFragnoRuntime: FragnoRuntime = {
+  time: {
+    now: () => new Date(),
+  },
+  random: {
+    float: () => Math.random(),
+    uuid: () => defaultUuid(),
+    cuid: () => createId(),
+  },
+};

package/src/test/test.ts

@@ -6,7 +6,12 @@ import {
   type FragmentDefinition,
   type ServiceConstructorFn,
 } from "../api/fragment-definition-builder";
-import { instantiateFragment, type FragnoInstantiatedFragment } from "../api/fragment-instantiator";
+import {
+  instantiateFragment,
+  type AnyFragnoInstantiatedFragment,
+  type FragnoInstantiatedFragment,
+  type RoutesWithInternal,
+} from "../api/fragment-instantiator";
 import type { BoundServices } from "../api/bind-services";
 
 // Re-export for convenience
@@ -200,6 +205,7 @@ export function createFragmentForTest<
   THandlerThisContext extends RequestThisContext,
   TRequestStorage,
   const TRoutesOrFactories extends readonly AnyRouteOrFactory[],
+  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},
 >(
   definition: FragmentDefinition<
     TConfig,
@@ -211,17 +217,20 @@ export function createFragmentForTest<
     TPrivateServices,
     TServiceThisContext,
     THandlerThisContext,
-    TRequestStorage
+    TRequestStorage,
+    TLinkedFragments
   >,
   routesOrFactories: TRoutesOrFactories,
   options: CreateFragmentForTestOptions<TConfig, TOptions, TServiceDependencies>,
 ): FragnoInstantiatedFragment<
-  FlattenRouteFactories<TRoutesOrFactories>,
+  RoutesWithInternal<FlattenRouteFactories<TRoutesOrFactories>, TLinkedFragments>,
   TDeps,
   BoundServices<TBaseServices & TServices>,
   TServiceThisContext,
   THandlerThisContext,
-  TRequestStorage
+  TRequestStorage,
+  TOptions,
+  TLinkedFragments
 > {
   const { config, options: fragmentOptions = {} as TOptions, serviceImplementations } = options;
 

package/tsdown.config.ts

@@ -22,6 +22,7 @@ export default defineConfig({
     "./src/integrations/react-ssr.ts",
     "./src/integrations/svelte-kit.ts",
     "./src/test/test.ts",
+    "./src/internal/trace-context.ts",
     "./src/internal/symbols.ts",
   ],
   dts: true,