alepha 0.15.0 → 0.15.2

package/dist/server/links/index.d.ts

@@ -1,5 +1,5 @@
 import { ServerRouteSecure, ServiceAccountPrimitive, UserAccountToken } from "alepha/security";
-import * as alepha23 from "alepha";
+import * as alepha25 from "alepha";
 import { Alepha, Async, KIND, Primitive, Static } from "alepha";
 import * as alepha_server0 from "alepha/server";
 import { ActionPrimitive, ClientRequestEntry, ClientRequestOptions, ClientRequestResponse, FetchResponse, HttpClient, RequestConfigSchema, ServerRequest, ServerRequestConfigEntry, ServerResponseBody, ServerTimingProvider } from "alepha/server";
@@ -8,30 +8,30 @@ import * as alepha_retry0 from "alepha/retry";
 import { ProxyPrimitiveOptions, ServerProxyProvider } from "alepha/server/proxy";
 
 //#region ../../src/server/links/schemas/apiLinksResponseSchema.d.ts
-declare const apiLinkSchema: alepha23.TObject<{
-  name: alepha23.TString;
-  group: alepha23.TOptional<alepha23.TString>;
-  path: alepha23.TString;
-  method: alepha23.TOptional<alepha23.TString>;
-  requestBodyType: alepha23.TOptional<alepha23.TString>;
-  service: alepha23.TOptional<alepha23.TString>;
-  rawSchema: alepha23.TOptional<alepha23.TObject<{
-    body: alepha23.TOptional<alepha23.TString>;
-    response: alepha23.TOptional<alepha23.TString>;
+declare const apiLinkSchema: alepha25.TObject<{
+  name: alepha25.TString;
+  group: alepha25.TOptional<alepha25.TString>;
+  path: alepha25.TString;
+  method: alepha25.TOptional<alepha25.TString>;
+  requestBodyType: alepha25.TOptional<alepha25.TString>;
+  service: alepha25.TOptional<alepha25.TString>;
+  rawSchema: alepha25.TOptional<alepha25.TObject<{
+    body: alepha25.TOptional<alepha25.TString>;
+    response: alepha25.TOptional<alepha25.TString>;
   }>>;
 }>;
-declare const apiLinksResponseSchema: alepha23.TObject<{
-  prefix: alepha23.TOptional<alepha23.TString>;
-  links: alepha23.TArray<alepha23.TObject<{
-    name: alepha23.TString;
-    group: alepha23.TOptional<alepha23.TString>;
-    path: alepha23.TString;
-    method: alepha23.TOptional<alepha23.TString>;
-    requestBodyType: alepha23.TOptional<alepha23.TString>;
-    service: alepha23.TOptional<alepha23.TString>;
-    rawSchema: alepha23.TOptional<alepha23.TObject<{
-      body: alepha23.TOptional<alepha23.TString>;
-      response: alepha23.TOptional<alepha23.TString>;
+declare const apiLinksResponseSchema: alepha25.TObject<{
+  prefix: alepha25.TOptional<alepha25.TString>;
+  links: alepha25.TArray<alepha25.TObject<{
+    name: alepha25.TString;
+    group: alepha25.TOptional<alepha25.TString>;
+    path: alepha25.TString;
+    method: alepha25.TOptional<alepha25.TString>;
+    requestBodyType: alepha25.TOptional<alepha25.TString>;
+    service: alepha25.TOptional<alepha25.TString>;
+    rawSchema: alepha25.TOptional<alepha25.TObject<{
+      body: alepha25.TOptional<alepha25.TString>;
+      response: alepha25.TOptional<alepha25.TString>;
     }>>;
   }>>;
 }>;
@@ -51,35 +51,35 @@ declare class LinkProvider {
   protected readonly httpClient: HttpClient;
   protected serverLinks: Array<HttpClientLink>;
   /**
-       * Get applicative links registered on the server.
-       * This does not include lazy-loaded remote links.
-       */
+   * Get applicative links registered on the server.
+   * This does not include lazy-loaded remote links.
+   */
   getServerLinks(): HttpClientLink[];
   /**
-       * Register a new link for the application.
-       */
+   * Register a new link for the application.
+   */
   registerLink(link: HttpClientLink): void;
   get links(): HttpClientLink[];
   /**
-       * Force browser to refresh links from the server.
-       */
+   * Force browser to refresh links from the server.
+   */
   fetchLinks(): Promise<HttpClientLink[]>;
   /**
-       * Create a virtual client that can be used to call actions.
-       *
-       * Use js Proxy under the hood.
-       */
+   * Create a virtual client that can be used to call actions.
+   *
+   * Use js Proxy under the hood.
+   */
   client<T extends object>(scope?: ClientScope): HttpVirtualClient<T>;
   /**
-       * Check if a link with the given name exists.
-       * @param name
-       */
+   * Check if a link with the given name exists.
+   * @param name
+   */
   can(name: string): boolean;
   /**
-       * Resolve a link by its name and call it.
-       * - If link is local, it will call the local handler.
-       * - If link is remote, it will make a fetch request to the remote server.
-       */
+   * Resolve a link by its name and call it.
+   * - If link is local, it will call the local handler.
+   * - If link is remote, it will make a fetch request to the remote server.
+   */
   follow(name: string, config?: Partial<ServerRequestConfigEntry>, options?: ClientRequestOptions & ClientScope): Promise<any>;
   protected createVirtualAction<T extends RequestConfigSchema>(name: string, scope?: ClientScope): VirtualAction<T>;
   protected followRemote(link: HttpClientLink, config?: Partial<ServerRequestConfigEntry>, options?: ClientRequestOptions): Promise<FetchResponse>;
@@ -133,46 +133,46 @@ declare const $remote: {
 };
 interface RemotePrimitiveOptions {
   /**
-       * The URL of the remote service.
-       * You can use a function to generate the URL dynamically.
-       * You probably should use $env(env) to get the URL from the environment.
-       *
-       * @example
-       * ```ts
-       * import { $remote } from "alepha/server";
-       * import { $inject, t } from "alepha";
-       *
-       * class App {
-       *   env = $env(t.object({
-       *     REMOTE_URL: t.text({default: "http://localhost:3000"}),
-       *   }));
-       *   remote = $remote({
-       *     url: this.env.REMOTE_URL,
-       *   });
-       * }
-       * ```
-       */
+   * The URL of the remote service.
+   * You can use a function to generate the URL dynamically.
+   * You probably should use $env(env) to get the URL from the environment.
+   *
+   * @example
+   * ```ts
+   * import { $remote } from "alepha/server";
+   * import { $inject, t } from "alepha";
+   *
+   * class App {
+   *   env = $env(t.object({
+   *     REMOTE_URL: t.text({default: "http://localhost:3000"}),
+   *   }));
+   *   remote = $remote({
+   *     url: this.env.REMOTE_URL,
+   *   });
+   * }
+   * ```
+   */
   url: string | (() => string);
   /**
-       * The name of the remote service.
-       *
-       * @default Member of the class containing the remote service.
-       */
+   * The name of the remote service.
+   *
+   * @default Member of the class containing the remote service.
+   */
   name?: string;
   /**
-       * If true, all methods of the remote service will be exposed as actions in this context.
-       * > Note: Proxy will never use the service account, it just... proxies the request.
-       */
+   * If true, all methods of the remote service will be exposed as actions in this context.
+   * > Note: Proxy will never use the service account, it just... proxies the request.
+   */
   proxy?: boolean | Partial<ProxyPrimitiveOptions & {
     /**
-             * If true, the remote service won't be available internally, only through the proxy.
-             */
+     * If true, the remote service won't be available internally, only through the proxy.
+     */
     noInternal: boolean;
   }>;
   /**
-       * For communication between the server and the remote service with a security layer.
-       * This will be used for internal communication and will not be exposed to the client.
-       */
+   * For communication between the server and the remote service with a security layer.
+   * This will be used for internal communication and will not be exposed to the client.
+   */
   serviceAccount?: ServiceAccountPrimitive;
 }
 declare class RemotePrimitive extends Primitive<RemotePrimitiveOptions> {
@@ -190,62 +190,62 @@ declare class RemotePrimitiveProvider {
   protected readonly remotes: Array<ServerRemote>;
   protected readonly log: alepha_logger0.Logger;
   getRemotes(): ServerRemote[];
-  readonly configure: alepha23.HookPrimitive<"configure">;
-  readonly start: alepha23.HookPrimitive<"start">;
+  readonly configure: alepha25.HookPrimitive<"configure">;
+  readonly start: alepha25.HookPrimitive<"start">;
   registerRemote(value: RemotePrimitive): Promise<void>;
   protected readonly fetchLinks: alepha_retry0.RetryPrimitiveFn<(opts: FetchLinksOptions) => Promise<ApiLinksResponse>>;
 }
 interface FetchLinksOptions {
   /**
-       * Name of the remote service.
-       */
+   * Name of the remote service.
+   */
   service: string;
   /**
-       * URL to fetch links from.
-       */
+   * URL to fetch links from.
+   */
   url: string;
   /**
-       * Authorization header containing access token.
-       */
+   * Authorization header containing access token.
+   */
   authorization?: string;
 }
 interface ServerRemote {
   /**
-       * URL of the remote service.
-       */
+   * URL of the remote service.
+   */
   url: string;
   /**
-       * Name of the remote service.
-       */
+   * Name of the remote service.
+   */
   name: string;
   /**
-       * Expose links as endpoint. It's not only internal.
-       */
+   * Expose links as endpoint. It's not only internal.
+   */
   proxy: boolean;
   /**
-       * It's only used inside the application.
-       */
+   * It's only used inside the application.
+   */
   internal: boolean;
   /**
-       * Links fetcher.
-       */
+   * Links fetcher.
+   */
   links: (args: {
     authorization?: string;
   }) => Promise<ApiLinksResponse>;
   /**
-       * Fetches schema for the remote service.
-       */
+   * Fetches schema for the remote service.
+   */
   schema: (args: {
     name: string;
     authorization?: string;
   }) => Promise<any>;
   /**
-       * Force a default access token provider when not provided.
-       */
+   * Force a default access token provider when not provided.
+   */
   serviceAccount?: ServiceAccountPrimitive;
   /**
-       * Prefix for the remote service links.
-       */
+   * Prefix for the remote service links.
+   */
   prefix: string;
 }
 //#endregion
@@ -259,33 +259,33 @@ declare class ServerLinksProvider {
   protected readonly remoteProvider: RemotePrimitiveProvider;
   protected readonly serverTimingProvider: ServerTimingProvider;
   get prefix(): string;
-  readonly onRoute: alepha23.HookPrimitive<"configure">;
+  readonly onRoute: alepha25.HookPrimitive<"configure">;
   /**
-       * First API - Get all API links for the user.
-       *
-       * This is based on the user's permissions.
-       */
+   * First API - Get all API links for the user.
+   *
+   * This is based on the user's permissions.
+   */
   readonly links: alepha_server0.RoutePrimitive<{
-    response: alepha23.TObject<{
-      prefix: alepha23.TOptional<alepha23.TString>;
-      links: alepha23.TArray<alepha23.TObject<{
-        name: alepha23.TString;
-        group: alepha23.TOptional<alepha23.TString>;
-        path: alepha23.TString;
-        method: alepha23.TOptional<alepha23.TString>;
-        requestBodyType: alepha23.TOptional<alepha23.TString>;
-        service: alepha23.TOptional<alepha23.TString>;
-        rawSchema: alepha23.TOptional<alepha23.TObject<{
-          body: alepha23.TOptional<alepha23.TString>;
-          response: alepha23.TOptional<alepha23.TString>;
+    response: alepha25.TObject<{
+      prefix: alepha25.TOptional<alepha25.TString>;
+      links: alepha25.TArray<alepha25.TObject<{
+        name: alepha25.TString;
+        group: alepha25.TOptional<alepha25.TString>;
+        path: alepha25.TString;
+        method: alepha25.TOptional<alepha25.TString>;
+        requestBodyType: alepha25.TOptional<alepha25.TString>;
+        service: alepha25.TOptional<alepha25.TString>;
+        rawSchema: alepha25.TOptional<alepha25.TObject<{
+          body: alepha25.TOptional<alepha25.TString>;
+          response: alepha25.TOptional<alepha25.TString>;
         }>>;
       }>>;
     }>;
   }>;
   /**
-       * Retrieves API links for the user based on their permissions.
-       * Will check on local links and remote links.
-       */
+   * Retrieves API links for the user based on their permissions.
+   * Will check on local links and remote links.
+   */
   getUserApiLinks(options: GetApiLinksOptions): Promise<ApiLinksResponse>;
 }
 interface GetApiLinksOptions {
@@ -297,26 +297,31 @@ interface GetApiLinksOptions {
 declare module "alepha" {
   interface State {
     /**
-             * API links attached to the server request state.
-             *
-             * @see {@link ApiLinksResponse}
-             * @internal
-             */
+     * API links attached to the server request state.
+     *
+     * @see {@link ApiLinksResponse}
+     * @internal
+     */
     "alepha.server.request.apiLinks"?: ApiLinksResponse;
   }
 }
 /**
- * Provides server-side link management and remote capabilities for client-server interactions.
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | backend | standard | stable |
  *
- * The server-links module enables declarative link definitions using `$remote` and `$client` primitives,
- * facilitating seamless API endpoint management and client-server communication. It integrates with server
- * security features to ensure safe and controlled access to resources.
+ * Type-safe API client with request deduplication.
+ *
+ * **Features:**
+ * - Virtual HTTP client for type-safe API calls
+ * - Remote action definitions
+ * - Type inference from action schemas
+ * - Request deduplication
+ * - Automatic error handling
  *
- * @see {@link $remote}
- * @see {@link $client}
  * @module alepha.server.links
  */
-declare const AlephaServerLinks: alepha23.Service<alepha23.Module>;
+declare const AlephaServerLinks: alepha25.Service<alepha25.Module>;
 //#endregion
 export { $client, $remote, AlephaServerLinks, ApiLink, ApiLinksResponse, ClientScope, FetchLinksOptions, GetApiLinksOptions, HttpClientLink, HttpVirtualClient, LinkProvider, RemotePrimitive, RemotePrimitiveOptions, RemotePrimitiveProvider, ServerLinksProvider, ServerRemote, VirtualAction, apiLinkSchema, apiLinksResponseSchema };
 //# sourceMappingURL=index.d.ts.map

package/dist/server/links/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/server/links/schemas/apiLinksResponseSchema.ts","../../../src/server/links/providers/LinkProvider.ts","../../../src/server/links/primitives/$client.ts","../../../src/server/links/primitives/$remote.ts","../../../src/server/links/providers/RemotePrimitiveProvider.ts","../../../src/server/links/providers/ServerLinksProvider.ts","../../../src/server/links/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/server/links/schemas/apiLinksResponseSchema.ts","../../../src/server/links/providers/LinkProvider.ts","../../../src/server/links/primitives/$client.ts","../../../src/server/links/primitives/$remote.ts","../../../src/server/links/providers/RemotePrimitiveProvider.ts","../../../src/server/links/providers/ServerLinksProvider.ts","../../../src/server/links/index.ts"],"mappings":"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"}

package/dist/server/links/index.js

@@ -1,5 +1,5 @@
 import { SecurityProvider } from "alepha/security";
-import { $env, $hook, $inject, $module, Alepha, AlephaError, KIND, Primitive, createPrimitive, jsonSchemaToTypeBox, t } from "alepha";
+import { $atom, $env, $hook, $inject, $module, Alepha, AlephaError, KIND, Primitive, createPrimitive, jsonSchemaToTypeBox, t } from "alepha";
 import { $action, $route, AlephaServer, HttpClient, ServerReply, ServerTimingProvider, UnauthorizedError } from "alepha/server";
 import { $logger } from "alepha/logger";
 import { $retry } from "alepha/retry";
@@ -23,6 +23,13 @@ const apiLinksResponseSchema = t.object({
 	links: t.array(apiLinkSchema)
 });
 
+//#endregion
+//#region ../../src/server/links/atoms/apiLinksAtom.ts
+const apiLinksAtom = $atom({
+	name: "alepha.server.request.apiLinks",
+	schema: t.optional(apiLinksResponseSchema)
+});
+
 //#endregion
 //#region ../../src/server/links/providers/LinkProvider.ts
 /**
@@ -309,8 +316,8 @@ var RemotePrimitiveProvider = class {
 			proxy: !!options.proxy,
 			internal: !proxy.noInternal,
 			schema: async (opts) => {
-				const { authorization, name: name$1 } = opts;
-				return await fetch(`${url}${linkPath}/${name$1}/schema`, { headers: new Headers(authorization ? { authorization } : {}) }).then((it) => it.json());
+				const { authorization, name } = opts;
+				return await fetch(`${url}${linkPath}/${name}/schema`, { headers: new Headers(authorization ? { authorization } : {}) }).then((it) => it.json());
 			},
 			links: async (opts) => {
 				const { authorization } = opts;
@@ -327,8 +334,8 @@ var RemotePrimitiveProvider = class {
 		if (options.proxy) this.proxyProvider.createProxy({
 			path: `${this.env.SERVER_API_PREFIX}/${name}/*`,
 			target: url,
-			rewrite: (url$1) => {
-				url$1.pathname = url$1.pathname.replace(`${this.env.SERVER_API_PREFIX}/${name}`, remote.prefix);
+			rewrite: (url) => {
+				url.pathname = url.pathname.replace(`${this.env.SERVER_API_PREFIX}/${name}`, remote.prefix);
 			},
 			...proxy
 		});
@@ -461,18 +468,24 @@ var ServerLinksProvider = class {
 //#endregion
 //#region ../../src/server/links/index.ts
 /**
-* Provides server-side link management and remote capabilities for client-server interactions.
+* | type | quality | stability |
+* |------|---------|-----------|
+* | backend | standard | stable |
+*
+* Type-safe API client with request deduplication.
 *
-* The server-links module enables declarative link definitions using `$remote` and `$client` primitives,
-* facilitating seamless API endpoint management and client-server communication. It integrates with server
-* security features to ensure safe and controlled access to resources.
+* **Features:**
+* - Virtual HTTP client for type-safe API calls
+* - Remote action definitions
+* - Type inference from action schemas
+* - Request deduplication
+* - Automatic error handling
 *
-* @see {@link $remote}
-* @see {@link $client}
 * @module alepha.server.links
 */
 const AlephaServerLinks = $module({
 	name: "alepha.server.links",
+	atoms: [apiLinksAtom],
 	primitives: [$remote, $client],
 	services: [
 		AlephaServer,