@angriff36/manifest 2.18.0

package/dist/manifest/examples.js

@@ -0,0 +1,443 @@
+export const examples = [
+    {
+        name: 'Kitchen Module',
+        desc: 'Full module with commands, policies, and events',
+        code: `// Module: encapsulates related entities and commands
+module kitchen {
+  entity PrepTask {
+    property required id: string
+    property required name: string
+    property assignedTo: string?
+    property status: string = "pending"
+    property priority: number = 1
+
+    // Computed property - auto-recalculates
+    computed isUrgent: boolean = priority >= 3
+
+    // Relationships
+    belongsTo station: Station
+    hasMany ingredients: Ingredient
+
+    // Commands - explicit business operations
+    command claim(employeeId: string) {
+      guard self.status == "pending"
+      guard user.role == "cook" or user.role == "chef"
+      mutate assignedTo = employeeId
+      mutate status = "in_progress"
+      emit taskClaimed
+    }
+
+    command complete() {
+      guard self.status == "in_progress"
+      guard self.assignedTo == user.id
+      mutate status = "completed"
+      emit taskCompleted
+    }
+
+    // Policies - auth rules
+    policy canView read: true
+    policy canClaim execute: user.role in ["cook", "chef"]
+    policy canEdit write: user.id == assignedTo or user.role == "chef"
+
+    constraint validStatus: status in ["pending", "in_progress", "completed"]
+    constraint validPriority: priority >= 1 and priority <= 5
+  }
+
+  entity Station {
+    property required id: string
+    property required name: string
+    property capacity: number = 4
+    hasMany tasks: PrepTask
+  }
+
+  entity Ingredient {
+    property required id: string
+    property required name: string
+    property quantity: number = 0
+    property unit: string = "g"
+  }
+
+  // Outbox events for realtime
+  event TaskClaimed: "kitchen.task.claimed" {
+    taskId: string
+    employeeId: string
+    stationId: string
+  }
+
+  event TaskCompleted: "kitchen.task.completed" {
+    taskId: string
+    completedBy: string
+    duration: number
+  }
+}
+
+// Persistence
+store PrepTask in supabase { table: "prep_tasks" }
+store Station in supabase { table: "stations" }
+
+// API with server generation
+expose PrepTask as rest server "/api/tasks" {
+  list, get, create, update
+}`
+    },
+    {
+        name: 'Order with Computed',
+        desc: 'Derived properties that auto-update',
+        code: `entity OrderItem {
+  property required id: string
+  property required productId: string
+  property required name: string
+  property price: number = 0
+  property quantity: number = 1
+  property discount: number = 0
+
+  // Computed properties - spreadsheet-like
+  computed subtotal: number = price * quantity
+  computed discountAmount: number = subtotal * (discount / 100)
+  computed total: number = subtotal - discountAmount
+}
+
+entity Order {
+  property required id: string
+  property customerId: string?
+  property status: string = "draft"
+  property taxRate: number = 0.08
+  property readonly createdAt: string = now()
+
+  hasMany items: OrderItem
+
+  // These recompute when items change
+  computed itemCount: number = items.length
+  computed subtotal: number = items.reduce((sum, i) => sum + i.total, 0)
+  computed tax: number = subtotal * taxRate
+  computed total: number = subtotal + tax
+
+  command addItem(productId: string, name: string, price: number, quantity: number) {
+    guard self.status == "draft"
+    compute newItem = { id: uuid(), productId: productId, name: name, price: price, quantity: quantity }
+    mutate items = items.concat([newItem])
+    emit itemAdded
+  }
+
+  command submit() {
+    guard self.status == "draft"
+    guard self.items.length > 0
+    mutate status = "submitted"
+    emit orderSubmitted
+  }
+
+  constraint hasItems: status != "submitted" or items.length > 0 "Order must have items"
+}
+
+store Order in localStorage { key: "orders" }
+expose Order as function`
+    },
+    {
+        name: 'User with Policies',
+        desc: 'Auth and permission rules',
+        code: `entity User {
+  property required id: string
+  property required email: string
+  property name: string = ""
+  property role: string = "user"
+  property teamId: string?
+  property active: boolean = true
+  property loginAttempts: number = 0
+  property readonly createdAt: string = now()
+
+  // Only admins or self can read sensitive data
+  policy readBasic read: true
+  policy readSensitive read: user.id == self.id or user.role == "admin"
+
+  // Only admins can change roles
+  policy canChangeRole write: user.role == "admin" "Only admins can modify users"
+
+  // Self or admin can deactivate
+  policy canDeactivate execute: user.id == self.id or user.role == "admin"
+
+  command deactivate() {
+    guard self.active == true
+    mutate active = false
+    emit userDeactivated
+  }
+
+  command changeRole(newRole: string) {
+    guard user.role == "admin"
+    mutate role = newRole
+    emit roleChanged
+  }
+
+  constraint validEmail: email contains "@" "Invalid email"
+  constraint validRole: role in ["user", "manager", "admin"]
+}
+
+entity Team {
+  property required id: string
+  property required name: string
+  property ownerId: string
+
+  hasMany members: User
+
+  policy canView read: user.teamId == self.id or user.role == "admin"
+  policy canEdit write: user.id == ownerId or user.role == "admin"
+}
+
+store User in supabase { table: "users" }
+store Team in supabase { table: "teams" }
+
+expose User as rest server "/api/users" {
+  list, get, create, update, delete
+}`
+    },
+    {
+        name: 'Realtime Events',
+        desc: 'Outbox pattern for pub/sub',
+        code: `// Define event types for realtime channels
+event OrderCreated: "orders.created" {
+  orderId: string
+  customerId: string
+  total: number
+}
+
+event OrderStatusChanged: "orders.status" {
+  orderId: string
+  oldStatus: string
+  newStatus: string
+  timestamp: string
+}
+
+event InventoryLow: "inventory.alerts" {
+  productId: string
+  productName: string
+  currentStock: number
+  threshold: number
+}
+
+entity Order {
+  property required id: string
+  property customerId: string
+  property status: string = "pending"
+  property total: number = 0
+
+  command create(customerId: string, total: number) {
+    mutate customerId = customerId
+    mutate total = total
+    // Publish to outbox
+    publish OrderCreated
+    emit created
+  }
+
+  command updateStatus(newStatus: string) {
+    guard newStatus in ["pending", "processing", "shipped", "delivered"]
+    publish OrderStatusChanged
+    mutate status = newStatus
+    emit statusChanged
+  }
+}
+
+entity Product {
+  property required id: string
+  property required name: string
+  property stock: number = 0
+  property lowStockThreshold: number = 10
+
+  computed isLowStock: boolean = stock <= lowStockThreshold
+
+  command reduceStock(amount: number) {
+    guard self.stock >= amount
+    mutate stock = stock - amount
+    // Alert when stock is low
+    compute checkLowStock()
+    emit stockReduced
+  }
+
+  behavior on stockReduced when isLowStock {
+    publish InventoryLow
+  }
+}
+
+store Order in supabase
+store Product in supabase
+
+expose Order as rest server "/api/orders"
+expose Product as rest server "/api/products"`
+    },
+    {
+        name: 'E-commerce System',
+        desc: 'Full composition with relationships',
+        code: `entity Customer {
+  property required id: string
+  property required email: string
+  property name: string = ""
+  property loyaltyPoints: number = 0
+
+  hasMany orders: Order
+  hasOne cart: ShoppingCart
+
+  computed totalSpent: number = orders.reduce((sum, o) => sum + o.total, 0)
+  computed tier: string = totalSpent > 1000 ? "gold" : totalSpent > 500 ? "silver" : "bronze"
+
+  command addLoyaltyPoints(points: number) {
+    mutate loyaltyPoints = loyaltyPoints + points
+    emit pointsAdded
+  }
+}
+
+entity ShoppingCart {
+  property required id: string
+  property customerId: string
+
+  hasMany items: CartItem
+  belongsTo customer: Customer
+
+  computed itemCount: number = items.length
+  computed subtotal: number = items.reduce((sum, i) => sum + i.total, 0)
+
+  command addItem(productId: string, price: number, quantity: number) {
+    compute item = { id: uuid(), productId: productId, price: price, quantity: quantity }
+    mutate items = items.concat([item])
+    emit itemAdded
+  }
+
+  command checkout() {
+    guard self.items.length > 0
+    emit checkoutStarted
+  }
+
+  command clear() {
+    mutate items = []
+    emit cartCleared
+  }
+}
+
+entity CartItem {
+  property required id: string
+  property required productId: string
+  property price: number = 0
+  property quantity: number = 1
+  computed total: number = price * quantity
+
+  belongsTo cart: ShoppingCart
+  ref product: Product
+}
+
+entity Product {
+  property required id: string
+  property required name: string
+  property required price: number
+  property stock: number = 0
+  property category: string = "general"
+
+  hasMany cartItems: CartItem
+
+  constraint positivePrice: price > 0 "Price must be positive"
+  constraint validStock: stock >= 0 "Stock cannot be negative"
+}
+
+entity Order {
+  property required id: string
+  property customerId: string
+  property status: string = "pending"
+  property total: number = 0
+
+  hasMany items: OrderItem
+  belongsTo customer: Customer
+
+  command process() {
+    guard self.status == "pending"
+    mutate status = "processing"
+    emit orderProcessing
+  }
+
+  command ship() {
+    guard self.status == "processing"
+    mutate status = "shipped"
+    emit orderShipped
+  }
+}
+
+entity OrderItem {
+  property required id: string
+  property productId: string
+  property quantity: number = 1
+  property price: number = 0
+
+  belongsTo order: Order
+  ref product: Product
+
+  computed total: number = price * quantity
+}
+
+// Persistence configuration
+store Customer in supabase
+store ShoppingCart in memory
+store Product in supabase
+store Order in supabase
+
+// Compose the checkout flow
+compose CheckoutFlow {
+  ShoppingCart as cart
+  Order as order
+  Customer as customer
+
+  connect cart.checkoutStarted -> order.create
+  connect order.orderProcessing -> customer.addLoyaltyPoints
+}
+
+expose Customer as rest server "/api/customers"
+expose Product as rest server "/api/products"
+expose Order as rest server "/api/orders"`
+    },
+    {
+        name: 'Simple Counter',
+        desc: 'Basic example with all v2 features',
+        code: `// Simple counter showing v2 features
+
+entity Counter {
+  property value: number = 0
+  property step: number = 1
+  property maxValue: number = 100
+  property minValue: number = 0
+
+  // Computed - auto updates
+  computed percentage: number = (value / maxValue) * 100
+  computed isAtMax: boolean = value >= maxValue
+  computed isAtMin: boolean = value <= minValue
+
+  // Commands instead of behaviors
+  command increment() {
+    guard not self.isAtMax
+    mutate value = value + step
+    emit incremented
+  }
+
+  command decrement() {
+    guard not self.isAtMin
+    mutate value = value - step
+    emit decremented
+  }
+
+  command reset() {
+    mutate value = 0
+    emit reset
+  }
+
+  command setStep(newStep: number) {
+    guard newStep > 0
+    mutate step = newStep
+    emit stepChanged
+  }
+
+  // Constraints
+  constraint inRange: value >= minValue and value <= maxValue "Value out of range"
+  constraint positiveStep: step > 0 "Step must be positive"
+}
+
+// Store in browser
+store Counter in localStorage { key: "counter" }
+
+// Generate function factory
+expose Counter as function`
+    }
+];
+//# sourceMappingURL=examples.js.map

package/dist/manifest/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../src/manifest/examples.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,iDAAiD;QACvD,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4ER;KACC;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA+Ce;KACtB;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,2BAA2B;QACjC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDR;KACC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAoEoC;KAC3C;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CAyHgC;KACvC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA8CiB;KACxB;CACF,CAAC"}

package/dist/manifest/federation/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Federation client — invokes commands on remote Manifest services.
+ *
+ * The client translates FederationRequest into HTTP calls, attaches
+ * policy bridge headers, handles timeouts and retries, and normalizes
+ * responses into FederationResponse objects.
+ *
+ * The client is transport-agnostic: pass a custom FederationTransport
+ * to swap fetch for gRPC, message queues, or test fakes.
+ *
+ * @module federation/client
+ */
+import type { FederationRequest, FederationResponse, FederationClientOptions, FederationTransport, PolicyBridgeHeaders, ServiceDescriptor } from './types';
+import { FederationRegistry } from './registry';
+/**
+ * Default HTTP transport using fetch.
+ */
+export declare class HttpFederationTransport implements FederationTransport {
+    private fetchImpl;
+    constructor(fetchImpl?: typeof fetch);
+    invoke(descriptor: ServiceDescriptor, request: FederationRequest, options: {
+        timeoutMs: number;
+        authToken?: string;
+    }): Promise<FederationResponse>;
+}
+/**
+ * Build the set of policy bridge headers for a cross-service call.
+ * Exported for testability and for custom transports.
+ */
+export declare function buildBridgeHeaders(bridge: PolicyBridgeHeaders): Record<string, string>;
+/**
+ * FederationClient: invokes commands on services in the federation.
+ */
+export declare class FederationClient {
+    private registry;
+    private options;
+    private transport;
+    constructor(registry: FederationRegistry, options?: FederationClientOptions, transport?: FederationTransport);
+    /**
+     * Invoke a command on a remote service.
+     * Throws if the service/entity/command is not found in the registry.
+     * Retries transient failures up to maxRetries times if the command is idempotent.
+     */
+    invoke(request: FederationRequest): Promise<FederationResponse>;
+    private delay;
+}
+/**
+ * Determine if a federation response represents a transient failure
+ * that is safe to retry (e.g. network error, 5xx).
+ */
+export declare function isTransientFailure(response: FederationResponse): boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/manifest/federation/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/manifest/federation/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,SAAS,CAAe;gBAEpB,SAAS,GAAE,OAAO,KAAwB;IAIhD,MAAM,CACV,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,kBAAkB,CAAC;CAuC/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWtF;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAEb;IACF,OAAO,CAAC,SAAS,CAAsB;gBAGrC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,mBAAmB;IAajC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiCrE,OAAO,CAAC,KAAK;CAGd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAOxE"}

package/dist/manifest/federation/client.js

@@ -0,0 +1,152 @@
+/**
+ * Federation client — invokes commands on remote Manifest services.
+ *
+ * The client translates FederationRequest into HTTP calls, attaches
+ * policy bridge headers, handles timeouts and retries, and normalizes
+ * responses into FederationResponse objects.
+ *
+ * The client is transport-agnostic: pass a custom FederationTransport
+ * to swap fetch for gRPC, message queues, or test fakes.
+ *
+ * @module federation/client
+ */
+/**
+ * Default HTTP transport using fetch.
+ */
+export class HttpFederationTransport {
+    fetchImpl;
+    constructor(fetchImpl = globalThis.fetch) {
+        this.fetchImpl = fetchImpl;
+    }
+    async invoke(descriptor, request, options) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), options.timeoutMs);
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Attach policy bridge headers
+        for (const [key, value] of Object.entries(buildBridgeHeaders(request.bridge))) {
+            if (value !== undefined)
+                headers[key] = value;
+        }
+        // Attach auth token if the service requires it
+        if (options.authToken && descriptor.auth && descriptor.auth.scheme === 'bearer') {
+            headers['Authorization'] = `Bearer ${options.authToken}`;
+        }
+        try {
+            const url = `${descriptor.endpoint}/__manifest/federation/${encodeURIComponent(request.entity)}/${encodeURIComponent(request.command)}`;
+            const res = await this.fetchImpl(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ input: request.input, idempotencyKey: request.idempotencyKey }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            return (await res.json());
+        }
+        catch (err) {
+            clearTimeout(timeout);
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+                emittedEvents: [],
+                handledBy: descriptor.serviceId,
+                respondedAt: Date.now(),
+            };
+        }
+    }
+}
+/**
+ * Build the set of policy bridge headers for a cross-service call.
+ * Exported for testability and for custom transports.
+ */
+export function buildBridgeHeaders(bridge) {
+    const headers = {};
+    if (bridge.actorId)
+        headers['X-Manifest-Actor'] = bridge.actorId;
+    if (bridge.tenantId)
+        headers['X-Manifest-Tenant'] = bridge.tenantId;
+    if (bridge.orgId)
+        headers['X-Manifest-Org'] = bridge.orgId;
+    if (bridge.actorRoles && bridge.actorRoles.length > 0) {
+        headers['X-Manifest-Roles'] = bridge.actorRoles.join(',');
+    }
+    if (bridge.requestId)
+        headers['X-Request-Id'] = bridge.requestId;
+    if (bridge.correlationId)
+        headers['X-Correlation-Id'] = bridge.correlationId;
+    return headers;
+}
+/**
+ * FederationClient: invokes commands on services in the federation.
+ */
+export class FederationClient {
+    registry;
+    options;
+    transport;
+    constructor(registry, options = {}, transport) {
+        this.registry = registry;
+        this.options = {
+            defaultTimeoutMs: options.defaultTimeoutMs ?? 30000,
+            maxRetries: options.maxRetries ?? 0,
+            retryDelayMs: options.retryDelayMs ?? 1000,
+            resolveAuthToken: options.resolveAuthToken,
+            fetchImpl: options.fetchImpl ?? globalThis.fetch,
+        };
+        this.transport = transport ?? new HttpFederationTransport(this.options.fetchImpl);
+    }
+    /**
+     * Invoke a command on a remote service.
+     * Throws if the service/entity/command is not found in the registry.
+     * Retries transient failures up to maxRetries times if the command is idempotent.
+     */
+    async invoke(request) {
+        const found = this.registry.findCommand(request.entity, request.command);
+        if (!found) {
+            return {
+                success: false,
+                error: `Command "${request.command}" on entity "${request.entity}" not found in federation registry`,
+                emittedEvents: [],
+                handledBy: request.serviceId,
+                respondedAt: Date.now(),
+            };
+        }
+        const { service: descriptor } = found;
+        const timeoutMs = request.timeoutMs ?? this.options.defaultTimeoutMs;
+        const authToken = this.options.resolveAuthToken?.(descriptor.serviceId);
+        const maxAttempts = found.command.idempotent
+            ? this.options.maxRetries + 1
+            : 1;
+        let lastResponse;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            if (attempt > 0) {
+                await this.delay(this.options.retryDelayMs);
+            }
+            const response = await this.transport.invoke(descriptor, request, { timeoutMs, authToken });
+            lastResponse = response;
+            if (response.success)
+                return response;
+            // Only retry on transport-level errors (no success field implies transport failure)
+            if (!isTransientFailure(response))
+                break;
+        }
+        return lastResponse;
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Determine if a federation response represents a transient failure
+ * that is safe to retry (e.g. network error, 5xx).
+ */
+export function isTransientFailure(response) {
+    if (response.success)
+        return false;
+    // Transport-level: error message indicates connection issue
+    if (response.error && /abort|fetch|network|timeout|ECONNREFUSED|ENOTFOUND/i.test(response.error)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=client.js.map

package/dist/manifest/federation/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/manifest/federation/client.ts"],"names":[],"mappings":"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"}

package/dist/manifest/federation/descriptor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * IR-to-descriptor conversion — builds ServiceDescriptors from Manifest IRs.
+ *
+ * Extracts exposed entities and commands from a compiled IR so services
+ * can advertise their federation surface to peers.
+ *
+ * @module federation/descriptor
+ */
+import type { IR } from '../ir';
+import type { ServiceDescriptor } from './types';
+/**
+ * Build a ServiceDescriptor from a compiled IR and a service identity.
+ * Only entities and commands explicitly listed in `expose` are advertised;
+ * if `expose` is omitted, all entities with commands are exposed.
+ */
+export declare function buildDescriptor(serviceId: string, ir: IR, options: {
+    endpoint: string;
+    displayName?: string;
+    auth?: ServiceDescriptor['auth'];
+    /** Explicit list of entity names to expose. Omit to expose all with commands. */
+    exposeEntities?: string[];
+    /** Per-command policy requirements. Defaults to the command's own policy list. */
+    commandPolicies?: Record<string, string[]>;
+}): ServiceDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/manifest/federation/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/manifest/federation/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAiC,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,EAAE,EACN,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5C,GACA,iBAAiB,CA2CnB"}