@makaio/framework 1.0.0-dev-1785409369816 → 1.0.0-dev-1787670071418

package/dist/index-DQ8o3JGi.d.mts

@@ -0,0 +1,132 @@
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region core/contracts/src/capability/types.d.ts
+/**
+ * Base interface all capability providers must implement.
+ *
+ * Capability providers are registered by extensions to provide
+ * platform-specific or service-specific functionality.
+ */
+interface ICapabilityProvider {
+  /** Unique identifier for this provider instance */
+  readonly id: string;
+  /** Human-readable name for display in UI */
+  readonly displayName: string;
+  /**
+   * Stable provider identity used for joins across registries.
+   *
+   * Unlike {@link id}, this should remain stable across runtime re-registration.
+   */
+  readonly providerKey?: string;
+  /**
+   * Optional validation method to check provider configuration/credentials.
+   * @returns Validation result with optional error message
+   */
+  validate?(): Promise<{
+    valid: boolean;
+    error?: string;
+  }>;
+}
+/**
+ * Interface for capability-based services that can be auto-wired by the runtime.
+ *
+ * Services implementing this interface can be registered declaratively
+ * and the runtime will handle initialization and shutdown automatically.
+ */
+interface ICapabilityBasedService {
+  /** The capability ID this service handles */
+  readonly capabilityId: string;
+  /** Initialize the service and register bus handlers */
+  init(): Promise<void>;
+  /** Destroy the service and cleanup handlers. Async teardown is allowed. */
+  destroy(): Promise<void> | void;
+}
+//#endregion
+//#region core/contracts/src/capability/schemas.d.ts
+/**
+ * Provider summary for list responses.
+ */
+declare const ProviderSummarySchema: z.ZodObject<{
+  id: z.ZodString;
+  displayName: z.ZodString;
+  providerKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Validation result for a single provider.
+ */
+/**
+ * Capability provider registration payload.
+ *
+ * Note: Provider is typed as unknown at the Zod level because providers
+ * are runtime objects with methods that Zod cannot validate.
+ * Type safety is enforced via typed registration helpers in service packages.
+ */
+declare const ProviderRegistrationSchema: z.ZodObject<{
+  capabilityId: z.ZodString;
+  provider: z.ZodUnknown;
+}, z.core.$strip>;
+/**
+ * Capability provider unregistration payload.
+ */
+declare const ProviderUnregistrationSchema: z.ZodObject<{
+  capabilityId: z.ZodString;
+  providerId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Capability domain schemas.
+ *
+ * Subjects for capability-related bus communication.
+ * Each key becomes a subject identifier as: `capability.{key}`
+ * @example
+ * ```typescript
+ * // List all push notification providers
+ * const result = await bus.request(CapabilitySubjects.listProviders, {
+ *   capabilityId: 'push-notification',
+ * });
+ * ```
+ */
+/** Type exports for external use */
+type ProviderSummary = z.infer<typeof ProviderSummarySchema>;
+type ProviderRegistration = z.infer<typeof ProviderRegistrationSchema>;
+type ProviderUnregistration = z.infer<typeof ProviderUnregistrationSchema>;
+//#endregion
+//#region core/contracts/src/capability/namespace.d.ts
+declare const CapabilitySubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"capability", {
+  listProviders: {
+    request: _$zod.ZodObject<{
+      capabilityId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      providers: _$zod.ZodArray<_$zod.ZodObject<{
+        id: _$zod.ZodString;
+        displayName: _$zod.ZodString;
+        providerKey: _$zod.ZodOptional<_$zod.ZodString>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  validate: {
+    request: _$zod.ZodObject<{
+      capabilityId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      results: _$zod.ZodArray<_$zod.ZodObject<{
+        id: _$zod.ZodString;
+        valid: _$zod.ZodBoolean;
+        error: _$zod.ZodOptional<_$zod.ZodString>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  register: _$zod.ZodObject<{
+    capabilityId: _$zod.ZodString;
+    provider: _$zod.ZodUnknown;
+  }, _$zod_v4_core0.$strip>;
+  unregister: _$zod.ZodObject<{
+    capabilityId: _$zod.ZodString;
+    providerId: _$zod.ZodString;
+  }, _$zod_v4_core0.$strip>;
+}>, "capability">;
+//#endregion
+export { ICapabilityBasedService as a, ProviderUnregistration as i, ProviderRegistration as n, ICapabilityProvider as o, ProviderSummary as r, CapabilitySubjects as t };

package/dist/index-DWBkiiXH.d.mts

@@ -0,0 +1,18 @@
+import { t as CapabilityService } from "./capability-service-BW1-teFU.mjs";
+import { IMakaioBus } from "@makaio/framework/bus";
+import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
+import { MakaioNodeExtension } from "@makaio/framework/contracts";
+
+//#region services/core/src/capability/package.d.ts
+/** Token for the capability registry service. */
+declare const CapabilityToken: _$_makaio_contracts0.ExtensionToken<CapabilityService>;
+/**
+ * Package that starts the framework capability registry.
+ *
+ * The token and package live with the service rather than in the aggregate
+ * package list so that a domain depending on the capability registry can
+ * resolve the token without importing every other framework package.
+ */
+declare const capabilityPackage: MakaioNodeExtension<IMakaioBus>;
+//#endregion
+export { capabilityPackage as n, CapabilityToken as t };

package/dist/{index-DlsHL9Jg.d.mts → index-DXtQRehh.d.mts}

@@ -1,4 +1,4 @@
-import { H as ClientDefinition, U as ClientDefinitionInput } from "./hook-responses-Dh1PWXqJ.mjs";
+import { D as ClientDefinitionInput, E as ClientDefinition } from "./hook-responses-9Ywsqzzq.mjs";
 import * as _$zod from "zod";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -90,8 +90,8 @@ declare const ClientSchemas: {
       projectDir: z.ZodOptional<z.ZodString>;
       configInheritance: z.ZodOptional<z.ZodEnum<{
         empty: "empty";
-        full: "full";
         "auth-only": "auth-only";
+        full: "full";
       }>>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -509,8 +509,8 @@ declare const ClientSchemas: {
       fork: "fork";
       resume: "resume";
       fresh: "fresh";
-      compact: "compact";
       clear: "clear";
+      compact: "compact";
     }>>;
     parentAdapterSessionId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
@@ -1489,8 +1489,8 @@ declare const ClientSessionStartModeSchema: z.ZodEnum<{
   fork: "fork";
   resume: "resume";
   fresh: "fresh";
-  compact: "compact";
   clear: "clear";
+  compact: "compact";
 }>;
 /** Client-reported session start mode discriminator. */
 type ClientSessionStartMode = z.infer<typeof ClientSessionStartModeSchema>;
@@ -1508,8 +1508,8 @@ declare const ClientSessionStartedSchema: z.ZodObject<{
     fork: "fork";
     resume: "resume";
     fresh: "fresh";
-    compact: "compact";
     clear: "clear";
+    compact: "compact";
   }>>;
   parentAdapterSessionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -1676,8 +1676,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
       projectDir: _$zod.ZodOptional<_$zod.ZodString>;
       configInheritance: _$zod.ZodOptional<_$zod.ZodEnum<{
         empty: "empty";
-        full: "full";
         "auth-only": "auth-only";
+        full: "full";
       }>>;
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
@@ -2079,8 +2079,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
       fork: "fork";
       resume: "resume";
       fresh: "fresh";
-      compact: "compact";
       clear: "clear";
+      compact: "compact";
     }>>;
     parentAdapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
   }, _$zod_v4_core0.$strip>;
@@ -2316,8 +2316,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
       projectDir: _$zod.ZodOptional<_$zod.ZodString>;
       configInheritance: _$zod.ZodOptional<_$zod.ZodEnum<{
         empty: "empty";
-        full: "full";
         "auth-only": "auth-only";
+        full: "full";
       }>>;
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
@@ -2719,8 +2719,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
       fork: "fork";
       resume: "resume";
       fresh: "fresh";
-      compact: "compact";
       clear: "clear";
+      compact: "compact";
     }>>;
     parentAdapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
   }, _$zod_v4_core0.$strip>;
@@ -2979,8 +2979,8 @@ declare const SessionConfigEnvSchema: z.ZodRecord<z.ZodString, z.ZodString>;
  */
 declare const SessionConfigInheritanceSchema: z.ZodEnum<{
   empty: "empty";
-  full: "full";
   "auth-only": "auth-only";
+  full: "full";
 }>;
 type SessionConfigInheritance = z.infer<typeof SessionConfigInheritanceSchema>;
 /**
@@ -3137,8 +3137,8 @@ declare const ClientSessionConfigSchemas: {
       projectDir: z.ZodOptional<z.ZodString>;
       configInheritance: z.ZodOptional<z.ZodEnum<{
         empty: "empty";
-        full: "full";
         "auth-only": "auth-only";
+        full: "full";
       }>>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -3193,8 +3193,8 @@ declare const SessionConfigSetupRequestSchema: z.ZodObject<{
   }>;
   configInheritance: z.ZodEnum<{
     empty: "empty";
-    full: "full";
     "auth-only": "auth-only";
+    full: "full";
   }>;
 }, z.core.$strip>;
 type SessionConfigSetupRequest = z.infer<typeof SessionConfigSetupRequestSchema>;