@cloudnux/core-cloud-provider 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,384 @@
+type HandlerType = "Http" | "Schedule" | "Event";
+type BaseEntry<TTrigger> = {
+    handler: string;
+    trigger: TTrigger;
+};
+
+type HttpMethod = "GET" | "PUT" | "POST" | "PATCH" | "DELETE";
+type HttpTrigger = {
+    type: "http";
+    options: {
+        route: string;
+        method: HttpMethod;
+    };
+};
+type HttpEntry = BaseEntry<HttpTrigger>;
+
+type ScheduleTrigger = {
+    type: "schedule";
+    options: {
+        name: string;
+        pattern: string;
+    };
+};
+type ScheduleEntry = BaseEntry<ScheduleTrigger>;
+
+interface ComparisonOperators {
+    $eq?: any;
+    $ne?: any;
+    $gt?: number | string | Date;
+    $gte?: number | string | Date;
+    $lt?: number | string | Date;
+    $lte?: number | string | Date;
+}
+interface ArrayOperators {
+    $in?: any[];
+    $nin?: any[];
+    $all?: any[];
+    $size?: number;
+}
+interface StringOperators {
+    $regex?: string;
+    $startsWith?: string;
+    $endsWith?: string;
+    $contains?: string;
+}
+interface ExistenceOperators {
+    $exists?: boolean;
+    $type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'undefined';
+}
+interface LogicalOperatorAnd {
+    $and: FilterCondition[];
+}
+interface LogicalOperatorOr {
+    $or: FilterCondition[];
+}
+type LogicalOperators = LogicalOperatorAnd | LogicalOperatorOr;
+type FilterCondition = ComparisonOperators | ArrayOperators | StringOperators | ExistenceOperators | LogicalOperators;
+type FilterPropertyValue = any | FilterCondition;
+type MessageFilter = {
+    [propertyPath: string]: FilterPropertyValue;
+};
+type EventTrigger = {
+    type: "event";
+    options: {
+        source: string;
+        sourceType: string;
+        filter?: MessageFilter;
+    };
+};
+type EventEntry = BaseEntry<EventTrigger>;
+
+type Entry = HttpEntry | ScheduleEntry | EventEntry;
+type Entrypoint = {
+    entries: Record<string, Entry>;
+};
+
+interface EventBrokerService {
+    /**
+     * Publish a message to a topic/queue
+     * @param target Target topic/queue name
+     * @param message Message to publish
+     * @param options Optional publishing options
+     * @returns Promise resolving when publishing is complete
+     */
+    publish(target: string, message: string | Record<string, any>, options?: PublishOptions): Promise<void>;
+    /**
+     * Read a message without removing it from the queue
+     * @param source Source queue name
+     * @param options Optional reading options
+     * @returns Promise containing the peeked message(s)
+     */
+    peek(source: string, options?: PeekOptions): Promise<EventMessage[]>;
+    /**
+     * Read and remove message(s) from the queue
+     * @param source Source queue name
+     * @param options Optional reading options
+     * @returns Promise containing the read message(s)
+     */
+    read(source: string, options?: ReadOptions): Promise<EventMessage[]>;
+}
+interface PublishOptions {
+    /** Message attributes/headers */
+    attributes?: Record<string, string>;
+    /** Message group ID for FIFO queues */
+    messageGroupId?: string;
+    /** Message deduplication ID for FIFO queues */
+    messageDeduplicationId?: string;
+    /** Delay in seconds before the message becomes visible */
+    delaySeconds?: number;
+}
+interface PeekOptions {
+    /** Maximum number of messages to peek */
+    maxMessages?: number;
+    /** Wait time in seconds for long polling */
+    waitTimeSeconds?: number;
+}
+interface ReadOptions extends PeekOptions {
+    /** Visibility timeout in seconds */
+    visibilityTimeout?: number;
+}
+interface EventMessage {
+    /** Message ID */
+    id: string;
+    /** Message body */
+    body: string;
+    /** Message attributes/headers */
+    attributes?: Record<string, string>;
+    /** Message receipt handle (for operations like delete) */
+    receiptHandle?: string;
+    /** Message published timestamp */
+    publishedAt: Date;
+}
+
+interface LocationService {
+    /**
+     * Search for places based on a query
+     * @param query Search query
+     * @param options Search options like bounding box, filters, etc.
+     * @returns Promise containing search results
+     */
+    searchPlaces(query: string, options?: PlaceSearchOptions): Promise<PlaceSearchResult[]>;
+    /**
+     * Get detailed information about a specific place
+     * @param placeId ID of the place to get details for
+     * @returns Promise containing place details
+     */
+    getPlaceDetails(placeId: string): Promise<PlaceDetails>;
+}
+interface PlaceSearchOptions {
+    /** Bounding box to search within */
+    boundingBox?: {
+        minLongitude: number;
+        minLatitude: number;
+        maxLongitude: number;
+        maxLatitude: number;
+    };
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Filter results by category */
+    categories?: string[];
+    /** Language code for results */
+    language?: string;
+}
+interface PlaceSearchResult {
+    /** Unique identifier for the place */
+    placeId: string;
+    /** Place name */
+    text: string;
+}
+interface PlaceDetails extends PlaceSearchResult {
+    /** Place address */
+    address?: string;
+    /** Geographic coordinates */
+    coordinates: {
+        latitude: number;
+        longitude: number;
+    };
+    /** Distance from search center if applicable */
+    distance?: number;
+    /** Place categories/types */
+    categories?: string[];
+    /** Full formatted address */
+    formattedAddress: string;
+    /** Phone number */
+    phoneNumber?: string;
+    /** Website URL */
+    website?: string;
+    /** Opening hours */
+    openingHours?: {
+        periods: {
+            day: number;
+            open?: string;
+            close?: string;
+        }[];
+        weekdayText?: string[];
+    };
+    /** Reviews if available */
+    reviews?: {
+        rating: number;
+        text?: string;
+        time?: number;
+    }[];
+    /** Additional place data */
+    additionalData?: Record<string, any>;
+}
+
+interface StorageService {
+    /**
+     * Read data from storage
+     * @param path Path to the file/object
+     * @param bucket Bucket or container name
+     * @returns Promise containing the file data
+     */
+    read(path: string, bucket: string): Promise<Buffer>;
+    /**
+     * Write data to storage
+     * @param path Path where to store the file/object
+     * @param data Data to write
+     * @param bucket Bucket or container name
+     * @param options Optional configuration for the write operation
+     * @returns Promise resolving with the result including URL of the stored file
+     */
+    write(path: string, data: Buffer | string, bucket: string, options?: StorageWriteOptions): Promise<StorageWriteResult>;
+    /**
+     * Delete data from storage
+     * @param path Path to the file/object to delete
+     * @param bucket Bucket or container name
+     * @returns Promise resolving when delete is complete
+     */
+    delete(path: string, bucket: string): Promise<void>;
+}
+interface StorageWriteOptions {
+    /** Content type of the file */
+    contentType?: string;
+    /** Access control for the file (public, private, etc.) */
+    acl?: 'private' | 'public-read' | 'public-read-write';
+    /** Custom metadata to attach to the file */
+    metadata?: Record<string, string>;
+}
+interface StorageWriteResult {
+    /**
+     * URL to access the stored file
+     */
+    url: string;
+    /**
+     * Storage bucket or container name
+     */
+    bucket: string;
+    /**
+     * Storage key or path
+     */
+    key: string;
+}
+
+/**
+ * Represents the context object for a function handler.
+ */
+type FunctionContext = {
+    /**
+     * The underlying context handler type.
+     */
+    type: HandlerType;
+    /**
+     * Creates a success response. This should be called when the handler is done successfully.
+     * @param data - The response body.
+     */
+    success<T>(data: T): void;
+    /**
+     * Creates an error response. This should be called when the handler is done with an error.
+     * @param message - The response body.
+     *
+     */
+    error(message: string, code?: ErrorCode, details?: Record<string, any>, stack?: string): void;
+    notFound(resource: string, id?: string | number): void;
+};
+/**
+ * Error codes for API error responses
+ */
+declare enum ErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    INVALID_INPUT = "INVALID_INPUT",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    ACCESS_DENIED = "ACCESS_DENIED",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    RESOURCE_ALREADY_EXISTS = "RESOURCE_ALREADY_EXISTS",
+    RESOURCE_CONFLICT = "RESOURCE_CONFLICT",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    DATABASE_ERROR = "DATABASE_ERROR",
+    BUSINESS_RULE_VIOLATION = "BUSINESS_RULE_VIOLATION",
+    EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+type HTTPRequest = {
+    method: HttpMethod;
+    body?: string;
+    headers: Record<string, string | string[] | undefined>;
+    url: string;
+    params: Record<string, string | undefined>;
+    matchingKey?: string;
+    rawQueryString?: string;
+    requestId?: string;
+    host?: string;
+};
+type HTTPResponse = {
+    headers?: Record<string, string | string[] | undefined>;
+    body?: string;
+    status: number;
+};
+type HTTPAuth = {
+    token: string;
+    appId: string;
+    memberId: string;
+    customerId: string;
+    claims: Record<string, string>;
+    identity: "facebook" | "google" | "apple" | "password";
+};
+type HttpFunctionContext = FunctionContext & {
+    type: "Http";
+    request: HTTPRequest;
+    auth?: HTTPAuth;
+    response: HTTPResponse;
+    model<T = Record<string, any>>(): T;
+    params<T = Record<string, string>>(): T;
+    list<T>(items: T[], page: number, pageSize: number, totalItems: number): void;
+    created<T>(data: T): void;
+    deleted(id?: string | number): void;
+    validationError(details: Record<string, any>): void;
+    serverError(err: Error): void;
+    businessError(message: string, details?: Record<string, any>): void;
+    output(status: number, body?: string, headers?: Record<string, string | string[]>): void;
+};
+type ScheduleResponse = {
+    status: "success" | "error";
+    body?: string | Record<string, any>;
+};
+type ScheduleRequest = {
+    name: string;
+    requestId?: string;
+};
+type ScheduleFunctionContext = FunctionContext & {
+    response: ScheduleResponse;
+    request: ScheduleRequest;
+    type: "Schedule";
+};
+type EventRequest = {
+    body: string | Record<string, any>;
+    attributes: Record<string, string>;
+    requestId?: string;
+    timestamp: Date;
+    attempts?: number;
+};
+type EventResponse = {
+    status: "success" | "error";
+    code?: ErrorCode;
+    body?: Record<string, any>;
+    stack?: string;
+};
+type EventFunctionContext = FunctionContext & {
+    type: "Event";
+    timestamp: Date;
+    attempts?: number;
+    response: EventResponse;
+    message<T = Record<string, any>>(): T;
+    attributes<T = Record<string, any>>(): T;
+};
+interface FunctionsService {
+    createHttRequest(...args: any[]): [HTTPRequest, HTTPAuth?];
+    createScheduleRequest(...args: any[]): [ScheduleRequest];
+    createEventRequest(...args: any[]): [EventRequest];
+    buildHttpResponse(httpFunctionContext: HttpFunctionContext, ...args: any[]): any;
+    buildScheduleResponse(scheduleFunctionContext: ScheduleFunctionContext, ...args: any[]): any;
+    buildEventResponse(eventFunctionContext: EventFunctionContext, ...args: any[]): any;
+}
+
+interface CloudProvider {
+    name: string;
+    createStorageService(): StorageService;
+    createLocationService(): LocationService;
+    createEventBrokerService(): EventBrokerService;
+    createFunctionsService(): FunctionsService;
+}
+
+export { type BaseEntry, type CloudProvider, type Entry, type Entrypoint, ErrorCode, type EventBrokerService, type EventEntry, type EventFunctionContext, type EventMessage, type EventRequest, type EventResponse, type EventTrigger, type FunctionContext, type FunctionsService, type HTTPAuth, type HTTPRequest, type HTTPResponse, type HandlerType, type HttpEntry, type HttpFunctionContext, type HttpMethod, type HttpTrigger, type LocationService, type MessageFilter, type PeekOptions, type PlaceDetails, type PlaceSearchOptions, type PlaceSearchResult, type PublishOptions, type ReadOptions, type ScheduleEntry, type ScheduleFunctionContext, type ScheduleRequest, type ScheduleResponse, type ScheduleTrigger, type StorageService, type StorageWriteOptions, type StorageWriteResult };

package/dist/index.d.ts

@@ -0,0 +1,384 @@
+type HandlerType = "Http" | "Schedule" | "Event";
+type BaseEntry<TTrigger> = {
+    handler: string;
+    trigger: TTrigger;
+};
+
+type HttpMethod = "GET" | "PUT" | "POST" | "PATCH" | "DELETE";
+type HttpTrigger = {
+    type: "http";
+    options: {
+        route: string;
+        method: HttpMethod;
+    };
+};
+type HttpEntry = BaseEntry<HttpTrigger>;
+
+type ScheduleTrigger = {
+    type: "schedule";
+    options: {
+        name: string;
+        pattern: string;
+    };
+};
+type ScheduleEntry = BaseEntry<ScheduleTrigger>;
+
+interface ComparisonOperators {
+    $eq?: any;
+    $ne?: any;
+    $gt?: number | string | Date;
+    $gte?: number | string | Date;
+    $lt?: number | string | Date;
+    $lte?: number | string | Date;
+}
+interface ArrayOperators {
+    $in?: any[];
+    $nin?: any[];
+    $all?: any[];
+    $size?: number;
+}
+interface StringOperators {
+    $regex?: string;
+    $startsWith?: string;
+    $endsWith?: string;
+    $contains?: string;
+}
+interface ExistenceOperators {
+    $exists?: boolean;
+    $type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'undefined';
+}
+interface LogicalOperatorAnd {
+    $and: FilterCondition[];
+}
+interface LogicalOperatorOr {
+    $or: FilterCondition[];
+}
+type LogicalOperators = LogicalOperatorAnd | LogicalOperatorOr;
+type FilterCondition = ComparisonOperators | ArrayOperators | StringOperators | ExistenceOperators | LogicalOperators;
+type FilterPropertyValue = any | FilterCondition;
+type MessageFilter = {
+    [propertyPath: string]: FilterPropertyValue;
+};
+type EventTrigger = {
+    type: "event";
+    options: {
+        source: string;
+        sourceType: string;
+        filter?: MessageFilter;
+    };
+};
+type EventEntry = BaseEntry<EventTrigger>;
+
+type Entry = HttpEntry | ScheduleEntry | EventEntry;
+type Entrypoint = {
+    entries: Record<string, Entry>;
+};
+
+interface EventBrokerService {
+    /**
+     * Publish a message to a topic/queue
+     * @param target Target topic/queue name
+     * @param message Message to publish
+     * @param options Optional publishing options
+     * @returns Promise resolving when publishing is complete
+     */
+    publish(target: string, message: string | Record<string, any>, options?: PublishOptions): Promise<void>;
+    /**
+     * Read a message without removing it from the queue
+     * @param source Source queue name
+     * @param options Optional reading options
+     * @returns Promise containing the peeked message(s)
+     */
+    peek(source: string, options?: PeekOptions): Promise<EventMessage[]>;
+    /**
+     * Read and remove message(s) from the queue
+     * @param source Source queue name
+     * @param options Optional reading options
+     * @returns Promise containing the read message(s)
+     */
+    read(source: string, options?: ReadOptions): Promise<EventMessage[]>;
+}
+interface PublishOptions {
+    /** Message attributes/headers */
+    attributes?: Record<string, string>;
+    /** Message group ID for FIFO queues */
+    messageGroupId?: string;
+    /** Message deduplication ID for FIFO queues */
+    messageDeduplicationId?: string;
+    /** Delay in seconds before the message becomes visible */
+    delaySeconds?: number;
+}
+interface PeekOptions {
+    /** Maximum number of messages to peek */
+    maxMessages?: number;
+    /** Wait time in seconds for long polling */
+    waitTimeSeconds?: number;
+}
+interface ReadOptions extends PeekOptions {
+    /** Visibility timeout in seconds */
+    visibilityTimeout?: number;
+}
+interface EventMessage {
+    /** Message ID */
+    id: string;
+    /** Message body */
+    body: string;
+    /** Message attributes/headers */
+    attributes?: Record<string, string>;
+    /** Message receipt handle (for operations like delete) */
+    receiptHandle?: string;
+    /** Message published timestamp */
+    publishedAt: Date;
+}
+
+interface LocationService {
+    /**
+     * Search for places based on a query
+     * @param query Search query
+     * @param options Search options like bounding box, filters, etc.
+     * @returns Promise containing search results
+     */
+    searchPlaces(query: string, options?: PlaceSearchOptions): Promise<PlaceSearchResult[]>;
+    /**
+     * Get detailed information about a specific place
+     * @param placeId ID of the place to get details for
+     * @returns Promise containing place details
+     */
+    getPlaceDetails(placeId: string): Promise<PlaceDetails>;
+}
+interface PlaceSearchOptions {
+    /** Bounding box to search within */
+    boundingBox?: {
+        minLongitude: number;
+        minLatitude: number;
+        maxLongitude: number;
+        maxLatitude: number;
+    };
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Filter results by category */
+    categories?: string[];
+    /** Language code for results */
+    language?: string;
+}
+interface PlaceSearchResult {
+    /** Unique identifier for the place */
+    placeId: string;
+    /** Place name */
+    text: string;
+}
+interface PlaceDetails extends PlaceSearchResult {
+    /** Place address */
+    address?: string;
+    /** Geographic coordinates */
+    coordinates: {
+        latitude: number;
+        longitude: number;
+    };
+    /** Distance from search center if applicable */
+    distance?: number;
+    /** Place categories/types */
+    categories?: string[];
+    /** Full formatted address */
+    formattedAddress: string;
+    /** Phone number */
+    phoneNumber?: string;
+    /** Website URL */
+    website?: string;
+    /** Opening hours */
+    openingHours?: {
+        periods: {
+            day: number;
+            open?: string;
+            close?: string;
+        }[];
+        weekdayText?: string[];
+    };
+    /** Reviews if available */
+    reviews?: {
+        rating: number;
+        text?: string;
+        time?: number;
+    }[];
+    /** Additional place data */
+    additionalData?: Record<string, any>;
+}
+
+interface StorageService {
+    /**
+     * Read data from storage
+     * @param path Path to the file/object
+     * @param bucket Bucket or container name
+     * @returns Promise containing the file data
+     */
+    read(path: string, bucket: string): Promise<Buffer>;
+    /**
+     * Write data to storage
+     * @param path Path where to store the file/object
+     * @param data Data to write
+     * @param bucket Bucket or container name
+     * @param options Optional configuration for the write operation
+     * @returns Promise resolving with the result including URL of the stored file
+     */
+    write(path: string, data: Buffer | string, bucket: string, options?: StorageWriteOptions): Promise<StorageWriteResult>;
+    /**
+     * Delete data from storage
+     * @param path Path to the file/object to delete
+     * @param bucket Bucket or container name
+     * @returns Promise resolving when delete is complete
+     */
+    delete(path: string, bucket: string): Promise<void>;
+}
+interface StorageWriteOptions {
+    /** Content type of the file */
+    contentType?: string;
+    /** Access control for the file (public, private, etc.) */
+    acl?: 'private' | 'public-read' | 'public-read-write';
+    /** Custom metadata to attach to the file */
+    metadata?: Record<string, string>;
+}
+interface StorageWriteResult {
+    /**
+     * URL to access the stored file
+     */
+    url: string;
+    /**
+     * Storage bucket or container name
+     */
+    bucket: string;
+    /**
+     * Storage key or path
+     */
+    key: string;
+}
+
+/**
+ * Represents the context object for a function handler.
+ */
+type FunctionContext = {
+    /**
+     * The underlying context handler type.
+     */
+    type: HandlerType;
+    /**
+     * Creates a success response. This should be called when the handler is done successfully.
+     * @param data - The response body.
+     */
+    success<T>(data: T): void;
+    /**
+     * Creates an error response. This should be called when the handler is done with an error.
+     * @param message - The response body.
+     *
+     */
+    error(message: string, code?: ErrorCode, details?: Record<string, any>, stack?: string): void;
+    notFound(resource: string, id?: string | number): void;
+};
+/**
+ * Error codes for API error responses
+ */
+declare enum ErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    INVALID_INPUT = "INVALID_INPUT",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    ACCESS_DENIED = "ACCESS_DENIED",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    RESOURCE_ALREADY_EXISTS = "RESOURCE_ALREADY_EXISTS",
+    RESOURCE_CONFLICT = "RESOURCE_CONFLICT",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    DATABASE_ERROR = "DATABASE_ERROR",
+    BUSINESS_RULE_VIOLATION = "BUSINESS_RULE_VIOLATION",
+    EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+type HTTPRequest = {
+    method: HttpMethod;
+    body?: string;
+    headers: Record<string, string | string[] | undefined>;
+    url: string;
+    params: Record<string, string | undefined>;
+    matchingKey?: string;
+    rawQueryString?: string;
+    requestId?: string;
+    host?: string;
+};
+type HTTPResponse = {
+    headers?: Record<string, string | string[] | undefined>;
+    body?: string;
+    status: number;
+};
+type HTTPAuth = {
+    token: string;
+    appId: string;
+    memberId: string;
+    customerId: string;
+    claims: Record<string, string>;
+    identity: "facebook" | "google" | "apple" | "password";
+};
+type HttpFunctionContext = FunctionContext & {
+    type: "Http";
+    request: HTTPRequest;
+    auth?: HTTPAuth;
+    response: HTTPResponse;
+    model<T = Record<string, any>>(): T;
+    params<T = Record<string, string>>(): T;
+    list<T>(items: T[], page: number, pageSize: number, totalItems: number): void;
+    created<T>(data: T): void;
+    deleted(id?: string | number): void;
+    validationError(details: Record<string, any>): void;
+    serverError(err: Error): void;
+    businessError(message: string, details?: Record<string, any>): void;
+    output(status: number, body?: string, headers?: Record<string, string | string[]>): void;
+};
+type ScheduleResponse = {
+    status: "success" | "error";
+    body?: string | Record<string, any>;
+};
+type ScheduleRequest = {
+    name: string;
+    requestId?: string;
+};
+type ScheduleFunctionContext = FunctionContext & {
+    response: ScheduleResponse;
+    request: ScheduleRequest;
+    type: "Schedule";
+};
+type EventRequest = {
+    body: string | Record<string, any>;
+    attributes: Record<string, string>;
+    requestId?: string;
+    timestamp: Date;
+    attempts?: number;
+};
+type EventResponse = {
+    status: "success" | "error";
+    code?: ErrorCode;
+    body?: Record<string, any>;
+    stack?: string;
+};
+type EventFunctionContext = FunctionContext & {
+    type: "Event";
+    timestamp: Date;
+    attempts?: number;
+    response: EventResponse;
+    message<T = Record<string, any>>(): T;
+    attributes<T = Record<string, any>>(): T;
+};
+interface FunctionsService {
+    createHttRequest(...args: any[]): [HTTPRequest, HTTPAuth?];
+    createScheduleRequest(...args: any[]): [ScheduleRequest];
+    createEventRequest(...args: any[]): [EventRequest];
+    buildHttpResponse(httpFunctionContext: HttpFunctionContext, ...args: any[]): any;
+    buildScheduleResponse(scheduleFunctionContext: ScheduleFunctionContext, ...args: any[]): any;
+    buildEventResponse(eventFunctionContext: EventFunctionContext, ...args: any[]): any;
+}
+
+interface CloudProvider {
+    name: string;
+    createStorageService(): StorageService;
+    createLocationService(): LocationService;
+    createEventBrokerService(): EventBrokerService;
+    createFunctionsService(): FunctionsService;
+}
+
+export { type BaseEntry, type CloudProvider, type Entry, type Entrypoint, ErrorCode, type EventBrokerService, type EventEntry, type EventFunctionContext, type EventMessage, type EventRequest, type EventResponse, type EventTrigger, type FunctionContext, type FunctionsService, type HTTPAuth, type HTTPRequest, type HTTPResponse, type HandlerType, type HttpEntry, type HttpFunctionContext, type HttpMethod, type HttpTrigger, type LocationService, type MessageFilter, type PeekOptions, type PlaceDetails, type PlaceSearchOptions, type PlaceSearchResult, type PublishOptions, type ReadOptions, type ScheduleEntry, type ScheduleFunctionContext, type ScheduleRequest, type ScheduleResponse, type ScheduleTrigger, type StorageService, type StorageWriteOptions, type StorageWriteResult };

package/dist/index.js

@@ -0,0 +1,48 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ErrorCode: () => ErrorCode
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/services/functions.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+  ErrorCode2["INVALID_INPUT"] = "INVALID_INPUT";
+  ErrorCode2["UNAUTHORIZED"] = "UNAUTHORIZED";
+  ErrorCode2["ACCESS_DENIED"] = "ACCESS_DENIED";
+  ErrorCode2["RESOURCE_NOT_FOUND"] = "RESOURCE_NOT_FOUND";
+  ErrorCode2["RESOURCE_ALREADY_EXISTS"] = "RESOURCE_ALREADY_EXISTS";
+  ErrorCode2["RESOURCE_CONFLICT"] = "RESOURCE_CONFLICT";
+  ErrorCode2["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+  ErrorCode2["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+  ErrorCode2["DATABASE_ERROR"] = "DATABASE_ERROR";
+  ErrorCode2["BUSINESS_RULE_VIOLATION"] = "BUSINESS_RULE_VIOLATION";
+  ErrorCode2["EXTERNAL_API_ERROR"] = "EXTERNAL_API_ERROR";
+  ErrorCode2["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorCode
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/services/functions.ts"],"sourcesContent":["export * from \"./entrypoint\";\nexport * from \"./services/event-broker\";\nexport * from \"./services/location\";\nexport * from \"./services/storage\";\nexport * from \"./services/functions\";\nexport * from \"./cloud-provider\";","import { HandlerType, HttpMethod } from \"../entrypoint\";\n\n/**\n * Represents the context object for a function handler.\n */\nexport type FunctionContext = {\n    /**\n     * The underlying context handler type.\n     */\n    type: HandlerType;\n\n    /**\n     * Creates a success response. This should be called when the handler is done successfully.\n     * @param data - The response body.\n     */\n    success<T>(data: T): void;\n\n    /**\n     * Creates an error response. This should be called when the handler is done with an error.\n     * @param message - The response body.\n     * \n     */\n    error(message: string, code?: ErrorCode, details?: Record<string, any>, stack?: string): void;\n    notFound(resource: string, id?: string | number): void;\n\n\n\n    // success(body?: any): void;\n\n\n    // error(body?: any): void;\n\n    // /**\n    //  * Creates a not found response. This should be called when there is no matching handler.\n    //  * @param body - The response body.\n    //  * @returns A promise that resolves when the response is created, or void if not using a promise.\n    //  */\n    // notFound(body?: any): void;\n};\n\n/**\n * Error codes for API error responses\n */\nexport enum ErrorCode {\n    // Validation errors\n    VALIDATION_ERROR = 'VALIDATION_ERROR',\n    INVALID_INPUT = 'INVALID_INPUT',\n\n    // Authentication errors\n    UNAUTHORIZED = 'UNAUTHORIZED',\n    ACCESS_DENIED = 'ACCESS_DENIED',\n\n    // Resource errors\n    RESOURCE_NOT_FOUND = 'RESOURCE_NOT_FOUND',\n    RESOURCE_ALREADY_EXISTS = 'RESOURCE_ALREADY_EXISTS',\n    RESOURCE_CONFLICT = 'RESOURCE_CONFLICT',\n\n    // System errors\n    INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',\n    SERVICE_UNAVAILABLE = 'SERVICE_UNAVAILABLE',\n    DATABASE_ERROR = 'DATABASE_ERROR',\n\n    // Business logic errors\n    BUSINESS_RULE_VIOLATION = 'BUSINESS_RULE_VIOLATION',\n\n    // External API errors\n    EXTERNAL_API_ERROR = 'EXTERNAL_API_ERROR',\n\n    // Other errors\n    UNKNOWN_ERROR = 'UNKNOWN_ERROR'\n}\n\n//#region [ Http ]\n\nexport type HTTPRequest = {\n    method: HttpMethod;\n    body?: string;\n    headers: Record<string, string | string[] | undefined>;\n    url: string;\n    params: Record<string, string | undefined>\n    matchingKey?: string;\n    rawQueryString?: string,\n    requestId?: string,\n    host?: string\n};\n\nexport type HTTPResponse = {\n    headers?: Record<string, string | string[] | undefined>;\n    body?: string;\n    status: number;\n};\n\nexport type HTTPAuth = {\n    token: string;\n    appId: string;\n    memberId: string;\n    customerId: string;\n    claims: Record<string, string>;\n    identity: \"facebook\" | \"google\" | \"apple\" | \"password\";\n};\n\nexport type HttpFunctionContext = FunctionContext & {\n    type: \"Http\";\n    request: HTTPRequest;\n    auth?: HTTPAuth;\n    response: HTTPResponse;\n    model<T = Record<string, any>>(): T;\n    params<T = Record<string, string>>(): T;\n\n    list<T>(items: T[], page: number, pageSize: number, totalItems: number): void;\n    created<T>(data: T): void;\n    deleted(id?: string | number): void;\n    validationError(details: Record<string, any>): void;\n    serverError(err: Error): void;\n    businessError(message: string, details?: Record<string, any>): void;\n    output(status: number, body?: string, headers?: Record<string, string | string[]>): void;\n}\n\n//#endregion\n\n//#region [Schedule]\n\nexport type ScheduleResponse = {\n    status: \"success\" | \"error\",\n    body?: string | Record<string, any>;\n}\n\nexport type ScheduleRequest = {\n    name: string,\n    requestId?: string\n};\n\nexport type ScheduleFunctionContext = FunctionContext & {\n    response: ScheduleResponse;\n    request: ScheduleRequest;\n    type: \"Schedule\";\n}\n//#endregion\n\n//#region [Event]\nexport type EventRequest = {\n    body: string | Record<string, any>,\n    attributes: Record<string, string>,\n    requestId?: string,\n    timestamp: Date,\n    attempts?: number;\n}\n\nexport type EventResponse = {\n    status: \"success\" | \"error\",\n    code?: ErrorCode,\n    body?: Record<string, any>\n    stack?: string\n};\n\nexport type EventFunctionContext = FunctionContext & {\n    type: \"Event\";\n    timestamp: Date;\n    attempts?: number;\n    response: EventResponse;\n    message<T = Record<string, any>>(): T;\n    attributes<T = Record<string, any>>(): T;\n}\n//#endregion\n\nexport interface FunctionsService {\n    createHttRequest(...args: any[]): [HTTPRequest, HTTPAuth?];\n    createScheduleRequest(...args: any[]): [ScheduleRequest];\n    createEventRequest(...args: any[]): [EventRequest];\n\n    buildHttpResponse(httpFunctionContext: HttpFunctionContext, ...args: any[]): any\n    buildScheduleResponse(scheduleFunctionContext: ScheduleFunctionContext, ...args: any[]): any;\n    buildEventResponse(eventFunctionContext: EventFunctionContext, ...args: any[]): any;\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2CO,IAAK,YAAL,kBAAKA,eAAL;AAEH,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,6BAA0B;AAC1B,EAAAA,WAAA,uBAAoB;AAGpB,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,oBAAiB;AAGjB,EAAAA,WAAA,6BAA0B;AAG1B,EAAAA,WAAA,wBAAqB;AAGrB,EAAAA,WAAA,mBAAgB;AA1BR,SAAAA;AAAA,GAAA;","names":["ErrorCode"]}

package/dist/index.mjs

@@ -0,0 +1,21 @@
+// src/services/functions.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+  ErrorCode2["INVALID_INPUT"] = "INVALID_INPUT";
+  ErrorCode2["UNAUTHORIZED"] = "UNAUTHORIZED";
+  ErrorCode2["ACCESS_DENIED"] = "ACCESS_DENIED";
+  ErrorCode2["RESOURCE_NOT_FOUND"] = "RESOURCE_NOT_FOUND";
+  ErrorCode2["RESOURCE_ALREADY_EXISTS"] = "RESOURCE_ALREADY_EXISTS";
+  ErrorCode2["RESOURCE_CONFLICT"] = "RESOURCE_CONFLICT";
+  ErrorCode2["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+  ErrorCode2["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+  ErrorCode2["DATABASE_ERROR"] = "DATABASE_ERROR";
+  ErrorCode2["BUSINESS_RULE_VIOLATION"] = "BUSINESS_RULE_VIOLATION";
+  ErrorCode2["EXTERNAL_API_ERROR"] = "EXTERNAL_API_ERROR";
+  ErrorCode2["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+export {
+  ErrorCode
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/functions.ts"],"sourcesContent":["import { HandlerType, HttpMethod } from \"../entrypoint\";\n\n/**\n * Represents the context object for a function handler.\n */\nexport type FunctionContext = {\n    /**\n     * The underlying context handler type.\n     */\n    type: HandlerType;\n\n    /**\n     * Creates a success response. This should be called when the handler is done successfully.\n     * @param data - The response body.\n     */\n    success<T>(data: T): void;\n\n    /**\n     * Creates an error response. This should be called when the handler is done with an error.\n     * @param message - The response body.\n     * \n     */\n    error(message: string, code?: ErrorCode, details?: Record<string, any>, stack?: string): void;\n    notFound(resource: string, id?: string | number): void;\n\n\n\n    // success(body?: any): void;\n\n\n    // error(body?: any): void;\n\n    // /**\n    //  * Creates a not found response. This should be called when there is no matching handler.\n    //  * @param body - The response body.\n    //  * @returns A promise that resolves when the response is created, or void if not using a promise.\n    //  */\n    // notFound(body?: any): void;\n};\n\n/**\n * Error codes for API error responses\n */\nexport enum ErrorCode {\n    // Validation errors\n    VALIDATION_ERROR = 'VALIDATION_ERROR',\n    INVALID_INPUT = 'INVALID_INPUT',\n\n    // Authentication errors\n    UNAUTHORIZED = 'UNAUTHORIZED',\n    ACCESS_DENIED = 'ACCESS_DENIED',\n\n    // Resource errors\n    RESOURCE_NOT_FOUND = 'RESOURCE_NOT_FOUND',\n    RESOURCE_ALREADY_EXISTS = 'RESOURCE_ALREADY_EXISTS',\n    RESOURCE_CONFLICT = 'RESOURCE_CONFLICT',\n\n    // System errors\n    INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',\n    SERVICE_UNAVAILABLE = 'SERVICE_UNAVAILABLE',\n    DATABASE_ERROR = 'DATABASE_ERROR',\n\n    // Business logic errors\n    BUSINESS_RULE_VIOLATION = 'BUSINESS_RULE_VIOLATION',\n\n    // External API errors\n    EXTERNAL_API_ERROR = 'EXTERNAL_API_ERROR',\n\n    // Other errors\n    UNKNOWN_ERROR = 'UNKNOWN_ERROR'\n}\n\n//#region [ Http ]\n\nexport type HTTPRequest = {\n    method: HttpMethod;\n    body?: string;\n    headers: Record<string, string | string[] | undefined>;\n    url: string;\n    params: Record<string, string | undefined>\n    matchingKey?: string;\n    rawQueryString?: string,\n    requestId?: string,\n    host?: string\n};\n\nexport type HTTPResponse = {\n    headers?: Record<string, string | string[] | undefined>;\n    body?: string;\n    status: number;\n};\n\nexport type HTTPAuth = {\n    token: string;\n    appId: string;\n    memberId: string;\n    customerId: string;\n    claims: Record<string, string>;\n    identity: \"facebook\" | \"google\" | \"apple\" | \"password\";\n};\n\nexport type HttpFunctionContext = FunctionContext & {\n    type: \"Http\";\n    request: HTTPRequest;\n    auth?: HTTPAuth;\n    response: HTTPResponse;\n    model<T = Record<string, any>>(): T;\n    params<T = Record<string, string>>(): T;\n\n    list<T>(items: T[], page: number, pageSize: number, totalItems: number): void;\n    created<T>(data: T): void;\n    deleted(id?: string | number): void;\n    validationError(details: Record<string, any>): void;\n    serverError(err: Error): void;\n    businessError(message: string, details?: Record<string, any>): void;\n    output(status: number, body?: string, headers?: Record<string, string | string[]>): void;\n}\n\n//#endregion\n\n//#region [Schedule]\n\nexport type ScheduleResponse = {\n    status: \"success\" | \"error\",\n    body?: string | Record<string, any>;\n}\n\nexport type ScheduleRequest = {\n    name: string,\n    requestId?: string\n};\n\nexport type ScheduleFunctionContext = FunctionContext & {\n    response: ScheduleResponse;\n    request: ScheduleRequest;\n    type: \"Schedule\";\n}\n//#endregion\n\n//#region [Event]\nexport type EventRequest = {\n    body: string | Record<string, any>,\n    attributes: Record<string, string>,\n    requestId?: string,\n    timestamp: Date,\n    attempts?: number;\n}\n\nexport type EventResponse = {\n    status: \"success\" | \"error\",\n    code?: ErrorCode,\n    body?: Record<string, any>\n    stack?: string\n};\n\nexport type EventFunctionContext = FunctionContext & {\n    type: \"Event\";\n    timestamp: Date;\n    attempts?: number;\n    response: EventResponse;\n    message<T = Record<string, any>>(): T;\n    attributes<T = Record<string, any>>(): T;\n}\n//#endregion\n\nexport interface FunctionsService {\n    createHttRequest(...args: any[]): [HTTPRequest, HTTPAuth?];\n    createScheduleRequest(...args: any[]): [ScheduleRequest];\n    createEventRequest(...args: any[]): [EventRequest];\n\n    buildHttpResponse(httpFunctionContext: HttpFunctionContext, ...args: any[]): any\n    buildScheduleResponse(scheduleFunctionContext: ScheduleFunctionContext, ...args: any[]): any;\n    buildEventResponse(eventFunctionContext: EventFunctionContext, ...args: any[]): any;\n}"],"mappings":";AA2CO,IAAK,YAAL,kBAAKA,eAAL;AAEH,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,6BAA0B;AAC1B,EAAAA,WAAA,uBAAoB;AAGpB,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,oBAAiB;AAGjB,EAAAA,WAAA,6BAA0B;AAG1B,EAAAA,WAAA,wBAAqB;AAGrB,EAAAA,WAAA,mBAAgB;AA1BR,SAAAA;AAAA,GAAA;","names":["ErrorCode"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@cloudnux/core-cloud-provider",
+  "version": "0.1.0",
+  "description": "CloudNux core interfaces and types for multi-cloud abstraction",
+  "license": "MIT",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cloudnux/cloudnux.git",
+    "directory": "packages/cloud-providers/core"
+  },
+  "keywords": [
+    "cloud",
+    "multi-cloud",
+    "aws",
+    "azure",
+    "gcp",
+    "interfaces",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "yalc:publish": "yalc publish --private",
+    "yalc:push": "yalc push --private",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}