@fragno-dev/core 0.1.7 → 0.1.9

package/dist/client/vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue.js","names":["ref","pathParams: Record<string, string | ReadableAtom<string>>","queryParams: Record<string, string | ReadableAtom<string>>","computed"],"sources":["../../src/client/vue.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { atom, type ReadableAtom, type Store, type StoreValue } from \"nanostores\";\nimport type { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from \"vue\";\nimport { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from \"vue\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  type FragnoClientMutatorData,\n  type FragnoClientHookData,\n} from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport type { MaybeExtractPathParamsOrWiden, QueryParamsHint } from \"../api/internal/path\";\nimport type { InferOr } from \"../util/types-util\";\n\nexport type FragnoVueHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n  query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n}) => {\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n};\n\nexport type FragnoVueMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: (args: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n    query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean | undefined>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n};\n\n/**\n * Converts a Vue Ref to a NanoStore Atom.\n *\n * This is used to convert Vue refs to atoms, so that we can use them in the store.\n *\n * @private\n */\nexport function refToAtom<T>(ref: Ref<T>): ReadableAtom<T> {\n  const a = atom(ref.value);\n\n  watch(ref, (newVal) => {\n    a.set(newVal);\n  });\n\n  // TODO: Do we need to unsubscribe, or is this handled by `onScopeDispose` below?\n\n  return a;\n}\n\n// Helper function to create a Vue composable from a GET hook\n// We want 1 store per hook, so on updates to params, we need to update the store instead of creating a new one.\n// Nanostores only works with atoms (or strings), so we need to convert vue refs to atoms.\nfunction createVueHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoVueHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParams: Record<string, string | ReadableAtom<string>> = {};\n    const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n    for (const [key, value] of Object.entries(path ?? {})) {\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      pathParams[key] = isRef(v) ? refToAtom(v) : v;\n    }\n\n    for (const [key, value] of Object.entries(query ?? {})) {\n      // Dunno why the cast is necessary\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      queryParams[key] = isRef(v) ? (refToAtom(v) as ReadableAtom<string>) : v;\n    }\n\n    const store = hook.store({\n      path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n      query: queryParams,\n    });\n\n    const data = ref();\n    const loading = ref();\n    const error = ref();\n\n    const unsubscribe = store.subscribe((updatedStoreValue) => {\n      data.value = updatedStoreValue.data;\n      loading.value = updatedStoreValue.loading;\n      error.value = updatedStoreValue.error;\n    });\n\n    if (getCurrentScope()) {\n      onScopeDispose(() => {\n        unsubscribe();\n      });\n    }\n\n    return {\n      data,\n      loading,\n      error,\n    };\n  };\n}\n\n// Helper function to create a Vue mutator from a mutator hook\nfunction createVueMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoVueMutator<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return () => {\n    const store = useStore(hook.mutatorStore);\n\n    // Create a wrapped mutate function that handles Vue refs\n    const mutate = async (args: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n      query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n    }) => {\n      const { body, path, query } = args;\n\n      const pathParams: Record<string, string | ReadableAtom<string>> = {};\n      const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n      for (const [key, value] of Object.entries(path ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        pathParams[key] = isRef(v) ? v.value : v;\n      }\n\n      for (const [key, value] of Object.entries(query ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        queryParams[key] = isRef(v) ? v.value : v;\n      }\n\n      // Call the store's mutate function with normalized params\n      return store.value.mutate({\n        body,\n        path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n        query: queryParams,\n      });\n    };\n\n    // Return the store-like object with Vue reactive refs\n    return {\n      mutate,\n      loading: computed(() => store.value.loading),\n      error: computed(() => store.value.error),\n      data: computed(() => store.value.data) as Ref<InferOr<TOutputSchema, undefined>>,\n    };\n  };\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoVueHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer M,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>\n      : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any;\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createVueHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createVueMutator(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n\nexport function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(\n  store: SomeStore,\n): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>> {\n  const state = shallowRef();\n\n  const unsubscribe = store.subscribe((value) => {\n    state.value = value;\n  });\n\n  if (getCurrentScope()) {\n    onScopeDispose(unsubscribe);\n  }\n\n  return state;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,UAAa,OAA8B;CACzD,MAAM,IAAI,KAAKA,MAAI,MAAM;AAEzB,OAAMA,QAAM,WAAW;AACrB,IAAE,IAAI,OAAO;GACb;AAIF,QAAO;;AAMT,SAAS,cAOP,MAC4E;AAC5E,SAAQ,EAAE,MAAM,UAAU,EAAE,KAAK;EAC/B,MAAMC,aAA4D,EAAE;EACpE,MAAMC,cAA6D,EAAE;AAErE,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;GACrD,MAAM,IAAI;AACV,cAAW,OAAO,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG;;AAG9C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;GAEtD,MAAM,IAAI;AACV,eAAY,OAAO,MAAM,EAAE,GAAI,UAAU,EAAE,GAA4B;;EAGzE,MAAM,QAAQ,KAAK,MAAM;GACvB,MAAM;GACN,OAAO;GACR,CAAC;EAEF,MAAM,OAAO,KAAK;EAClB,MAAM,UAAU,KAAK;EACrB,MAAM,QAAQ,KAAK;EAEnB,MAAM,cAAc,MAAM,WAAW,sBAAsB;AACzD,QAAK,QAAQ,kBAAkB;AAC/B,WAAQ,QAAQ,kBAAkB;AAClC,SAAM,QAAQ,kBAAkB;IAChC;AAEF,MAAI,iBAAiB,CACnB,sBAAqB;AACnB,gBAAa;IACb;AAGJ,SAAO;GACL;GACA;GACA;GACD;;;AAKL,SAAS,iBAQP,MAQ6F;AAC7F,cAAa;EACX,MAAM,QAAQ,SAAS,KAAK,aAAa;EAGzC,MAAM,SAAS,OAAO,SAIhB;GACJ,MAAM,EAAE,MAAM,MAAM,UAAU;GAE9B,MAAMD,aAA4D,EAAE;GACpE,MAAMC,cAA6D,EAAE;AAErE,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;IACrD,MAAM,IAAI;AACV,eAAW,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAGzC,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;IACtD,MAAM,IAAI;AACV,gBAAY,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAI1C,UAAO,MAAM,MAAM,OAAO;IACxB;IACA,MAAM;IACN,OAAO;IACR,CAAC;;AAIJ,SAAO;GACL;GACA,SAASC,iBAAe,MAAM,MAAM,QAAQ;GAC5C,OAAOA,iBAAe,MAAM,MAAM,MAAM;GACxC,MAAMA,iBAAe,MAAM,MAAM,KAAK;GACvC;;;AAIL,SAAgB,UACd,WAoBA;CAEA,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,WAAW;AAC3B,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,CACvD;EAGF,MAAM,OAAO,UAAU;AACvB,MAAI,UAAU,KAAK,CACjB,QAAO,OAAO,cAAc,KAAK;WACxB,cAAc,KAAK,CAC5B,QAAO,OAAO,iBAAiB,KAAK;MAGpC,QAAO,OAAO;;AAIlB,QAAO;;AAGT,SAAgB,SACd,OACmD;CACnD,MAAM,QAAQ,YAAY;CAE1B,MAAM,cAAc,MAAM,WAAW,UAAU;AAC7C,QAAM,QAAQ;GACd;AAEF,KAAI,iBAAiB,CACnB,gBAAe,YAAY;AAG7B,QAAO"}
+{"version":3,"file":"vue.js","names":["ref","pathParams: Record<string, string | ReadableAtom<string>>","queryParams: Record<string, string | ReadableAtom<string>>","computed"],"sources":["../../src/client/vue.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { atom, type ReadableAtom, type Store, type StoreValue } from \"nanostores\";\nimport type { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from \"vue\";\nimport { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from \"vue\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  type FragnoClientMutatorData,\n  type FragnoClientHookData,\n} from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport type { MaybeExtractPathParamsOrWiden, QueryParamsHint } from \"../api/internal/path\";\nimport type { InferOr } from \"../util/types-util\";\n\nexport type FragnoVueHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n  query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n}) => {\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n};\n\nexport type FragnoVueMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: (args: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n    query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean | undefined>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n};\n\n/**\n * Converts a Vue Ref to a NanoStore Atom.\n *\n * This is used to convert Vue refs to atoms, so that we can use them in the store.\n *\n * @private\n */\nexport function refToAtom<T>(ref: Ref<T>): ReadableAtom<T> {\n  const a = atom(ref.value);\n\n  watch(ref, (newVal) => {\n    a.set(newVal);\n  });\n\n  // TODO: Do we need to unsubscribe, or is this handled by `onScopeDispose` below?\n\n  return a;\n}\n\n// Helper function to create a Vue composable from a GET hook\n// We want 1 store per hook, so on updates to params, we need to update the store instead of creating a new one.\n// Nanostores only works with atoms (or strings), so we need to convert vue refs to atoms.\nfunction createVueHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoVueHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParams: Record<string, string | ReadableAtom<string>> = {};\n    const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n    for (const [key, value] of Object.entries(path ?? {})) {\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      pathParams[key] = isRef(v) ? refToAtom(v) : v;\n    }\n\n    for (const [key, value] of Object.entries(query ?? {})) {\n      // Dunno why the cast is necessary\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      queryParams[key] = isRef(v) ? (refToAtom(v) as ReadableAtom<string>) : v;\n    }\n\n    const store = hook.store({\n      path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n      query: queryParams,\n    });\n\n    const data = ref();\n    const loading = ref();\n    const error = ref();\n\n    const unsubscribe = store.subscribe((updatedStoreValue) => {\n      data.value = updatedStoreValue.data;\n      loading.value = updatedStoreValue.loading;\n      error.value = updatedStoreValue.error;\n    });\n\n    if (getCurrentScope()) {\n      onScopeDispose(() => {\n        unsubscribe();\n      });\n    }\n\n    return {\n      data,\n      loading,\n      error,\n    };\n  };\n}\n\n// Helper function to create a Vue mutator from a mutator hook\nfunction createVueMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoVueMutator<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return () => {\n    const store = useStore(hook.mutatorStore);\n\n    // Create a wrapped mutate function that handles Vue refs\n    const mutate = async (args: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n      query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n    }) => {\n      const { body, path, query } = args;\n\n      const pathParams: Record<string, string | ReadableAtom<string>> = {};\n      const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n      for (const [key, value] of Object.entries(path ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        pathParams[key] = isRef(v) ? v.value : v;\n      }\n\n      for (const [key, value] of Object.entries(query ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        queryParams[key] = isRef(v) ? v.value : v;\n      }\n\n      // Call the store's mutate function with normalized params\n      return store.value.mutate({\n        body,\n        path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n        query: queryParams,\n      });\n    };\n\n    // Return the store-like object with Vue reactive refs\n    return {\n      mutate,\n      loading: computed(() => store.value.loading),\n      error: computed(() => store.value.error),\n      data: computed(() => store.value.data) as Ref<InferOr<TOutputSchema, undefined>>,\n    };\n  };\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoVueHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer M,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>\n      : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any;\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createVueHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createVueMutator(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n\nexport function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(\n  store: SomeStore,\n): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>> {\n  const state = shallowRef();\n\n  const unsubscribe = store.subscribe((value) => {\n    state.value = value;\n  });\n\n  if (getCurrentScope()) {\n    onScopeDispose(unsubscribe);\n  }\n\n  return state;\n}\n"],"mappings":";;;;;;;;;;;;AAuDA,SAAgB,UAAa,OAA8B;CACzD,MAAM,IAAI,KAAKA,MAAI,MAAM;AAEzB,OAAMA,QAAM,WAAW;AACrB,IAAE,IAAI,OAAO;GACb;AAIF,QAAO;;AAMT,SAAS,cAOP,MAC4E;AAC5E,SAAQ,EAAE,MAAM,UAAU,EAAE,KAAK;EAC/B,MAAMC,aAA4D,EAAE;EACpE,MAAMC,cAA6D,EAAE;AAErE,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;GACrD,MAAM,IAAI;AACV,cAAW,OAAO,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG;;AAG9C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;GAEtD,MAAM,IAAI;AACV,eAAY,OAAO,MAAM,EAAE,GAAI,UAAU,EAAE,GAA4B;;EAGzE,MAAM,QAAQ,KAAK,MAAM;GACvB,MAAM;GACN,OAAO;GACR,CAAC;EAEF,MAAM,OAAO,KAAK;EAClB,MAAM,UAAU,KAAK;EACrB,MAAM,QAAQ,KAAK;EAEnB,MAAM,cAAc,MAAM,WAAW,sBAAsB;AACzD,QAAK,QAAQ,kBAAkB;AAC/B,WAAQ,QAAQ,kBAAkB;AAClC,SAAM,QAAQ,kBAAkB;IAChC;AAEF,MAAI,iBAAiB,CACnB,sBAAqB;AACnB,gBAAa;IACb;AAGJ,SAAO;GACL;GACA;GACA;GACD;;;AAKL,SAAS,iBAQP,MAQ6F;AAC7F,cAAa;EACX,MAAM,QAAQ,SAAS,KAAK,aAAa;EAGzC,MAAM,SAAS,OAAO,SAIhB;GACJ,MAAM,EAAE,MAAM,MAAM,UAAU;GAE9B,MAAMD,aAA4D,EAAE;GACpE,MAAMC,cAA6D,EAAE;AAErE,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;IACrD,MAAM,IAAI;AACV,eAAW,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAGzC,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;IACtD,MAAM,IAAI;AACV,gBAAY,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAI1C,UAAO,MAAM,MAAM,OAAO;IACxB;IACA,MAAM;IACN,OAAO;IACR,CAAC;;AAIJ,SAAO;GACL;GACA,SAASC,iBAAe,MAAM,MAAM,QAAQ;GAC5C,OAAOA,iBAAe,MAAM,MAAM,MAAM;GACxC,MAAMA,iBAAe,MAAM,MAAM,KAAK;GACvC;;;AAIL,SAAgB,UACd,WAoBA;CAEA,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,WAAW;AAC3B,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,CACvD;EAGF,MAAM,OAAO,UAAU;AACvB,MAAI,UAAU,KAAK,CACjB,QAAO,OAAO,cAAc,KAAK;WACxB,cAAc,KAAK,CAC5B,QAAO,OAAO,iBAAiB,KAAK;MAGpC,QAAO,OAAO;;AAIlB,QAAO;;AAGT,SAAgB,SACd,OACmD;CACnD,MAAM,QAAQ,YAAY;CAE1B,MAAM,cAAc,MAAM,WAAW,UAAU;AAC7C,QAAM,QAAQ;GACd;AAEF,KAAI,iBAAiB,CACnB,gBAAe,YAAY;AAG7B,QAAO"}

package/dist/http/http-status.d.ts

@@ -0,0 +1,26 @@
+//#region src/http/http-status.d.ts
+/**
+ * @module
+ * HTTP Status utility.
+ *
+ * Modified from honojs/hono
+ * Original source: https://github.com/honojs/hono/blob/0e3db674ad3f40be215a55a18062dd8e387ce525/src/utils/http-status.ts
+ * License: MIT
+ * Date obtained: August 28 2025
+ * Copyright (c) 2021-present Yusuke Wada and Hono contributors
+ *
+ */
+type InfoStatusCode = 100 | 101 | 102 | 103;
+type SuccessStatusCode = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226;
+type DeprecatedStatusCode = 305 | 306;
+type RedirectStatusCode = 300 | 301 | 302 | 303 | 304 | DeprecatedStatusCode | 307 | 308;
+type ClientErrorStatusCode = 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451;
+type ServerErrorStatusCode = 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+/**
+ * If you want to use an unofficial status, use `UnofficialStatusCode`.
+ */
+type StatusCode = InfoStatusCode | SuccessStatusCode | RedirectStatusCode | ClientErrorStatusCode | ServerErrorStatusCode;
+type ContentlessStatusCode = 101 | 204 | 205 | 304;
+//#endregion
+export { ContentlessStatusCode, StatusCode };
+//# sourceMappingURL=http-status.d.ts.map

package/dist/http/http-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-status.d.ts","names":[],"sources":["../../src/http/http-status.ts"],"sourcesContent":[],"mappings":";;AAYA;AACA;AACA;AACA;AACA;AA8BA;AAKA;;;;AAII,KA3CQ,cAAA,GA2CR,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;AACA,KA3CQ,iBAAA,GA2CR,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;AAAqB,KA1Cb,oBAAA,GA0Ca,GAAA,GAAA,GAAA;AAEb,KA3CA,kBAAA,GA2CqB,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GA3C8B,oBA2C9B,GAAA,GAAA,GAAA,GAAA;KA1CrB,qBAAA;KA8BA,qBAAA;;;;KAKA,UAAA,GACR,iBACA,oBACA,qBACA,wBACA;KAEQ,qBAAA"}

package/dist/integrations/react-ssr.js

@@ -1,4 +1,4 @@
-import { i as getFinalStoreValues, r as cleanStores } from "../ssr-BByDVfFD.js";
+import { cleanStores, getFinalStoreValues } from "../util/ssr.js";
 
 //#region src/integrations/react-ssr.ts
 /**

package/dist/internal/symbols.d.ts

@@ -0,0 +1,9 @@
+//#region src/internal/symbols.d.ts
+/**
+ * Not actually a symbol, since we might be dealing with multiple instances of this code.
+ * @internal
+ */
+declare const instantiatedFragmentFakeSymbol: "$fragno-instantiated-fragment";
+//#endregion
+export { instantiatedFragmentFakeSymbol };
+//# sourceMappingURL=symbols.d.ts.map

package/dist/internal/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","names":[],"sources":["../../src/internal/symbols.ts"],"sourcesContent":[],"mappings":";;AAIA;;;cAAa"}

package/dist/internal/symbols.js

@@ -0,0 +1,10 @@
+//#region src/internal/symbols.ts
+/**
+* Not actually a symbol, since we might be dealing with multiple instances of this code.
+* @internal
+*/
+const instantiatedFragmentFakeSymbol = "$fragno-instantiated-fragment";
+
+//#endregion
+export { instantiatedFragmentFakeSymbol };
+//# sourceMappingURL=symbols.js.map

package/dist/internal/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","names":[],"sources":["../../src/internal/symbols.ts"],"sourcesContent":["/**\n * Not actually a symbol, since we might be dealing with multiple instances of this code.\n * @internal\n */\nexport const instantiatedFragmentFakeSymbol = \"$fragno-instantiated-fragment\" as const;\n"],"mappings":";;;;;AAIA,MAAa,iCAAiC"}

package/dist/mod-client.d.ts

@@ -0,0 +1,36 @@
+import { FragnoPublicConfig } from "./api/shared-types.js";
+import { FragnoRouteConfig, RequestThisContext } from "./api/api.js";
+import { BoundServices } from "./api/bind-services.js";
+import { RouteFactory, RouteFactoryContext, defineRoute, defineRoutes } from "./api/route.js";
+import { instantiatedFragmentFakeSymbol } from "./internal/symbols.js";
+import { FragmentInstantiationBuilder, FragnoInstantiatedFragment } from "./api/fragment-instantiator.js";
+import { FragmentDefinition, FragmentDefinitionBuilder, ServiceConstructorFn, ServiceContext } from "./api/fragment-definition-builder.js";
+
+//#region src/mod-client.d.ts
+declare function defineFragment(_name: string): {
+  withDependencies: () => {
+    withDependencies: () => {};
+  };
+  providesBaseService: () => {
+    providesBaseService: () => {};
+  };
+  providesService: () => {
+    providesService: () => {};
+  };
+  withRequestStorage: () => {
+    withRequestStorage: () => {};
+  };
+  withExternalRequestStorage: () => {
+    withExternalRequestStorage: () => {};
+  };
+  withRequestThisContext: () => {
+    withRequestThisContext: () => {};
+  };
+  extend: () => {
+    extend: () => {};
+  };
+  build: () => {};
+};
+//#endregion
+export { type BoundServices, type FragmentDefinition, FragmentDefinitionBuilder, type FragmentInstantiationBuilder, type FragnoInstantiatedFragment, type FragnoPublicConfig, type FragnoRouteConfig, type RequestThisContext, type RouteFactory, type RouteFactoryContext, type ServiceConstructorFn, type ServiceContext, defineFragment, defineRoute, defineRoutes, instantiatedFragmentFakeSymbol };
+//# sourceMappingURL=mod-client.d.ts.map

package/dist/mod-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod-client.d.ts","names":[],"sources":["../src/mod-client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAyBgB,cAAA;;;;;;;EAAA,eAAA,EAAc,GAAA,GAAA"}

package/dist/mod-client.js

@@ -0,0 +1,21 @@
+import { FragmentDefinitionBuilder } from "./api/fragment-definition-builder.js";
+import { defineRoute, defineRoutes } from "./api/route.js";
+import { instantiatedFragmentFakeSymbol } from "./internal/symbols.js";
+
+//#region src/mod-client.ts
+function defineFragment(_name) {
+	return {
+		withDependencies: () => ({ withDependencies: () => ({}) }),
+		providesBaseService: () => ({ providesBaseService: () => ({}) }),
+		providesService: () => ({ providesService: () => ({}) }),
+		withRequestStorage: () => ({ withRequestStorage: () => ({}) }),
+		withExternalRequestStorage: () => ({ withExternalRequestStorage: () => ({}) }),
+		withRequestThisContext: () => ({ withRequestThisContext: () => ({}) }),
+		extend: () => ({ extend: () => ({}) }),
+		build: () => ({})
+	};
+}
+
+//#endregion
+export { FragmentDefinitionBuilder, defineFragment, defineRoute, defineRoutes, instantiatedFragmentFakeSymbol };
+//# sourceMappingURL=mod-client.js.map

package/dist/mod-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod-client.js","names":[],"sources":["../src/mod-client.ts"],"sourcesContent":["// ============================================================================\n// Client-side entry point for @fragno-dev/core\n// This file mirrors mod.ts but provides stub implementations for server-side\n// APIs that are stripped by unplugin-fragno during browser builds.\n// ============================================================================\n\n// ============================================================================\n// Fragment Definition and Instantiation\n// ============================================================================\n\n// Re-export types only\nexport type {\n  FragmentDefinition,\n  ServiceContext,\n  ServiceConstructorFn,\n} from \"./api/fragment-definition-builder\";\n\nexport type {\n  FragmentInstantiationBuilder,\n  FragnoInstantiatedFragment,\n  BoundServices,\n} from \"./api/fragment-instantiator\";\n\n// Stub implementation for defineFragment\n// This is stripped by unplugin-fragno in browser builds\nexport function defineFragment(_name: string) {\n  return {\n    withDependencies: () => ({ withDependencies: () => ({}) }),\n    providesBaseService: () => ({ providesBaseService: () => ({}) }),\n    providesService: () => ({ providesService: () => ({}) }),\n    withRequestStorage: () => ({ withRequestStorage: () => ({}) }),\n    withExternalRequestStorage: () => ({ withExternalRequestStorage: () => ({}) }),\n    withRequestThisContext: () => ({ withRequestThisContext: () => ({}) }),\n    extend: () => ({ extend: () => ({}) }),\n    build: () => ({}),\n  };\n}\n\n// Re-export the builder class (for type compatibility)\nexport { FragmentDefinitionBuilder } from \"./api/fragment-definition-builder\";\n\n// ============================================================================\n// Core Configuration\n// ============================================================================\nexport type { FragnoPublicConfig } from \"./api/shared-types\";\n\n// ============================================================================\n// Route Definition\n// ============================================================================\nexport {\n  defineRoute,\n  defineRoutes,\n  type RouteFactory,\n  type RouteFactoryContext,\n} from \"./api/route\";\n\nexport type { FragnoRouteConfig, RequestThisContext } from \"./api/api\";\n\nexport { instantiatedFragmentFakeSymbol } from \"./internal/symbols\";\n"],"mappings":";;;;;AAyBA,SAAgB,eAAe,OAAe;AAC5C,QAAO;EACL,yBAAyB,EAAE,yBAAyB,EAAE,GAAG;EACzD,4BAA4B,EAAE,4BAA4B,EAAE,GAAG;EAC/D,wBAAwB,EAAE,wBAAwB,EAAE,GAAG;EACvD,2BAA2B,EAAE,2BAA2B,EAAE,GAAG;EAC7D,mCAAmC,EAAE,mCAAmC,EAAE,GAAG;EAC7E,+BAA+B,EAAE,+BAA+B,EAAE,GAAG;EACrE,eAAe,EAAE,eAAe,EAAE,GAAG;EACrC,cAAc,EAAE;EACjB"}

package/dist/mod.d.ts

@@ -1,4 +1,7 @@
-import { t as FragnoRouteConfig } from "./api-BWN97TOr.js";
-import { a as RouteFactoryContext, i as RouteFactory, n as AnyRouteOrFactory, o as defineRoute, r as FlattenRouteFactories, s as defineRoutes } from "./route-Bl9Zr1Yv.js";
-import { c as FragnoPublicClientConfig, l as FragnoPublicConfig, n as FragmentDefinition, o as FragnoFragmentSharedConfig, r as defineFragment, s as FragnoInstantiatedFragment, t as FragmentBuilder, u as createFragment } from "./fragment-builder-MGr68GNb.js";
-export { type AnyRouteOrFactory, type FlattenRouteFactories, FragmentBuilder, type FragmentDefinition, type FragnoFragmentSharedConfig, type FragnoInstantiatedFragment, type FragnoPublicClientConfig, type FragnoPublicConfig, type FragnoRouteConfig, type RouteFactory, type RouteFactoryContext, createFragment, defineFragment, defineRoute, defineRoutes };
+import { FragnoPublicConfig } from "./api/shared-types.js";
+import { FragnoRouteConfig, RequestThisContext } from "./api/api.js";
+import { BoundServices } from "./api/bind-services.js";
+import { RouteFactory, RouteFactoryContext, defineRoute, defineRoutes } from "./api/route.js";
+import { AnyFragnoInstantiatedFragment, FragmentInstantiationBuilder, FragnoInstantiatedFragment, instantiate } from "./api/fragment-instantiator.js";
+import { ExtractLinkedServices, FragmentDefinition, FragmentDefinitionBuilder, LinkedFragmentCallback, ServiceConstructorFn, ServiceContext, defineFragment } from "./api/fragment-definition-builder.js";
+export { type AnyFragnoInstantiatedFragment, type BoundServices, type ExtractLinkedServices, type FragmentDefinition, FragmentDefinitionBuilder, type FragmentInstantiationBuilder, type FragnoInstantiatedFragment, type FragnoPublicConfig, type FragnoRouteConfig, type LinkedFragmentCallback, type RequestThisContext, type RouteFactory, type RouteFactoryContext, type ServiceConstructorFn, type ServiceContext, defineFragment, defineRoute, defineRoutes, instantiate };

package/dist/mod.js

@@ -1,7 +1,5 @@
-import { n as defineFragment, t as FragmentBuilder } from "./fragment-builder-DOnCVBqc.js";
-import "./api-DngJDcmO.js";
-import "./request-output-context-CdIjwmEN.js";
-import { n as defineRoutes, t as defineRoute } from "./route-C5Uryylh.js";
-import { t as createFragment } from "./fragment-instantiation-C4wvwl6V.js";
+import { FragmentDefinitionBuilder, defineFragment } from "./api/fragment-definition-builder.js";
+import { defineRoute, defineRoutes } from "./api/route.js";
+import { instantiate } from "./api/fragment-instantiator.js";
 
-export { FragmentBuilder, createFragment, defineFragment, defineRoute, defineRoutes };
+export { FragmentDefinitionBuilder, defineFragment, defineRoute, defineRoutes, instantiate };

package/dist/request/request.d.ts

@@ -0,0 +1,4 @@
+import { RequestInputContext } from "../api/request-input-context.js";
+import { RequestOutputContext } from "../api/request-output-context.js";
+import { FragnoMiddlewareCallback, RequestMiddlewareInputContext, RequestMiddlewareOptions, RequestMiddlewareOutputContext } from "../api/request-middleware.js";
+export { type FragnoMiddlewareCallback, RequestInputContext, RequestMiddlewareInputContext, type RequestMiddlewareOptions, RequestMiddlewareOutputContext, RequestOutputContext };

package/dist/request/request.js

@@ -0,0 +1,5 @@
+import { RequestInputContext } from "../api/request-input-context.js";
+import { RequestOutputContext } from "../api/request-output-context.js";
+import { RequestMiddlewareInputContext, RequestMiddlewareOutputContext } from "../api/request-middleware.js";
+
+export { RequestInputContext, RequestMiddlewareInputContext, RequestMiddlewareOutputContext, RequestOutputContext };

package/dist/test/test.d.ts

@@ -1,52 +1,82 @@
-import { d as InferOrUnknown, n as HTTPMethod, o as RouteHandlerInputOptions, t as FragnoRouteConfig } from "../api-BWN97TOr.js";
-import { n as AnyRouteOrFactory, r as FlattenRouteFactories } from "../route-Bl9Zr1Yv.js";
-import { b as ExtractRouteByPath, f as FragnoResponse, l as FragnoPublicConfig, n as FragmentDefinition, x as ExtractRoutePath } from "../fragment-builder-MGr68GNb.js";
-import { StandardSchemaV1 } from "@standard-schema/spec";
+import { RouteHandlerInputOptions } from "../api/route-handler-input-options.js";
+import { FragnoPublicConfig } from "../api/shared-types.js";
+import { RequestThisContext } from "../api/api.js";
+import { BoundServices } from "../api/bind-services.js";
+import { AnyRouteOrFactory, FlattenRouteFactories } from "../api/route.js";
+import { FragnoResponse } from "../api/fragno-response.js";
+import { FragnoInstantiatedFragment } from "../api/fragment-instantiator.js";
+import { FragmentDefinition, FragmentDefinitionBuilder } from "../api/fragment-definition-builder.js";
 
 //#region src/test/test.d.ts
-
+type TestBaseServices<TDeps> = {
+  /**
+   * Access to fragment dependencies for testing purposes.
+   */
+  deps: TDeps;
+};
 /**
- * Options for creating a test fragment
+ * Extension function that adds test utilities to a fragment definition.
+ * This adds a `test` service to base services with access to deps.
+ *
+ * @example
+ * ```typescript
+ * const definition = defineFragment("my-fragment")
+ *   .withDependencies(({ config }) => ({ client: createClient(config) }))
+ *   .extend(withTestUtils())
+ *   .build();
+ *
+ * const fragment = createFragmentForTest(definition, [], { config: {...} });
+ * expect(fragment.services.test.deps.client).toBeDefined();
+ * ```
  */
-interface CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig> {
-  config: TConfig;
-  options?: Partial<TOptions>;
-  deps?: Partial<TDeps>;
-  services?: Partial<TServices>;
-  additionalContext?: Partial<TAdditionalContext>;
-}
+declare function withTestUtils(): <TConfig, TOptions extends FragnoPublicConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage>(builder: FragmentDefinitionBuilder<TConfig, TOptions, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage>) => FragmentDefinitionBuilder<TConfig, TOptions, TDeps, TBaseServices & TestBaseServices<TDeps>, TServices, TServiceDeps, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage>;
 /**
- * Fragment test instance with type-safe callRoute method
+ * Options for creating a test fragment with the new architecture
  */
-interface FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig, TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
+interface CreateFragmentForTestOptions<TConfig, TOptions extends FragnoPublicConfig, TServiceDependencies> {
   config: TConfig;
-  deps: TDeps;
-  services: TServices;
-  additionalContext: TAdditionalContext & TOptions;
-  callRoute: <const TMethod extends HTTPMethod, const TPath extends ExtractRoutePath<TRoutes, TMethod>>(method: TMethod, path: TPath, inputOptions?: RouteHandlerInputOptions<TPath, ExtractRouteByPath<TRoutes, TPath, TMethod>["inputSchema"]>) => Promise<FragnoResponse<InferOrUnknown<NonNullable<ExtractRouteByPath<TRoutes, TPath, TMethod>["outputSchema"]>>>>;
+  options?: Partial<TOptions>;
+  serviceImplementations?: TServiceDependencies;
 }
 /**
- * Create a fragment instance for testing with optional dependency and service overrides
+ * Create a fragment instance for testing with optional service dependency overrides.
+ * This uses the new fragment definition and instantiation architecture.
  *
- * @param fragmentBuilder - The fragment builder with definition and required options
+ * **Important:** Use `.extend(withTestUtils())` before `.build()` to expose deps via `services.test.deps`.
+ *
+ * Returns an instantiated fragment with:
+ * - `services` - Services (base + named) from the fragment definition
+ * - `services.test.deps` - Dependencies (only if you used .extend(withTestUtils()))
+ * - `callRoute()` - Type-safe method to call routes directly
+ * - `handler()` - Request handler for integration
+ * - `inContext()` - Run code within request context
+ *
+ * @param definition - The fragment definition from builder.build()
  * @param routesOrFactories - Route configurations or route factories
- * @param options - Configuration and optional overrides for deps/services
- * @returns A fragment test instance with a type-safe callRoute method
+ * @param options - Configuration and optional overrides
+ * @returns An instantiated fragment ready for testing
  *
  * @example
  * ```typescript
+ * const definition = defineFragment<{ apiKey: string }>("test")
+ *   .withDependencies(({ config }) => ({ client: createClient(config.apiKey) }))
+ *   .providesService("api", ({ deps }) => ({ call: () => deps.client.call() }))
+ *   .extend(withTestUtils())  // <- Add test utilities
+ *   .build();
+ *
  * const fragment = createFragmentForTest(
- *   chatnoDefinition,
- *   [routesFactory],
+ *   definition,
+ *   [route1, route2],
  *   {
- *     config: { openaiApiKey: "test-key" },
- *     options: { mountRoute: "/api/chatno" },
- *     services: {
- *       generateStreamMessages: mockGenerator
- *     }
+ *     config: { apiKey: "test-key" },
+ *     options: { mountRoute: "/api/test" }
  *   }
  * );
  *
+ * // Access deps via test utilities
+ * expect(fragment.services.test.deps.client).toBeDefined();
+ * expect(fragment.services.api.call()).toBeDefined();
+ *
  * // Call routes directly by method and path
  * const response = await fragment.callRoute("POST", "/login", {
  *   body: { username: "test", password: "test123" }
@@ -57,10 +87,7 @@ interface FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext extends
  * }
  * ```
  */
-declare function createFragmentForTest<TConfig, TDeps, TServices extends Record<string, unknown>, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig, const TRoutesOrFactories extends readonly AnyRouteOrFactory[]>(fragmentBuilder: {
-  definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;
-  $requiredOptions: TOptions;
-}, routesOrFactories: TRoutesOrFactories, options: CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>): FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions, FlattenRouteFactories<TRoutesOrFactories>>;
+declare function createFragmentForTest<TConfig, TOptions extends FragnoPublicConfig, TDeps, TBaseServices extends Record<string, unknown>, TServices extends Record<string, unknown>, TServiceDependencies, TPrivateServices extends Record<string, unknown>, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage, const TRoutesOrFactories extends readonly AnyRouteOrFactory[]>(definition: FragmentDefinition<TConfig, TOptions, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage>, routesOrFactories: TRoutesOrFactories, options: CreateFragmentForTestOptions<TConfig, TOptions, TServiceDependencies>): FragnoInstantiatedFragment<FlattenRouteFactories<TRoutesOrFactories>, TDeps, BoundServices<TBaseServices & TServices>, TServiceThisContext, THandlerThisContext, TRequestStorage>;
 //#endregion
-export { CreateFragmentForTestOptions, FragmentForTest, type FragnoResponse, type RouteHandlerInputOptions, createFragmentForTest };
+export { CreateFragmentForTestOptions, type FragnoResponse, type RouteHandlerInputOptions, TestBaseServices, createFragmentForTest, withTestUtils };
 //# sourceMappingURL=test.d.ts.map

package/dist/test/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","names":[],"sources":["../../src/test/test.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA6BqB,UAVJ,4BAUI,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BANQ,MAMR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBALF,kBAKE,CAAA,CAAA;EAAR,MAAA,EAHH,OAGG;EACiB,OAAA,CAAA,EAHlB,OAGkB,CAHV,QAGU,CAAA;EAAR,IAAA,CAAA,EAFb,OAEa,CAFL,KAEK,CAAA;EAAO,QAAA,CAAA,EADhB,OACgB,CADR,SACQ,CAAA;EAMZ,iBAAA,CAAe,EANV,OAMU,CANF,kBAME,CAAA;;;;;AAU5B,UAVa,eAUb,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BANyB,MAMzB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBALe,kBAKf,EAAA,gBAAA,SAJuB,iBAIvB,CAHA,UAGA,EAAA,MAAA,EADA,gBACA,GAAA,SAAA,EAAA,gBAAA,GAAA,SAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAAA;EAJuB,MAAA,EASjB,OATiB;EASjB,IAAA,EACF,KADE;EACF,QAAA,EACI,SADJ;EACI,iBAAA,EACS,kBADT,GAC8B,QAD9B;EACS,SAAA,EAAA,CAAA,sBAEK,UAFL,EAAA,oBAGG,gBAHH,CAGoB,OAHpB,EAG6B,OAH7B,CAAA,CAAA,CAAA,MAAA,EAKT,OALS,EAAA,IAAA,EAMX,KANW,EAAA,YAAA,CAAA,EAOF,wBAPE,CAQf,KARe,EASf,kBATe,CASI,OATJ,EASa,KATb,EASoB,OATpB,CAAA,CAAA,aAAA,CAAA,CAAA,EAAA,GAWd,OAXc,CAYjB,cAZiB,CAaf,cAbe,CAaA,WAbA,CAaY,kBAbZ,CAa+B,OAb/B,EAawC,KAbxC,EAa+C,OAb/C,CAAA,CAAA,cAAA,CAAA,CAAA,CAAA,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;AAkDrB;;;;;;;;;;;AAYqB,iBAZL,qBAYK,CAAA,OAAA,EAAA,KAAA,EAAA,kBATD,MASC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,2BARQ,MAQR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBAPF,kBAOE,EAAA,iCAAA,SANuB,iBAMvB,EAAA,CAAA,CAAA,eAAA,EAAA;EACmB,UAAA,EAJxB,kBAIwB,CAJL,OAIK,EAJI,KAIJ,EAJW,SAIX,EAJsB,kBAItB,CAAA;EAAS,gBAAA,EAH3B,QAG2B;CAAO,EAAA,iBAAA,EADnC,kBACmC,EAAA,OAAA,EAA7C,4BAA6C,CAAhB,OAAgB,EAAP,KAAO,EAAA,SAAA,EAAW,kBAAX,EAA+B,QAA/B,CAAA,CAAA,EACrD,eADqD,CAEtD,OAFsD,EAGtD,KAHsD,EAItD,SAJsD,EAKtD,kBALsD,EAMtD,QANsD,EAOtD,qBAPsD,CAOhC,kBAPgC,CAAA,CAAA"}
+{"version":3,"file":"test.d.ts","names":[],"sources":["../../src/test/test.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAeY;;AAAZ;AAsBA;EAGqB,IAAA,EArBb,KAqBa;CAMW;;;;;;;;;;;;;;;;AAoB5B,iBA7BY,aAAA,CAAA,CA6BZ,EAAA,CAAA,OAAA,EAAA,iBA1BiB,kBA0BjB,EAAA,KAAA,EAAA,aAAA,EAAA,SAAA,EAAA,YAAA,EAAA,gBAAA,EAAA,4BApB4B,kBAoB5B,EAAA,4BAnB4B,kBAmB5B,EAAA,eAAA,CAAA,CAAA,OAAA,EAhBS,yBAgBT,CAfE,OAeF,EAdE,QAcF,EAbE,KAaF,EAZE,aAYF,EAXE,SAWF,EAVE,YAUF,EATE,gBASF,EARE,mBAQF,EAPE,mBAOF,EANE,eAMF,CAAA,EAAA,GAJC,yBAID,CAHA,OAGA,EAFA,QAEA,EADA,KACA,EAAA,aAAA,GAAgB,gBAAhB,CAAiC,KAAjC,CAAA,EACA,SADA,EAEA,YAFA,EAGA,gBAHA,EAIA,mBAJA,EAKA,mBALA,EAMA,eANA,CAAA;;;;AAEA,UA+Da,4BA/Db,CAAA,OAAA,EAAA,iBAiEe,kBAjEf,EAAA,oBAAA,CAAA,CAAA;EACA,MAAA,EAmEM,OAnEN;EACA,OAAA,CAAA,EAmEQ,OAnER,CAmEgB,QAnEhB,CAAA;EACA,sBAAA,CAAA,EAmEuB,oBAnEvB;;;;AA4DJ;;;;;;;AA2DA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,gDAEG,iDAEK,2CACJ,wEAEO,qDACG,gDACA,+EAEc,iCAE9B,mBACV,SACA,UACA,OACA,eACA,WACA,sBACA,kBACA,qBACA,qBACA,qCAEiB,6BACV,6BAA6B,SAAS,UAAU,wBACxD,2BACD,sBAAsB,qBACtB,OACA,cAAc,gBAAgB,YAC9B,qBACA,qBACA"}

package/dist/test/test.js

@@ -1,31 +1,84 @@
-import "../api-DngJDcmO.js";
-import "../request-output-context-CdIjwmEN.js";
-import "../route-C5Uryylh.js";
-import { t as createFragment } from "../fragment-instantiation-C4wvwl6V.js";
+import { FragmentDefinitionBuilder } from "../api/fragment-definition-builder.js";
+import { instantiateFragment } from "../api/fragment-instantiator.js";
 
 //#region src/test/test.ts
 /**
-* Create a fragment instance for testing with optional dependency and service overrides
+* Extension function that adds test utilities to a fragment definition.
+* This adds a `test` service to base services with access to deps.
 *
-* @param fragmentBuilder - The fragment builder with definition and required options
+* @example
+* ```typescript
+* const definition = defineFragment("my-fragment")
+*   .withDependencies(({ config }) => ({ client: createClient(config) }))
+*   .extend(withTestUtils())
+*   .build();
+*
+* const fragment = createFragmentForTest(definition, [], { config: {...} });
+* expect(fragment.services.test.deps.client).toBeDefined();
+* ```
+*/
+function withTestUtils() {
+	return (builder) => {
+		const currentBaseDef = builder.build();
+		const currentBaseServices = currentBaseDef.baseServices;
+		const newBaseServices = (context) => {
+			const existingServices = currentBaseServices ? currentBaseServices(context) : {};
+			const testUtils = { deps: context.deps };
+			return {
+				...existingServices,
+				...testUtils
+			};
+		};
+		return new FragmentDefinitionBuilder(builder.name, {
+			dependencies: currentBaseDef.dependencies,
+			baseServices: newBaseServices,
+			namedServices: currentBaseDef.namedServices,
+			privateServices: currentBaseDef.privateServices,
+			serviceDependencies: currentBaseDef.serviceDependencies,
+			createRequestStorage: currentBaseDef.createRequestStorage,
+			createThisContext: currentBaseDef.createThisContext
+		});
+	};
+}
+/**
+* Create a fragment instance for testing with optional service dependency overrides.
+* This uses the new fragment definition and instantiation architecture.
+*
+* **Important:** Use `.extend(withTestUtils())` before `.build()` to expose deps via `services.test.deps`.
+*
+* Returns an instantiated fragment with:
+* - `services` - Services (base + named) from the fragment definition
+* - `services.test.deps` - Dependencies (only if you used .extend(withTestUtils()))
+* - `callRoute()` - Type-safe method to call routes directly
+* - `handler()` - Request handler for integration
+* - `inContext()` - Run code within request context
+*
+* @param definition - The fragment definition from builder.build()
 * @param routesOrFactories - Route configurations or route factories
-* @param options - Configuration and optional overrides for deps/services
-* @returns A fragment test instance with a type-safe callRoute method
+* @param options - Configuration and optional overrides
+* @returns An instantiated fragment ready for testing
 *
 * @example
 * ```typescript
+* const definition = defineFragment<{ apiKey: string }>("test")
+*   .withDependencies(({ config }) => ({ client: createClient(config.apiKey) }))
+*   .providesService("api", ({ deps }) => ({ call: () => deps.client.call() }))
+*   .extend(withTestUtils())  // <- Add test utilities
+*   .build();
+*
 * const fragment = createFragmentForTest(
-*   chatnoDefinition,
-*   [routesFactory],
+*   definition,
+*   [route1, route2],
 *   {
-*     config: { openaiApiKey: "test-key" },
-*     options: { mountRoute: "/api/chatno" },
-*     services: {
-*       generateStreamMessages: mockGenerator
-*     }
+*     config: { apiKey: "test-key" },
+*     options: { mountRoute: "/api/test" }
 *   }
 * );
 *
+* // Access deps via test utilities
+* expect(fragment.services.test.deps.client).toBeDefined();
+* expect(fragment.services.api.call()).toBeDefined();
+*
 * // Call routes directly by method and path
 * const response = await fragment.callRoute("POST", "/login", {
 *   body: { username: "test", password: "test123" }
@@ -36,32 +89,14 @@ import { t as createFragment } from "../fragment-instantiation-C4wvwl6V.js";
 * }
 * ```
 */
-function createFragmentForTest(fragmentBuilder, routesOrFactories, options) {
-	const { config, options: fragmentOptions = {}, deps: depsOverride, services: servicesOverride, additionalContext: additionalContextOverride } = options;
-	const definition = fragmentBuilder.definition;
-	const deps = {
-		...definition.dependencies ? definition.dependencies(config, fragmentOptions) : {},
-		...depsOverride
-	};
-	const services = {
-		...definition.services ? definition.services(config, fragmentOptions, deps) : {},
-		...servicesOverride
-	};
-	const additionalContext = {
-		...definition.additionalContext,
-		...fragmentOptions,
-		...additionalContextOverride
-	};
-	const fragment = createFragment(fragmentBuilder, config, routesOrFactories, fragmentOptions);
-	return {
-		config,
-		deps,
-		services,
-		additionalContext,
-		callRoute: (method, path, inputOptions) => fragment.callRoute(method, path, inputOptions)
-	};
+function createFragmentForTest(definition, routesOrFactories, options) {
+	const { config, options: fragmentOptions = {}, serviceImplementations } = options;
+	return instantiateFragment(definition, config, routesOrFactories, {
+		mountRoute: "/api/test",
+		...fragmentOptions
+	}, serviceImplementations);
 }
 
 //#endregion
-export { createFragmentForTest };
+export { createFragmentForTest, withTestUtils };
 //# sourceMappingURL=test.js.map

package/dist/test/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","names":[],"sources":["../../src/test/test.ts"],"sourcesContent":["import type { FragmentDefinition } from \"../api/fragment-builder\";\nimport type { FragnoRouteConfig, HTTPMethod } from \"../api/api\";\nimport type { AnyRouteOrFactory, FlattenRouteFactories } from \"../api/route\";\nimport type { FragnoPublicConfig } from \"../api/fragment-instantiation\";\nimport { createFragment } from \"../api/fragment-instantiation\";\nimport type { RouteHandlerInputOptions } from \"../api/route-handler-input-options\";\nimport type { ExtractRouteByPath, ExtractRoutePath } from \"../client/client\";\nimport type { InferOrUnknown } from \"../util/types-util\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { FragnoResponse } from \"../api/fragno-response\";\n\n// Re-export for convenience\nexport type { RouteHandlerInputOptions };\n\nexport type { FragnoResponse };\n\n/**\n * Options for creating a test fragment\n */\nexport interface CreateFragmentForTestOptions<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n> {\n  config: TConfig;\n  options?: Partial<TOptions>;\n  deps?: Partial<TDeps>;\n  services?: Partial<TServices>;\n  additionalContext?: Partial<TAdditionalContext>;\n}\n\n/**\n * Fragment test instance with type-safe callRoute method\n */\nexport interface FragmentForTest<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> {\n  config: TConfig;\n  deps: TDeps;\n  services: TServices;\n  additionalContext: TAdditionalContext & TOptions;\n  callRoute: <\n    const TMethod extends HTTPMethod,\n    const TPath extends ExtractRoutePath<TRoutes, TMethod>,\n  >(\n    method: TMethod,\n    path: TPath,\n    inputOptions?: RouteHandlerInputOptions<\n      TPath,\n      ExtractRouteByPath<TRoutes, TPath, TMethod>[\"inputSchema\"]\n    >,\n  ) => Promise<\n    FragnoResponse<\n      InferOrUnknown<NonNullable<ExtractRouteByPath<TRoutes, TPath, TMethod>[\"outputSchema\"]>>\n    >\n  >;\n}\n\n/**\n * Create a fragment instance for testing with optional dependency and service overrides\n *\n * @param fragmentBuilder - The fragment builder with definition and required options\n * @param routesOrFactories - Route configurations or route factories\n * @param options - Configuration and optional overrides for deps/services\n * @returns A fragment test instance with a type-safe callRoute method\n *\n * @example\n * ```typescript\n * const fragment = createFragmentForTest(\n *   chatnoDefinition,\n *   [routesFactory],\n *   {\n *     config: { openaiApiKey: \"test-key\" },\n *     options: { mountRoute: \"/api/chatno\" },\n *     services: {\n *       generateStreamMessages: mockGenerator\n *     }\n *   }\n * );\n *\n * // Call routes directly by method and path\n * const response = await fragment.callRoute(\"POST\", \"/login\", {\n *   body: { username: \"test\", password: \"test123\" }\n * });\n *\n * if (response.type === 'json') {\n *   expect(response.data).toEqual({...});\n * }\n * ```\n */\nexport function createFragmentForTest<\n  TConfig,\n  TDeps,\n  TServices extends Record<string, unknown>,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n  const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n>(\n  fragmentBuilder: {\n    definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;\n    $requiredOptions: TOptions;\n  },\n  routesOrFactories: TRoutesOrFactories,\n  options: CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>,\n): FragmentForTest<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext,\n  TOptions,\n  FlattenRouteFactories<TRoutesOrFactories>\n> {\n  const {\n    config,\n    options: fragmentOptions = {} as TOptions,\n    deps: depsOverride,\n    services: servicesOverride,\n    additionalContext: additionalContextOverride,\n  } = options;\n\n  // Create deps from definition or use empty object\n  const definition = fragmentBuilder.definition;\n  const baseDeps = definition.dependencies\n    ? definition.dependencies(config, fragmentOptions)\n    : ({} as TDeps);\n\n  // Merge deps with overrides\n  const deps = { ...baseDeps, ...depsOverride } as TDeps;\n\n  // Create services from definition or use empty object\n  const baseServices = definition.services\n    ? definition.services(config, fragmentOptions, deps)\n    : ({} as TServices);\n\n  // Merge services with overrides\n  const services = { ...baseServices, ...servicesOverride } as TServices;\n\n  // Merge additional context with options\n  const additionalContext = {\n    ...definition.additionalContext,\n    ...fragmentOptions,\n    ...additionalContextOverride,\n  } as TAdditionalContext & TOptions;\n\n  // Create the actual fragment using createFragment\n  const fragment = createFragment(fragmentBuilder, config, routesOrFactories, fragmentOptions);\n\n  return {\n    config,\n    deps,\n    services,\n    additionalContext,\n    callRoute: (method, path, inputOptions) => fragment.callRoute(method, path, inputOptions),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwGA,SAAgB,sBAQd,iBAIA,mBACA,SAQA;CACA,MAAM,EACJ,QACA,SAAS,kBAAkB,EAAE,EAC7B,MAAM,cACN,UAAU,kBACV,mBAAmB,8BACjB;CAGJ,MAAM,aAAa,gBAAgB;CAMnC,MAAM,OAAO;EAAE,GALE,WAAW,eACxB,WAAW,aAAa,QAAQ,gBAAgB,GAC/C,EAAE;EAGqB,GAAG;EAAc;CAQ7C,MAAM,WAAW;EAAE,GALE,WAAW,WAC5B,WAAW,SAAS,QAAQ,iBAAiB,KAAK,GACjD,EAAE;EAG6B,GAAG;EAAkB;CAGzD,MAAM,oBAAoB;EACxB,GAAG,WAAW;EACd,GAAG;EACH,GAAG;EACJ;CAGD,MAAM,WAAW,eAAe,iBAAiB,QAAQ,mBAAmB,gBAAgB;AAE5F,QAAO;EACL;EACA;EACA;EACA;EACA,YAAY,QAAQ,MAAM,iBAAiB,SAAS,UAAU,QAAQ,MAAM,aAAa;EAC1F"}
+{"version":3,"file":"test.js","names":["newBaseServices: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDeps,\n      TPrivateServices,\n      TBaseServices & TestBaseServices<TDeps>,\n      TServiceThisContext\n    >","testUtils: TestBaseServices<TDeps>"],"sources":["../../src/test/test.ts"],"sourcesContent":["import type { RequestThisContext } from \"../api/api\";\nimport type { AnyRouteOrFactory, FlattenRouteFactories } from \"../api/route\";\nimport type { FragnoPublicConfig } from \"../api/shared-types\";\nimport {\n  FragmentDefinitionBuilder,\n  type FragmentDefinition,\n  type ServiceConstructorFn,\n} from \"../api/fragment-definition-builder\";\nimport { instantiateFragment, type FragnoInstantiatedFragment } from \"../api/fragment-instantiator\";\nimport type { BoundServices } from \"../api/bind-services\";\n\n// Re-export for convenience\nexport type { RouteHandlerInputOptions } from \"../api/route-handler-input-options\";\nexport type { FragnoResponse } from \"../api/fragno-response\";\n\nexport type TestBaseServices<TDeps> = {\n  /**\n   * Access to fragment dependencies for testing purposes.\n   */\n  deps: TDeps;\n};\n\n/**\n * Extension function that adds test utilities to a fragment definition.\n * This adds a `test` service to base services with access to deps.\n *\n * @example\n * ```typescript\n * const definition = defineFragment(\"my-fragment\")\n *   .withDependencies(({ config }) => ({ client: createClient(config) }))\n *   .extend(withTestUtils())\n *   .build();\n *\n * const fragment = createFragmentForTest(definition, [], { config: {...} });\n * expect(fragment.services.test.deps.client).toBeDefined();\n * ```\n */\nexport function withTestUtils() {\n  return <\n    TConfig,\n    TOptions extends FragnoPublicConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDeps,\n    TPrivateServices,\n    TServiceThisContext extends RequestThisContext,\n    THandlerThisContext extends RequestThisContext,\n    TRequestStorage,\n  >(\n    builder: FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDeps,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices & TestBaseServices<TDeps>,\n    TServices,\n    TServiceDeps,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage\n  > => {\n    // Get the current base services factory\n    const currentBaseDef = builder.build();\n    const currentBaseServices = currentBaseDef.baseServices;\n\n    // Create new base services factory that merges test utilities\n    const newBaseServices: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDeps,\n      TPrivateServices,\n      TBaseServices & TestBaseServices<TDeps>,\n      TServiceThisContext\n    > = (context) => {\n      // Call existing base services if they exist\n      const existingServices = currentBaseServices\n        ? currentBaseServices(context)\n        : ({} as TBaseServices);\n\n      // Add test utilities\n      const testUtils: TestBaseServices<TDeps> = {\n        deps: context.deps,\n      };\n\n      return {\n        ...existingServices,\n        ...testUtils,\n      } as TBaseServices & TestBaseServices<TDeps>;\n    };\n\n    // Create new builder with updated base services\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices & TestBaseServices<TDeps>,\n      TServices,\n      TServiceDeps,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage\n    >(builder.name, {\n      dependencies: currentBaseDef.dependencies,\n      baseServices: newBaseServices,\n      namedServices: currentBaseDef.namedServices,\n      privateServices: currentBaseDef.privateServices,\n      serviceDependencies: currentBaseDef.serviceDependencies,\n      createRequestStorage: currentBaseDef.createRequestStorage,\n      createThisContext: currentBaseDef.createThisContext,\n    });\n  };\n}\n\n/**\n * Options for creating a test fragment with the new architecture\n */\nexport interface CreateFragmentForTestOptions<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TServiceDependencies,\n> {\n  config: TConfig;\n  options?: Partial<TOptions>;\n  serviceImplementations?: TServiceDependencies;\n}\n\n/**\n * Create a fragment instance for testing with optional service dependency overrides.\n * This uses the new fragment definition and instantiation architecture.\n *\n * **Important:** Use `.extend(withTestUtils())` before `.build()` to expose deps via `services.test.deps`.\n *\n * Returns an instantiated fragment with:\n * - `services` - Services (base + named) from the fragment definition\n * - `services.test.deps` - Dependencies (only if you used .extend(withTestUtils()))\n * - `callRoute()` - Type-safe method to call routes directly\n * - `handler()` - Request handler for integration\n * - `inContext()` - Run code within request context\n *\n * @param definition - The fragment definition from builder.build()\n * @param routesOrFactories - Route configurations or route factories\n * @param options - Configuration and optional overrides\n * @returns An instantiated fragment ready for testing\n *\n * @example\n * ```typescript\n * const definition = defineFragment<{ apiKey: string }>(\"test\")\n *   .withDependencies(({ config }) => ({ client: createClient(config.apiKey) }))\n *   .providesService(\"api\", ({ deps }) => ({ call: () => deps.client.call() }))\n *   .extend(withTestUtils())  // <- Add test utilities\n *   .build();\n *\n * const fragment = createFragmentForTest(\n *   definition,\n *   [route1, route2],\n *   {\n *     config: { apiKey: \"test-key\" },\n *     options: { mountRoute: \"/api/test\" }\n *   }\n * );\n *\n * // Access deps via test utilities\n * expect(fragment.services.test.deps.client).toBeDefined();\n * expect(fragment.services.api.call()).toBeDefined();\n *\n * // Call routes directly by method and path\n * const response = await fragment.callRoute(\"POST\", \"/login\", {\n *   body: { username: \"test\", password: \"test123\" }\n * });\n *\n * if (response.type === 'json') {\n *   expect(response.data).toEqual({...});\n * }\n * ```\n */\nexport function createFragmentForTest<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TBaseServices extends Record<string, unknown>,\n  TServices extends Record<string, unknown>,\n  TServiceDependencies,\n  TPrivateServices extends Record<string, unknown>,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage,\n  const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n>(\n  definition: FragmentDefinition<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage\n  >,\n  routesOrFactories: TRoutesOrFactories,\n  options: CreateFragmentForTestOptions<TConfig, TOptions, TServiceDependencies>,\n): FragnoInstantiatedFragment<\n  FlattenRouteFactories<TRoutesOrFactories>,\n  TDeps,\n  BoundServices<TBaseServices & TServices>,\n  TServiceThisContext,\n  THandlerThisContext,\n  TRequestStorage\n> {\n  const { config, options: fragmentOptions = {} as TOptions, serviceImplementations } = options;\n\n  // Use default mountRoute for testing if not provided\n  const fullOptions = {\n    mountRoute: \"/api/test\",\n    ...fragmentOptions,\n  } as TOptions;\n\n  // Instantiate and return the fragment directly\n  return instantiateFragment(\n    definition,\n    config,\n    routesOrFactories,\n    fullOptions,\n    serviceImplementations,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,gBAAgB;AAC9B,SAYE,YAuBG;EAEH,MAAM,iBAAiB,QAAQ,OAAO;EACtC,MAAM,sBAAsB,eAAe;EAG3C,MAAMA,mBAQD,YAAY;GAEf,MAAM,mBAAmB,sBACrB,oBAAoB,QAAQ,GAC3B,EAAE;GAGP,MAAMC,YAAqC,EACzC,MAAM,QAAQ,MACf;AAED,UAAO;IACL,GAAG;IACH,GAAG;IACJ;;AAIH,SAAO,IAAI,0BAWT,QAAQ,MAAM;GACd,cAAc,eAAe;GAC7B,cAAc;GACd,eAAe,eAAe;GAC9B,iBAAiB,eAAe;GAChC,qBAAqB,eAAe;GACpC,sBAAsB,eAAe;GACrC,mBAAmB,eAAe;GACnC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEN,SAAgB,sBAad,YAYA,mBACA,SAQA;CACA,MAAM,EAAE,QAAQ,SAAS,kBAAkB,EAAE,EAAc,2BAA2B;AAStF,QAAO,oBACL,YACA,QACA,mBATkB;EAClB,YAAY;EACZ,GAAG;EACJ,EAQC,uBACD"}

package/dist/util/async.js

@@ -0,0 +1,40 @@
+//#region src/util/async.ts
+/**
+* Creates an async iterator from a subscribe function that follows the observable pattern.
+*
+* @template T The type of values produced by the store.
+* @param subscribe A function that subscribes to store updates. It receives a callback to be
+*          called on each update, and returns an unsubscribe function.
+* @returns An async generator that yields store values as they are produced.
+*/
+function createAsyncIteratorFromCallback(subscribe) {
+	const queue = [];
+	let unsubscribe = null;
+	let resolveNext = null;
+	const unsubscribeFunc = subscribe((value) => {
+		if (resolveNext) {
+			resolveNext({
+				value,
+				done: false
+			});
+			resolveNext = null;
+		} else queue.push(value);
+	});
+	if (typeof unsubscribeFunc === "function") unsubscribe = unsubscribeFunc;
+	return (async function* () {
+		try {
+			while (true) if (queue.length > 0) yield queue.shift();
+			else yield await new Promise((resolve) => {
+				resolveNext = (result) => {
+					if (!result.done) resolve(result.value);
+				};
+			});
+		} finally {
+			if (unsubscribe) unsubscribe();
+		}
+	})();
+}
+
+//#endregion
+export { createAsyncIteratorFromCallback };
+//# sourceMappingURL=async.js.map