@telorun/sdk 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -12,7 +12,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist/**",
+    "src/**"
   ],
   "devDependencies": {
     "@types/node": "^20.0.0",

package/src/controller-context.ts

@@ -0,0 +1,21 @@
+import { RuntimeEvent } from './runtime-event.js';
+
+export interface ControllerContext {
+  on(
+    event: string,
+    handler: (event: RuntimeEvent) => void | Promise<void>,
+  ): void;
+  once(
+    event: string,
+    handler: (event: RuntimeEvent) => void | Promise<void>,
+  ): void;
+  off(
+    event: string,
+    handler: (event: RuntimeEvent) => void | Promise<void>,
+  ): void;
+  emit(event: string, payload?: any, metadata?: Record<string, any>): void;
+  acquireHold(reason?: string): () => void;
+  requestExit(code: number): void;
+  evaluateCel(expression: string, context: Record<string, any>): unknown;
+  expandValue(value: any, context: Record<string, any>): any;
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from './controller-context.js';
+export * from './resource-context.js';
+export * from './resource-instance.js';
+export * from './resource-manifest.js';
+export * from './runtime-error.js';
+export * from './runtime-event.js';
+export * from './runtime-resource.js';
+

package/src/resource-context.ts

@@ -0,0 +1,34 @@
+import { ControllerContext } from "./controller-context.js";
+import { RuntimeResource } from "./runtime-resource.js";
+
+export interface DataValidator {
+  validate(data: any): void;
+  isValid(data: any): boolean;
+}
+
+export class NoopValidator implements DataValidator {
+  isValid() {
+    return true;
+  }
+
+  validate() {
+    // noop
+  }
+}
+
+export interface ResourceContext extends ControllerContext {
+  acquireHold(reason?: string): () => void;
+  emitEvent(event: string, payload?: any): Promise<void>;
+  invoke(kind: string, name: string, ...args: any[]): Promise<any>;
+  getResources(kind: string): RuntimeResource[];
+  getResourcesByName(kind: string, name: string): RuntimeResource | null;
+  registerManifest(resource: any): void;
+  validateSchema(value: any, schema: any): void;
+  createSchemaValidator(schema: any): DataValidator;
+  registerController(
+    moduleName: string,
+    resourceKind: string,
+    controllerInstance: any,
+  ): Promise<void>;
+  registerDefinition(definition: any): void;
+}

package/src/resource-instance.ts

@@ -0,0 +1,15 @@
+import { ResourceContext } from "./resource-context.js";
+
+export type ResourceInstance = {
+  init?(ctx?: ResourceContext): Promise<void>;
+  run?(): void | Promise<void>;
+  invoke?(input: any): any | Promise<any>;
+  teardown?(): void | Promise<void>;
+
+  /**
+   * Optional method for debugging/snapshots
+   * Called when taking runtime state snapshots
+   * Should return serializable state data specific to this resource
+   */
+  snapshot?(): Record<string, any> | Promise<Record<string, any>>;
+};

package/src/resource-manifest.ts

@@ -0,0 +1,12 @@
+/**
+ * Type for resource manifest defined in YAML files
+ */
+export interface ResourceManifest {
+  kind: string;
+  metadata: {
+    name: string;
+    module: string;
+    [key: string]: any;
+  };
+  [key: string]: any;
+}

package/src/runtime-error.ts

@@ -0,0 +1,8 @@
+export type RuntimeErrorCode =
+  | 'ERR_RESOURCE_NOT_FOUND'
+  | 'ERR_CONTROLLER_NOT_FOUND'
+  | 'ERR_CONTROLLER_INVALID'
+  | 'ERR_RESOURCE_NOT_INVOKABLE'
+  | 'ERR_DUPLICATE_RESOURCE'
+  | 'ERR_EXECUTION_FAILED'
+  | 'ERR_INVALID_VALUE';

package/src/runtime-event.ts

@@ -0,0 +1,5 @@
+export type RuntimeEvent = {
+  name: string;
+  payload?: any;
+  metadata?: Record<string, any>;
+};

package/src/runtime-resource.ts

@@ -0,0 +1,8 @@
+export interface RuntimeResource {
+  kind: string;
+  metadata: {
+    name: string;
+    module: string;
+    [key: string]: any;
+  };
+}