services-as-software 0.1.0 → 2.0.1

package/dist/client.js.map

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

package/dist/endpoint.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Endpoint helper for defining service endpoints
+ */
+import type { EndpointDefinition, PricingConfig, JSONSchema } from './types.js';
+/**
+ * Endpoint configuration (input to Endpoint function)
+ */
+export interface EndpointConfig<TInput = unknown, TOutput = unknown> {
+    /** Endpoint name */
+    name: string;
+    /** Description of what this endpoint does */
+    description?: string;
+    /** HTTP method (for REST endpoints) */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Path pattern (e.g., '/users/:id') */
+    path?: string;
+    /** Input schema */
+    input?: JSONSchema;
+    /** Output schema */
+    output?: JSONSchema;
+    /** Handler function */
+    handler: EndpointDefinition<TInput, TOutput>['handler'];
+    /** Pricing specific to this endpoint */
+    pricing?: PricingConfig;
+    /** Rate limiting */
+    rateLimit?: {
+        requests: number;
+        window: number;
+    };
+    /** Whether authentication is required */
+    requiresAuth?: boolean;
+}
+/**
+ * Create an endpoint definition
+ *
+ * @example
+ * ```ts
+ * const translateEndpoint = Endpoint({
+ *   name: 'translate',
+ *   description: 'Translate text between languages',
+ *   method: 'POST',
+ *   path: '/translate',
+ *   input: {
+ *     type: 'object',
+ *     properties: {
+ *       text: { type: 'string', description: 'Text to translate' },
+ *       from: { type: 'string', description: 'Source language code' },
+ *       to: { type: 'string', description: 'Target language code' },
+ *     },
+ *     required: ['text', 'to'],
+ *     additionalProperties: false,
+ *   },
+ *   output: {
+ *     type: 'object',
+ *     properties: {
+ *       translatedText: { type: 'string' },
+ *       confidence: { type: 'number' },
+ *     },
+ *     required: ['translatedText'],
+ *     additionalProperties: false,
+ *   },
+ *   handler: async (input, context) => {
+ *     // Translation logic here
+ *     return {
+ *       translatedText: `Translated: ${input.text}`,
+ *       confidence: 0.95,
+ *     }
+ *   },
+ *   pricing: {
+ *     model: 'per-use',
+ *     pricePerUnit: 0.01,
+ *     currency: 'USD',
+ *   },
+ *   rateLimit: {
+ *     requests: 100,
+ *     window: 60000, // 1 minute
+ *   },
+ * })
+ * ```
+ */
+export declare function Endpoint<TInput = unknown, TOutput = unknown>(config: EndpointConfig<TInput, TOutput>): EndpointDefinition<TInput, TOutput>;
+/**
+ * Create a GET endpoint
+ */
+export declare function GET<TInput = unknown, TOutput = unknown>(config: Omit<EndpointConfig<TInput, TOutput>, 'method'>): EndpointDefinition<TInput, TOutput>;
+/**
+ * Create a POST endpoint
+ */
+export declare function POST<TInput = unknown, TOutput = unknown>(config: Omit<EndpointConfig<TInput, TOutput>, 'method'>): EndpointDefinition<TInput, TOutput>;
+/**
+ * Create a PUT endpoint
+ */
+export declare function PUT<TInput = unknown, TOutput = unknown>(config: Omit<EndpointConfig<TInput, TOutput>, 'method'>): EndpointDefinition<TInput, TOutput>;
+/**
+ * Create a DELETE endpoint
+ */
+export declare function DELETE<TInput = unknown, TOutput = unknown>(config: Omit<EndpointConfig<TInput, TOutput>, 'method'>): EndpointDefinition<TInput, TOutput>;
+/**
+ * Create a PATCH endpoint
+ */
+export declare function PATCH<TInput = unknown, TOutput = unknown>(config: Omit<EndpointConfig<TInput, TOutput>, 'method'>): EndpointDefinition<TInput, TOutput>;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE/E;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpD,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mBAAmB;IACnB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,oBAAoB;IACpB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,uBAAuB;IACvB,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAA;IACvD,wCAAwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,oBAAoB;IACpB,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1D,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAarC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACrD,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACtD,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACrD,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACxD,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACvD,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC"}

package/dist/endpoint.js

@@ -0,0 +1,96 @@
+/**
+ * Endpoint helper for defining service endpoints
+ */
+/**
+ * Create an endpoint definition
+ *
+ * @example
+ * ```ts
+ * const translateEndpoint = Endpoint({
+ *   name: 'translate',
+ *   description: 'Translate text between languages',
+ *   method: 'POST',
+ *   path: '/translate',
+ *   input: {
+ *     type: 'object',
+ *     properties: {
+ *       text: { type: 'string', description: 'Text to translate' },
+ *       from: { type: 'string', description: 'Source language code' },
+ *       to: { type: 'string', description: 'Target language code' },
+ *     },
+ *     required: ['text', 'to'],
+ *     additionalProperties: false,
+ *   },
+ *   output: {
+ *     type: 'object',
+ *     properties: {
+ *       translatedText: { type: 'string' },
+ *       confidence: { type: 'number' },
+ *     },
+ *     required: ['translatedText'],
+ *     additionalProperties: false,
+ *   },
+ *   handler: async (input, context) => {
+ *     // Translation logic here
+ *     return {
+ *       translatedText: `Translated: ${input.text}`,
+ *       confidence: 0.95,
+ *     }
+ *   },
+ *   pricing: {
+ *     model: 'per-use',
+ *     pricePerUnit: 0.01,
+ *     currency: 'USD',
+ *   },
+ *   rateLimit: {
+ *     requests: 100,
+ *     window: 60000, // 1 minute
+ *   },
+ * })
+ * ```
+ */
+export function Endpoint(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        method: config.method || 'POST',
+        path: config.path || `/${config.name}`,
+        input: config.input,
+        output: config.output,
+        handler: config.handler,
+        pricing: config.pricing,
+        rateLimit: config.rateLimit,
+        requiresAuth: config.requiresAuth !== false, // Default to true
+    };
+}
+/**
+ * Create a GET endpoint
+ */
+export function GET(config) {
+    return Endpoint({ ...config, method: 'GET' });
+}
+/**
+ * Create a POST endpoint
+ */
+export function POST(config) {
+    return Endpoint({ ...config, method: 'POST' });
+}
+/**
+ * Create a PUT endpoint
+ */
+export function PUT(config) {
+    return Endpoint({ ...config, method: 'PUT' });
+}
+/**
+ * Create a DELETE endpoint
+ */
+export function DELETE(config) {
+    return Endpoint({ ...config, method: 'DELETE' });
+}
+/**
+ * Create a PATCH endpoint
+ */
+export function PATCH(config) {
+    return Endpoint({ ...config, method: 'PATCH' });
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiCH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAuC;IAEvC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;QACtC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY,KAAK,KAAK,EAAE,kBAAkB;KAChE,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CACjB,MAAuD;IAEvD,OAAO,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,MAAuD;IAEvD,OAAO,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CACjB,MAAuD;IAEvD,OAAO,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CACpB,MAAuD;IAEvD,OAAO,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,MAAuD;IAEvD,OAAO,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;AACjD,CAAC"}

package/dist/entities/billing.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Billing Entity Types (Nouns)
+ *
+ * Billing & commerce: ServiceQuote, ServiceOrder, ServiceSubscription, Usage, Invoice, Payment
+ *
+ * @packageDocumentation
+ */
+import type { Noun } from 'ai-database';
+/**
+ * ServiceQuote entity
+ *
+ * Price quote for a service.
+ */
+export declare const ServiceQuote: Noun;
+/**
+ * ServiceOrder entity
+ *
+ * Customer order for a service.
+ */
+export declare const ServiceOrder: Noun;
+/**
+ * ServiceSubscription entity
+ *
+ * Recurring service subscription.
+ */
+export declare const ServiceSubscription: Noun;
+/**
+ * Usage entity
+ *
+ * Service usage tracking record.
+ */
+export declare const Usage: Noun;
+/**
+ * Invoice entity
+ *
+ * Billing invoice.
+ */
+export declare const Invoice: Noun;
+/**
+ * Payment entity
+ *
+ * Payment record.
+ */
+export declare const Payment: Noun;
+export declare const BillingEntities: {
+    ServiceQuote: Noun;
+    ServiceOrder: Noun;
+    ServiceSubscription: Noun;
+    Usage: Noun;
+    Invoice: Noun;
+    Payment: Noun;
+};
+export declare const BillingCategories: {
+    readonly quotes: readonly ["ServiceQuote"];
+    readonly orders: readonly ["ServiceOrder"];
+    readonly subscriptions: readonly ["ServiceSubscription"];
+    readonly usage: readonly ["Usage"];
+    readonly invoicing: readonly ["Invoice", "Payment"];
+};
+//# sourceMappingURL=billing.d.ts.map

package/dist/entities/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/entities/billing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAMvC;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,IA+J1B,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,IAmL1B,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAoKjC,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,IAqInB,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,IAiKrB,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,IAiJrB,CAAA;AAMD,eAAO,MAAM,eAAe;;;;;;;CAO3B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAA"}