services-as-software 0.1.0 → 2.0.1

package/dist/index.js

@@ -1,172 +1,18 @@
-// src/pricing/index.ts
-function calculateCostBasedPrice(pricing, quantity = 1) {
-  const { costBase, fixedCosts = 0, variableCosts = 0 } = pricing;
-  return costBase + fixedCosts + variableCosts * quantity;
-}
-function calculateMarginBasedPrice(pricing, quantity = 1) {
-  const { costBase, marginPercentage } = pricing;
-  const cost = costBase * quantity;
-  const margin = cost * (marginPercentage / 100);
-  return cost + margin;
-}
-function calculateActivityBasedPrice(pricing, activities) {
-  return pricing.activities.reduce((total, activity) => {
-    const quantity = activities[activity.name] || 0;
-    return total + activity.rate * quantity;
-  }, 0);
-}
-function calculateOutcomeBasedPrice(pricing, outcomes) {
-  return pricing.outcomes.reduce((total, outcome) => {
-    const achievedValue = outcomes[outcome.metric] || 0;
-    if (achievedValue >= outcome.targetValue) {
-      return total + outcome.price;
-    }
-    return total;
-  }, 0);
-}
-function calculatePrice(pricing, params = {}) {
-  const { quantity = 1, activities = {}, outcomes = {} } = params;
-  switch (pricing.model) {
-    case "cost-based":
-      return calculateCostBasedPrice(pricing, quantity);
-    case "margin-based":
-      return calculateMarginBasedPrice(pricing, quantity);
-    case "activity-based":
-      return calculateActivityBasedPrice(pricing, activities);
-    case "outcome-based":
-      return calculateOutcomeBasedPrice(pricing, outcomes);
-    default:
-      throw new Error(`Unsupported pricing model: ${pricing.model}`);
-  }
-}
-
-// src/index.ts
-function Service(definition) {
-  validateServiceDefinition(definition);
-  const service = {
-    ...definition,
-    /**
-     * Calculate the price for this service
-     * @param params Parameters for price calculation
-     * @returns Calculated price
-     */
-    calculatePrice(params) {
-      return calculatePrice(definition.pricing, params);
-    },
-    /**
-     * Register the service with the service registry
-     * @param options Optional configuration for service registration
-     * @returns Promise resolving to the registered service
-     */
-    async register(options) {
-      try {
-        const { Services } = await import("services.do");
-        const services = new Services(options);
-        const serviceDefinition = {
-          name: definition.name,
-          description: definition.description,
-          endpoint: `https://api.services.do/implementations/${definition.implementation.type}/${definition.implementation.id}`,
-          version: definition.implementation.version,
-          metadata: {
-            ...definition.metadata,
-            objective: definition.objective,
-            keyResults: definition.keyResults,
-            pricing: definition.pricing,
-            implementation: definition.implementation
-          }
-        };
-        const registeredService = await services.register(serviceDefinition);
-        return {
-          ...definition,
-          id: registeredService.id,
-          status: registeredService.status,
-          endpoint: registeredService.endpoint,
-          createdAt: registeredService.createdAt,
-          updatedAt: registeredService.updatedAt
-        };
-      } catch (error) {
-        console.warn("Failed to register with services.do, using mock implementation", error);
-        return {
-          ...definition,
-          id: generateId(),
-          status: "active",
-          endpoint: `https://api.services.do/services/${generateId()}`,
-          createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-        };
-      }
-    },
-    /**
-     * Track progress towards key results
-     * @param results Record of key result updates
-     */
-    trackProgress(results) {
-      definition.keyResults.forEach((kr) => {
-        if (kr.description in results) {
-          kr.currentValue = results[kr.description];
-        }
-      });
-    },
-    /**
-     * Check if all key results have been achieved
-     * @returns Whether all key results have been achieved
-     */
-    isObjectiveAchieved() {
-      return definition.keyResults.every((kr) => kr.currentValue !== void 0 && kr.target !== void 0 && kr.currentValue >= kr.target);
-    }
-  };
-  return service;
-}
-function validateServiceDefinition(definition) {
-  const { name, objective, keyResults, pricing, implementation } = definition;
-  if (!name) {
-    throw new Error("Service name is required");
-  }
-  if (!objective || !objective.description) {
-    throw new Error("Service objective with description is required");
-  }
-  if (!keyResults || !Array.isArray(keyResults) || keyResults.length === 0) {
-    throw new Error("At least one key result is required");
-  }
-  if (!pricing || !pricing.model) {
-    throw new Error("Service pricing model is required");
-  }
-  if (!implementation || !implementation.type || !implementation.id) {
-    throw new Error("Service implementation details are required");
-  }
-  switch (pricing.model) {
-    case "cost-based":
-      if (pricing.costBase === void 0) {
-        throw new Error("Cost base is required for cost-based pricing");
-      }
-      break;
-    case "margin-based":
-      if (pricing.costBase === void 0 || pricing.marginPercentage === void 0) {
-        throw new Error("Cost base and margin percentage are required for margin-based pricing");
-      }
-      break;
-    case "activity-based":
-      if (!pricing.activities || !Array.isArray(pricing.activities) || pricing.activities.length === 0) {
-        throw new Error("At least one activity is required for activity-based pricing");
-      }
-      break;
-    case "outcome-based":
-      if (!pricing.outcomes || !Array.isArray(pricing.outcomes) || pricing.outcomes.length === 0) {
-        throw new Error("At least one outcome is required for outcome-based pricing");
-      }
-      break;
-    default:
-      throw new Error(`Unsupported pricing model: ${pricing.model}`);
-  }
-}
-function generateId() {
-  return Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
-}
-export {
-  Service,
-  calculateActivityBasedPrice,
-  calculateCostBasedPrice,
-  calculateMarginBasedPrice,
-  calculateOutcomeBasedPrice,
-  calculatePrice
-};
+/**
+ * services-as-software - Primitives for building AI-powered services that operate as software
+ *
+ * Services are a superset of digital-workers with a payment/business overlay,
+ * capable of crossing company/business boundaries.
+ *
+ * @packageDocumentation
+ */
+// Export entity definitions (Nouns)
+export * from './entities/index.js';
+// Core service primitives
+export { Service } from './service.js';
+export { Endpoint, GET, POST, PUT, DELETE, PATCH } from './endpoint.js';
+export { Client } from './client.js';
+export { Provider, providers } from './provider.js';
+// Helper functions for common operations
+export { ask, deliver, do_ as do, generate, is, notify, on, order, queue, quote, subscribe, every, entitlements, kpis, okrs, Plan, KPI, OKR, Entitlement, } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oCAAoC;AACpC,cAAc,qBAAqB,CAAA;AAEnC,0BAA0B;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEnD,yCAAyC;AACzC,OAAO,EACL,GAAG,EACH,OAAO,EACP,GAAG,IAAI,EAAE,EACT,QAAQ,EACR,EAAE,EACF,MAAM,EACN,EAAE,EACF,KAAK,EACL,KAAK,EACL,KAAK,EACL,SAAS,EACT,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,GAAG,EACH,WAAW,GACZ,MAAM,cAAc,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Service provider for managing multiple services
+ */
+import type { Provider, ClientConfig } from './types.js';
+/**
+ * Provider configuration
+ */
+export interface ProviderConfig {
+    /** Provider name */
+    name: string;
+    /** Base URL for all services */
+    baseUrl: string;
+    /** Authentication configuration */
+    auth?: ClientConfig['auth'];
+    /** Available services */
+    services?: string[];
+}
+/**
+ * Create a service provider
+ *
+ * @example
+ * ```ts
+ * const provider = Provider({
+ *   name: 'AWS',
+ *   baseUrl: 'https://api.aws.amazon.com',
+ *   auth: {
+ *     type: 'api-key',
+ *     credentials: { apiKey: process.env.AWS_API_KEY },
+ *   },
+ *   services: ['translate', 'comprehend', 'polly'],
+ * })
+ *
+ * // Get a service client
+ * const translate = provider.service('translate')
+ * const result = await translate.do('translate', {
+ *   text: 'Hello',
+ *   to: 'es',
+ * })
+ * ```
+ */
+export declare function Provider(config: ProviderConfig): Provider;
+/**
+ * Common cloud providers
+ */
+export declare const providers: {
+    /**
+     * AWS provider
+     */
+    aws(credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+        region?: string;
+    }): Provider;
+    /**
+     * Google Cloud provider
+     */
+    gcp(credentials: {
+        apiKey: string;
+        projectId?: string;
+    }): Provider;
+    /**
+     * Azure provider
+     */
+    azure(credentials: {
+        subscriptionKey: string;
+        region?: string;
+    }): Provider;
+    /**
+     * OpenAI provider
+     */
+    openai(credentials: {
+        apiKey: string;
+    }): Provider;
+    /**
+     * Anthropic provider
+     */
+    anthropic(credentials: {
+        apiKey: string;
+    }): Provider;
+    /**
+     * Custom provider
+     */
+    custom(config: ProviderConfig): Provider;
+};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAA;AAGvE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,mCAAmC;IACnC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAoBzD;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;qBACc;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAsB7F;;OAEG;qBACc;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAkBlE;;OAEG;uBACgB;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAkB1E;;OAEG;wBACiB;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAkBjD;;OAEG;2BACoB;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAepD;;OAEG;mBACY,cAAc,GAAG,QAAQ;CAGzC,CAAA"}

package/dist/provider.js

@@ -0,0 +1,158 @@
+/**
+ * Service provider for managing multiple services
+ */
+import { Client } from './client.js';
+/**
+ * Create a service provider
+ *
+ * @example
+ * ```ts
+ * const provider = Provider({
+ *   name: 'AWS',
+ *   baseUrl: 'https://api.aws.amazon.com',
+ *   auth: {
+ *     type: 'api-key',
+ *     credentials: { apiKey: process.env.AWS_API_KEY },
+ *   },
+ *   services: ['translate', 'comprehend', 'polly'],
+ * })
+ *
+ * // Get a service client
+ * const translate = provider.service('translate')
+ * const result = await translate.do('translate', {
+ *   text: 'Hello',
+ *   to: 'es',
+ * })
+ * ```
+ */
+export function Provider(config) {
+    return {
+        name: config.name,
+        baseUrl: config.baseUrl,
+        auth: config.auth,
+        services: config.services || [],
+        service(serviceName) {
+            // Construct service URL
+            const serviceUrl = `${config.baseUrl}/${serviceName}`;
+            // Create a client for this service
+            const client = Client({
+                url: serviceUrl,
+                auth: config.auth,
+            });
+            return client;
+        },
+    };
+}
+/**
+ * Common cloud providers
+ */
+export const providers = {
+    /**
+     * AWS provider
+     */
+    aws(credentials) {
+        return Provider({
+            name: 'AWS',
+            baseUrl: `https://api.${credentials.region || 'us-east-1'}.amazonaws.com`,
+            auth: {
+                type: 'api-key',
+                credentials: {
+                    apiKey: credentials.accessKeyId,
+                    secret: credentials.secretAccessKey,
+                },
+            },
+            services: [
+                'translate',
+                'comprehend',
+                'polly',
+                'rekognition',
+                'textract',
+                'transcribe',
+            ],
+        });
+    },
+    /**
+     * Google Cloud provider
+     */
+    gcp(credentials) {
+        return Provider({
+            name: 'Google Cloud',
+            baseUrl: 'https://api.googleapis.com',
+            auth: {
+                type: 'api-key',
+                credentials: { apiKey: credentials.apiKey },
+            },
+            services: [
+                'translate',
+                'language',
+                'speech',
+                'texttospeech',
+                'vision',
+            ],
+        });
+    },
+    /**
+     * Azure provider
+     */
+    azure(credentials) {
+        return Provider({
+            name: 'Azure',
+            baseUrl: `https://${credentials.region || 'eastus'}.api.cognitive.microsoft.com`,
+            auth: {
+                type: 'api-key',
+                credentials: { apiKey: credentials.subscriptionKey },
+            },
+            services: [
+                'translator',
+                'language',
+                'speech',
+                'vision',
+                'form-recognizer',
+            ],
+        });
+    },
+    /**
+     * OpenAI provider
+     */
+    openai(credentials) {
+        return Provider({
+            name: 'OpenAI',
+            baseUrl: 'https://api.openai.com/v1',
+            auth: {
+                type: 'api-key',
+                credentials: { apiKey: credentials.apiKey },
+            },
+            services: [
+                'chat',
+                'completions',
+                'embeddings',
+                'images',
+                'audio',
+            ],
+        });
+    },
+    /**
+     * Anthropic provider
+     */
+    anthropic(credentials) {
+        return Provider({
+            name: 'Anthropic',
+            baseUrl: 'https://api.anthropic.com/v1',
+            auth: {
+                type: 'api-key',
+                credentials: { apiKey: credentials.apiKey },
+            },
+            services: [
+                'messages',
+                'completions',
+            ],
+        });
+    },
+    /**
+     * Custom provider
+     */
+    custom(config) {
+        return Provider(config);
+    },
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAgBpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAsB;IAC7C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAE/B,OAAO,CAA0B,WAAmB;YAClD,wBAAwB;YACxB,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,WAAW,EAAE,CAAA;YAErD,mCAAmC;YACnC,MAAM,MAAM,GAAG,MAAM,CAAC;gBACpB,GAAG,EAAE,UAAU;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAA;YAEF,OAAO,MAAW,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,GAAG,CAAC,WAA8E;QAChF,OAAO,QAAQ,CAAC;YACd,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,eAAe,WAAW,CAAC,MAAM,IAAI,WAAW,gBAAgB;YACzE,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE;oBACX,MAAM,EAAE,WAAW,CAAC,WAAW;oBAC/B,MAAM,EAAE,WAAW,CAAC,eAAe;iBACpC;aACF;YACD,QAAQ,EAAE;gBACR,WAAW;gBACX,YAAY;gBACZ,OAAO;gBACP,aAAa;gBACb,UAAU;gBACV,YAAY;aACb;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,WAAmD;QACrD,OAAO,QAAQ,CAAC;YACd,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,4BAA4B;YACrC,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;aAC5C;YACD,QAAQ,EAAE;gBACR,WAAW;gBACX,UAAU;gBACV,QAAQ;gBACR,cAAc;gBACd,QAAQ;aACT;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAyD;QAC7D,OAAO,QAAQ,CAAC;YACd,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW,WAAW,CAAC,MAAM,IAAI,QAAQ,8BAA8B;YAChF,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,eAAe,EAAE;aACrD;YACD,QAAQ,EAAE;gBACR,YAAY;gBACZ,UAAU;gBACV,QAAQ;gBACR,QAAQ;gBACR,iBAAiB;aAClB;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAA+B;QACpC,OAAO,QAAQ,CAAC;YACd,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,2BAA2B;YACpC,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;aAC5C;YACD,QAAQ,EAAE;gBACR,MAAM;gBACN,aAAa;gBACb,YAAY;gBACZ,QAAQ;gBACR,OAAO;aACR;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,WAA+B;QACvC,OAAO,QAAQ,CAAC;YACd,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,8BAA8B;YACvC,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;aAC5C;YACD,QAAQ,EAAE;gBACR,UAAU;gBACV,aAAa;aACd;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAsB;QAC3B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;CACF,CAAA"}

package/dist/service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Service implementation
+ */
+import type { ServiceDefinition, Service } from './types.js';
+/**
+ * Create a service from a definition
+ *
+ * @example
+ * ```ts
+ * const service = Service({
+ *   name: 'translation-service',
+ *   version: '1.0.0',
+ *   description: 'AI-powered translation service',
+ *   pricing: {
+ *     model: 'per-use',
+ *     pricePerUnit: 0.01,
+ *     currency: 'USD',
+ *   },
+ *   endpoints: [
+ *     Endpoint({
+ *       name: 'translate',
+ *       method: 'POST',
+ *       path: '/translate',
+ *       input: {
+ *         type: 'object',
+ *         properties: {
+ *           text: { type: 'string' },
+ *           from: { type: 'string' },
+ *           to: { type: 'string' },
+ *         },
+ *         required: ['text', 'to'],
+ *       },
+ *       handler: async (input) => {
+ *         // Translation logic here
+ *         return { translatedText: input.text }
+ *       },
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export declare function Service(definition: ServiceDefinition): Service;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,OAAO,EAWR,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CA0M9D"}