@sensigo/realm 0.1.0

package/dist/adapters/shopify-adapter.js

@@ -0,0 +1,415 @@
+// ShopifyAdapter — communicates with the Shopify Admin GraphQL API.
+import { WorkflowError } from '../types/workflow-error.js';
+import { parseRetryAfterHeader } from './adapter-utils.js';
+const SHOPIFY_DEFAULT_API_VERSION = '2024-04';
+const ORDERS_BY_NAME_QUERY = `
+query OrderByName($query: String!) {
+  orders(first: 1, query: $query) {
+    edges {
+      node {
+        id
+        legacyResourceId
+        number
+        name
+        displayFinancialStatus
+        displayFulfillmentStatus
+        cancelledAt
+        cancelReason
+        createdAt
+        customer {
+          firstName
+          lastName
+          email
+        }
+        currentTotalPriceSet {
+          shopMoney { amount currencyCode }
+        }
+        currentSubtotalPriceSet {
+          shopMoney { amount }
+        }
+        currentShippingPriceSet {
+          shopMoney { amount }
+        }
+        discountCodes
+        lineItems(first: 50) {
+          edges {
+            node {
+              name
+              quantity
+              originalUnitPriceSet {
+                shopMoney { amount }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+`.trim();
+/**
+ * ShopifyAdapter communicates with the Shopify Admin GraphQL API.
+ *
+ * Supported operations:
+ *   fetch('get_order', { store, order_name })   — POST /admin/api/{version}/graphql.json
+ */
+export class ShopifyAdapter {
+    id;
+    defaultRetryAfterSeconds = 30;
+    apiVersion;
+    baseUrlOverride;
+    stores;
+    constructor(id, config) {
+        const storeEntries = Object.entries(config.stores);
+        if (storeEntries.length === 0) {
+            throw new Error('ShopifyAdapter: stores must not be empty');
+        }
+        for (const [key, store] of storeEntries) {
+            if (key === '') {
+                throw new Error('ShopifyAdapter: store key must not be an empty string');
+            }
+            if (!/^[a-zA-Z0-9][a-zA-Z0-9-]*\.myshopify\.com$/.test(store.shop_domain)) {
+                throw new Error(`ShopifyAdapter: invalid shop_domain for store "${key}"`);
+            }
+            if (store.access_token === '') {
+                throw new Error(`ShopifyAdapter: access_token must not be empty for store "${key}"`);
+            }
+        }
+        if (config.api_version !== undefined && !/^\d{4}-\d{2}$/.test(config.api_version)) {
+            throw new Error('ShopifyAdapter: invalid api_version');
+        }
+        this.id = id;
+        this.stores = config.stores;
+        this.apiVersion = config.api_version ?? SHOPIFY_DEFAULT_API_VERSION;
+        this.baseUrlOverride = config.base_url?.replace(/\/$/, '');
+    }
+    checkAborted(signal) {
+        if (signal?.aborted === true) {
+            throw new WorkflowError('Adapter request aborted', {
+                code: 'STEP_ABORTED',
+                category: 'ENGINE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+    }
+    async executeRequest(url, options, signal) {
+        this.checkAborted(signal);
+        let response;
+        try {
+            response = await fetch(url, { ...options, signal: signal ?? null });
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new WorkflowError('Adapter request aborted', {
+                    code: 'STEP_ABORTED',
+                    category: 'ENGINE',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            throw new WorkflowError(message, {
+                code: 'NETWORK_UNREACHABLE',
+                category: 'NETWORK',
+                agentAction: 'wait_for_human',
+                retryable: true,
+            });
+        }
+        return response;
+    }
+    async throwHttpError(response, operation) {
+        // Read body as text first — avoids "body already consumed" if JSON.parse fails.
+        const rawText = await response.text();
+        let body;
+        try {
+            body = JSON.parse(rawText);
+        }
+        catch {
+            body = rawText;
+        }
+        const status = response.status;
+        const details = { status, operation, body };
+        if (status === 429) {
+            const retryAfterFromHeader = parseRetryAfterHeader(response.headers.get('Retry-After'));
+            throw new WorkflowError('Rate limited by Shopify API', {
+                code: 'SERVICE_RATE_LIMITED',
+                category: 'SERVICE',
+                agentAction: 'wait_and_proceed',
+                retryable: true,
+                ...(retryAfterFromHeader !== undefined ? { retry_after: retryAfterFromHeader } : {}),
+                details,
+            });
+        }
+        if (status === 401) {
+            throw new WorkflowError('Shopify authentication failed — check access token', {
+                code: 'SERVICE_AUTH_FAILED',
+                category: 'SERVICE',
+                agentAction: 'stop',
+                retryable: false,
+                details,
+            });
+        }
+        if (status >= 400 && status < 500) {
+            throw new WorkflowError(`HTTP ${status}: ${response.statusText}`, {
+                code: 'SERVICE_HTTP_4XX',
+                category: 'SERVICE',
+                agentAction: 'stop',
+                retryable: false,
+                details,
+            });
+        }
+        // 5xx
+        throw new WorkflowError(`Shopify server error (HTTP ${status})`, {
+            code: 'SERVICE_HTTP_5XX',
+            category: 'SERVICE',
+            agentAction: 'report_to_user',
+            retryable: true,
+            details,
+        });
+    }
+    normalizeOrder(node, store, normalizedOrderName) {
+        if (typeof node.id !== 'string' || node.id === '') {
+            throw new WorkflowError('ShopifyAdapter: missing order id in response', {
+                code: 'SERVICE_RESPONSE_INVALID',
+                category: 'SERVICE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        if (typeof node.number !== 'number') {
+            throw new WorkflowError('ShopifyAdapter: missing order number in response', {
+                code: 'SERVICE_RESPONSE_INVALID',
+                category: 'SERVICE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        if (typeof node.displayFulfillmentStatus !== 'string' || node.displayFulfillmentStatus === '') {
+            throw new WorkflowError('ShopifyAdapter: missing fulfillment_status in response', {
+                code: 'SERVICE_RESPONSE_INVALID',
+                category: 'SERVICE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        if (typeof node.createdAt !== 'string') {
+            throw new WorkflowError('ShopifyAdapter: missing created_at in response', {
+                code: 'SERVICE_RESPONSE_INVALID',
+                category: 'SERVICE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        const totalPrice = node.currentTotalPriceSet?.shopMoney?.amount;
+        if (typeof totalPrice !== 'string') {
+            throw new WorkflowError('ShopifyAdapter: missing total_price in response', {
+                code: 'SERVICE_RESPONSE_INVALID',
+                category: 'SERVICE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        const subtotalPrice = node.currentSubtotalPriceSet?.shopMoney?.amount;
+        if (typeof subtotalPrice !== 'string') {
+            throw new WorkflowError('ShopifyAdapter: missing subtotal_price in response', {
+                code: 'SERVICE_RESPONSE_INVALID',
+                category: 'SERVICE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        const customer = node.customer != null
+            ? {
+                first_name: node.customer.firstName,
+                last_name: node.customer.lastName,
+                email: node.customer.email || null,
+            }
+            : null;
+        const lineItems = (node.lineItems?.edges ?? []).map((edge) => ({
+            name: edge.node.name,
+            quantity: edge.node.quantity,
+            price: edge.node.originalUnitPriceSet?.shopMoney?.amount ?? '0.00',
+        }));
+        void store;
+        void normalizedOrderName;
+        return {
+            id: node.id,
+            legacy_id: String(node.legacyResourceId ?? ''),
+            order_number: node.number,
+            name: String(node.name ?? ''),
+            financial_status: typeof node.displayFinancialStatus === 'string' ? node.displayFinancialStatus : null,
+            fulfillment_status: node.displayFulfillmentStatus,
+            cancelled_at: typeof node.cancelledAt === 'string' ? node.cancelledAt : null,
+            cancel_reason: typeof node.cancelReason === 'string' ? node.cancelReason : null,
+            created_at: node.createdAt,
+            customer,
+            total_price: totalPrice,
+            subtotal_price: subtotalPrice,
+            shipping_total: node.currentShippingPriceSet?.shopMoney?.amount ?? '0.00',
+            currency: node.currentTotalPriceSet?.shopMoney?.currencyCode ?? '',
+            discount_codes: Array.isArray(node.discountCodes) ? node.discountCodes : [],
+            line_items: lineItems,
+        };
+    }
+    async fetch(operation, params, _config, signal) {
+        // config.auth is ignored — auth is set at construction time via stores map
+        if (operation === 'get_order') {
+            // Validate store param
+            const store = params['store'];
+            if (typeof store !== 'string') {
+                throw new WorkflowError('ShopifyAdapter: store param must be a string', {
+                    code: 'ADAPTER_VALIDATION_FAILED',
+                    category: 'ENGINE',
+                    agentAction: 'provide_input',
+                    retryable: false,
+                });
+            }
+            const storeConfig = this.stores[store];
+            if (storeConfig === undefined) {
+                throw new WorkflowError(`ShopifyAdapter: unknown store "${store}"`, {
+                    code: 'ADAPTER_VALIDATION_FAILED',
+                    category: 'ENGINE',
+                    agentAction: 'provide_input',
+                    retryable: false,
+                    details: { store },
+                });
+            }
+            // Validate order_name
+            const rawOrderName = params['order_name'];
+            if (typeof rawOrderName !== 'string' || rawOrderName === '') {
+                throw new WorkflowError('ShopifyAdapter: order_name param must be a non-empty string', {
+                    code: 'ADAPTER_VALIDATION_FAILED',
+                    category: 'ENGINE',
+                    agentAction: 'provide_input',
+                    retryable: false,
+                });
+            }
+            // Normalize order_name
+            let normalizedOrderName = rawOrderName.trim();
+            if (!normalizedOrderName.startsWith('#')) {
+                normalizedOrderName = '#' + normalizedOrderName;
+            }
+            if (!/^#.+$/.test(normalizedOrderName)) {
+                throw new WorkflowError('ShopifyAdapter: order_name is invalid after normalization', {
+                    code: 'ADAPTER_VALIDATION_FAILED',
+                    category: 'ENGINE',
+                    agentAction: 'provide_input',
+                    retryable: false,
+                });
+            }
+            const base = this.baseUrlOverride ?? `https://${storeConfig.shop_domain}`;
+            const url = `${base}/admin/api/${this.apiVersion}/graphql.json`;
+            const requestOptions = {
+                method: 'POST',
+                headers: {
+                    'X-Shopify-Access-Token': storeConfig.access_token,
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                body: JSON.stringify({
+                    query: ORDERS_BY_NAME_QUERY,
+                    variables: { query: `name:${normalizedOrderName}` },
+                }),
+            };
+            const response = await this.executeRequest(url, requestOptions, signal);
+            if (!response.ok) {
+                await this.throwHttpError(response, 'get_order');
+            }
+            // Parse JSON response
+            let gqlBody;
+            try {
+                gqlBody = await response.json();
+            }
+            catch {
+                throw new WorkflowError('ShopifyAdapter: failed to parse GraphQL response', {
+                    code: 'SERVICE_RESPONSE_INVALID',
+                    category: 'SERVICE',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            const body = gqlBody;
+            // Check for GraphQL errors
+            if (Array.isArray(body['errors']) && body['errors'].length > 0) {
+                const errors = body['errors'];
+                const firstError = errors[0];
+                const extensions = firstError?.['extensions'];
+                if (extensions?.['code'] === 'THROTTLED') {
+                    throw new WorkflowError('Shopify GraphQL rate limited', {
+                        code: 'SERVICE_RATE_LIMITED',
+                        category: 'SERVICE',
+                        agentAction: 'wait_and_proceed',
+                        retryable: true,
+                        retry_after: 2,
+                    });
+                }
+                throw new WorkflowError('ShopifyAdapter: GraphQL errors in response', {
+                    code: 'SERVICE_RESPONSE_INVALID',
+                    category: 'SERVICE',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                    details: { errors: body['errors'] },
+                });
+            }
+            // Validate edges shape
+            const data = body['data'];
+            const orders = data?.['orders'];
+            const edges = orders?.['edges'];
+            if (!Array.isArray(edges)) {
+                throw new WorkflowError('ShopifyAdapter: unexpected response shape — edges not an array', {
+                    code: 'SERVICE_RESPONSE_INVALID',
+                    category: 'SERVICE',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            if (edges.length === 0) {
+                throw new WorkflowError('ShopifyAdapter: order not found', {
+                    code: 'SERVICE_NOT_FOUND',
+                    category: 'SERVICE',
+                    agentAction: 'provide_input',
+                    retryable: false,
+                    details: { store, order_name: normalizedOrderName },
+                });
+            }
+            if (edges.length > 1) {
+                throw new WorkflowError('ShopifyAdapter: unexpected multiple edges for first:1 query', {
+                    code: 'SERVICE_RESPONSE_INVALID',
+                    category: 'SERVICE',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            const edge = edges[0];
+            const normalizedOrder = this.normalizeOrder(edge.node, store, normalizedOrderName);
+            return { status: 200, data: normalizedOrder };
+        }
+        throw new WorkflowError(`ShopifyAdapter: unsupported fetch operation '${operation}'`, {
+            code: 'ADAPTER_OP_UNSUPPORTED',
+            category: 'ENGINE',
+            agentAction: 'report_to_user',
+            retryable: false,
+            details: { operation },
+        });
+    }
+    async create(operation, _params, _config, _signal) {
+        throw new WorkflowError(`ShopifyAdapter: unsupported create operation: ${operation}`, {
+            code: 'ADAPTER_OP_UNSUPPORTED',
+            category: 'ENGINE',
+            agentAction: 'report_to_user',
+            retryable: false,
+            details: { operation },
+        });
+    }
+    async update(operation, _params, _config, _signal) {
+        throw new WorkflowError(`ShopifyAdapter: unsupported update operation: ${operation}`, {
+            code: 'ADAPTER_OP_UNSUPPORTED',
+            category: 'ENGINE',
+            agentAction: 'report_to_user',
+            retryable: false,
+            details: { operation },
+        });
+    }
+}
+//# sourceMappingURL=shopify-adapter.js.map

package/dist/adapters/shopify-adapter.js.map

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

package/dist/adapters/slack-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { ServiceAdapter, ServiceResponse } from '../extensions/service-adapter.js';
+export interface SlackAdapterConfig {
+    webhook_url: string;
+}
+/**
+ * SlackAdapter posts messages to a Slack channel via Incoming Webhooks.
+ * Only the `create` method is supported; `fetch` and `update` throw WorkflowError.
+ * Supported operations: 'post_message' — POSTs { text, blocks? } to the webhook URL.
+ */
+export declare class SlackAdapter implements ServiceAdapter {
+    readonly id: string;
+    private readonly config;
+    constructor(id: string, config: SlackAdapterConfig);
+    fetch(_operation: string, _params: Record<string, unknown>, _config: Record<string, unknown>, _signal?: AbortSignal): Promise<ServiceResponse>;
+    create(operation: string, params: Record<string, unknown>, _config: Record<string, unknown>, signal?: AbortSignal): Promise<ServiceResponse>;
+    update(_operation: string, _params: Record<string, unknown>, _config: Record<string, unknown>, _signal?: AbortSignal): Promise<ServiceResponse>;
+}
+//# sourceMappingURL=slack-adapter.d.ts.map

package/dist/adapters/slack-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/slack-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExF,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,cAAc;aAE/B,EAAE,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADP,EAAE,EAAE,MAAM,EACT,MAAM,EAAE,kBAAkB;IAGvC,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;IASrB,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC;IAsDrB,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;CAQ5B"}

package/dist/adapters/slack-adapter.js

@@ -0,0 +1,81 @@
+// SlackAdapter — posts messages to a Slack channel via Incoming Webhooks.
+import { WorkflowError } from '../types/workflow-error.js';
+/**
+ * SlackAdapter posts messages to a Slack channel via Incoming Webhooks.
+ * Only the `create` method is supported; `fetch` and `update` throw WorkflowError.
+ * Supported operations: 'post_message' — POSTs { text, blocks? } to the webhook URL.
+ */
+export class SlackAdapter {
+    id;
+    config;
+    constructor(id, config) {
+        this.id = id;
+        this.config = config;
+    }
+    async fetch(_operation, _params, _config, _signal) {
+        throw new WorkflowError('SlackAdapter does not support fetch', {
+            code: 'ADAPTER_OP_UNSUPPORTED',
+            category: 'ENGINE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    async create(operation, params, _config, signal) {
+        if (operation !== 'post_message') {
+            throw new WorkflowError(`SlackAdapter: unsupported operation: ${operation}`, {
+                code: 'ADAPTER_OP_UNSUPPORTED',
+                category: 'ENGINE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        if (typeof params['text'] !== 'string') {
+            throw new WorkflowError('SlackAdapter: text is required for post_message', {
+                code: 'ADAPTER_VALIDATION_FAILED',
+                category: 'ENGINE',
+                agentAction: 'provide_input',
+                retryable: false,
+            });
+        }
+        const body = { text: params['text'] };
+        if (params['blocks'] !== undefined) {
+            body['blocks'] = params['blocks'];
+        }
+        let response;
+        try {
+            response = await fetch(this.config.webhook_url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+                signal: signal ?? null,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new WorkflowError(`Slack webhook request failed: ${message}`, {
+                code: 'ADAPTER_REQUEST_FAILED',
+                category: 'ENGINE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        if (response.status !== 200) {
+            throw new WorkflowError(`Slack webhook returned HTTP ${response.status}`, {
+                code: 'ADAPTER_REQUEST_FAILED',
+                category: 'ENGINE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        return { status: response.status, data: { ok: true } };
+    }
+    async update(_operation, _params, _config, _signal) {
+        throw new WorkflowError('SlackAdapter does not support update', {
+            code: 'ADAPTER_OP_UNSUPPORTED',
+            category: 'ENGINE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+}
+//# sourceMappingURL=slack-adapter.js.map

package/dist/adapters/slack-adapter.js.map

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

package/dist/adapters/token-bucket.d.ts

@@ -0,0 +1,27 @@
+import type { RateLimiter } from './rate-limiter.js';
+/**
+ * Token-bucket rate limiter.
+ *
+ * Starts full (burst tokens). Refills at one token per intervalMs.
+ * `pause()` stops refill and drains tokens; on resume, exactly 1 token is
+ * issued immediately and the refill timer restarts.
+ */
+export declare class TokenBucketRateLimiter implements RateLimiter {
+    private tokens;
+    private readonly capacity;
+    private readonly intervalMs;
+    private refillTimer;
+    private resumeTimer;
+    private resumeAt;
+    private readonly waiters;
+    private readonly now;
+    constructor(config: {
+        requests_per_second: number;
+        burst: number;
+    }, now?: () => number);
+    acquire(signal?: AbortSignal): Promise<void>;
+    pause(seconds: number): void;
+    private startRefill;
+    private serveOneWaiter;
+}
+//# sourceMappingURL=token-bucket.d.ts.map

package/dist/adapters/token-bucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.d.ts","sourceRoot":"","sources":["../../src/adapters/token-bucket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOrD;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,MAAM,EAAE;QAAE,mBAAmB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,CAAC,EAAE,MAAM,MAAM;IAQtF,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C5C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAuB5B,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,cAAc;CAMvB"}