atomservices 0.12.0-alpha.0 → 0.12.0-alpha.1

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+interface IEvent<Payload = any, Metadata = any> {
+    _id: string;
+    name: string;
+    aggregateID: string;
+    aggregateType: string;
+    payload: Payload;
+    _version: number;
+    _createdAt: Date;
+    _createdBy: string;
+    _metadata: {} & Metadata;
+}
+
+interface IEventStore {
+    /**
+     * Loads the entire event stream for a specific aggregate.
+     * Returns an empty array if no events exist.
+     */
+    load(aggregateID: string): Promise<IEvent[]>;
+    /**
+     * Appends new events to the stream.
+     * * @param expectedVersion - The version of the aggregate *before* these new events.
+     * Used for Optimistic Concurrency Control.
+     * If the DB version != expectedVersion, throw ConcurrencyError.
+     * @param events - The list of events to append.
+     */
+    save(expectedVersion: number, events: IEvent[]): Promise<void>;
+    /**
+     * Optional: Hook for infrastructure setup (indexes, tables).
+     */
+    init?(): Promise<void>;
+}
+
+export type { IEvent, IEventStore };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+interface IEvent<Payload = any, Metadata = any> {
+    _id: string;
+    name: string;
+    aggregateID: string;
+    aggregateType: string;
+    payload: Payload;
+    _version: number;
+    _createdAt: Date;
+    _createdBy: string;
+    _metadata: {} & Metadata;
+}
+
+interface IEventStore {
+    /**
+     * Loads the entire event stream for a specific aggregate.
+     * Returns an empty array if no events exist.
+     */
+    load(aggregateID: string): Promise<IEvent[]>;
+    /**
+     * Appends new events to the stream.
+     * * @param expectedVersion - The version of the aggregate *before* these new events.
+     * Used for Optimistic Concurrency Control.
+     * If the DB version != expectedVersion, throw ConcurrencyError.
+     * @param events - The list of events to append.
+     */
+    save(expectedVersion: number, events: IEvent[]): Promise<void>;
+    /**
+     * Optional: Hook for infrastructure setup (indexes, tables).
+     */
+    init?(): Promise<void>;
+}
+
+export type { IEvent, IEventStore };

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 = {};
+module.exports = __toCommonJS(index_exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { IEvent } from \"./IEvent\";\r\nexport { IEventStore } from \"./IEventStore\";\r\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,17 +1,23 @@
 {
   "name": "atomservices",
-  "version": "0.12.0-alpha.0",
-  "description": "",
+  "version": "0.12.0-alpha.1",
+  "description": "EventSourcing Core Infrastructure",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "license": "ISC",
-  "author": "",
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "author": "Architecode",
   "type": "commonjs",
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "test": "vitest"
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",

package/src/IEvent.ts

@@ -1,33 +0,0 @@
-// src/IEvent.ts
-
-export interface IEvent<Payload, Metadata = any> {
-  _id: string;                // UUID of the event
-  name: string;               // Event Name (e.g., UserCreated)
-  aggregateID: string;        // ID of the aggregate root (Stream ID)
-  aggregateType: string;      // Type of the aggregate (e.g., User)
-  payload: Payload;           // The Domain Data
-  
-  // Infrastructure
-  _version: number;           // Optimistic Concurrency Version (1, 2, 3...)
-  _createdAt: Date;
-  _createdBy: string;         // User ID
-  _metadata: {} & Metadata;   // Tracing/Context data
-}
-
-/**
- * ------------------------------------------------------------------
- * INFRASTRUCTURE REQUIREMENT: MONGODB INDEXES
- * ------------------------------------------------------------------
- * To ensure data integrity and performance, the implementation of 
- * the EventStore MUST apply the following indexes to the collection:
- *
- * 1. CONCURRENCY CONTROL (Critical):
- * Ensures that for any given Aggregate, versions are unique and sequential.
- * Index: { aggregateID: 1, _version: 1 }
- * Options: { unique: true }
- *
- * 2. PERFORMANCE (Recommended):
- * Allows fast filtering by aggregate type for admin views/projections.
- * Index: { aggregateType: 1, _createdAt: -1 }
- * ------------------------------------------------------------------
- */

package/src/index.ts

@@ -1 +0,0 @@
-export { IEvent } from "./IEvent";

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": [
-      "ES2020",
-      "DOM"
-    ],
-    "moduleResolution": "node",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "sourceMap": true,
-    "outDir": "dist"
-  },
-  "include": [
-    "src"
-  ],
-  "exclude": [
-    "node_modules",
-    "**/*.test.ts"
-  ]
-}

package/tsup.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts"],
-  format: ["cjs", "esm"],
-  dts: true,
-  clean: true,
-  sourcemap: true,
-});