@zysec-ai/cpod-sdk 0.1.0

package/dist/events/index.d.mts

@@ -0,0 +1,139 @@
+import { V as PaginationOptions, O as HttpClient, ac as RequestOptions, a as ApiResponse } from '../client-BRW4z8Ls.mjs';
+
+/**
+ * Well-known event type strings emitted by the cPod platform.
+ * Additional event types may be emitted for enterprise features — use string
+ * literals for those until they are added to this enum.
+ */
+declare enum EventType {
+    PodCreated = "pod.created",
+    PodUpdated = "pod.updated",
+    PodDeleted = "pod.deleted",
+    PodStatusChanged = "pod.status_changed",
+    PodStarted = "pod.started",
+    PodStopped = "pod.stopped",
+    PodFailed = "pod.failed",
+    OrganizationCreated = "organization.created",
+    OrganizationUpdated = "organization.updated",
+    OrganizationArchived = "organization.archived",
+    OrganizationMemberAdded = "organization.member_added",
+    OrganizationMemberRemoved = "organization.member_removed",
+    WorkspaceCreated = "workspace.created",
+    WorkspaceUpdated = "workspace.updated",
+    WorkspaceArchived = "workspace.archived",
+    CredentialCreated = "credential.created",
+    CredentialRevoked = "credential.revoked",
+    CredentialExpired = "credential.expired",
+    PolicyCreated = "policy.created",
+    PolicyUpdated = "policy.updated",
+    PolicyDeleted = "policy.deleted",
+    UserSuspended = "user.suspended",
+    UserReactivated = "user.reactivated"
+}
+/** A platform event delivered to subscribers or returned from event history. */
+interface CpodEvent {
+    /** Unique event identifier (UUID). */
+    id: string;
+    /** Dot-notation event type (e.g., 'pod.created', 'credential.revoked'). */
+    type: EventType | string;
+    /** UUID of the Organization in whose context this event occurred. */
+    organizationId: string;
+    /** UUID of the Workspace, if this event is workspace-scoped. */
+    workspaceId?: string;
+    /** UUID of the specific resource affected. */
+    resourceId: string;
+    /** Entity type of the resource (e.g., 'Pod', 'Credential'). */
+    resourceType: string;
+    /** Event-specific payload. Shape varies by event type. */
+    payload: Record<string, unknown>;
+    /** ISO 8601 timestamp of when the event occurred. */
+    timestamp: string;
+    /** Schema version of the payload (e.g., '1.0'). */
+    version: string;
+}
+/** Filter criteria for event subscriptions and history queries. */
+interface EventFilter {
+    /** Filter to events in a specific Organization. */
+    organizationId?: string;
+    /** Filter to events in a specific Workspace. */
+    workspaceId?: string;
+    /** Filter to events affecting a specific resource type. */
+    resourceType?: string;
+    /** Filter to events affecting a specific resource UUID. */
+    resourceId?: string;
+    /** Filter to specific event types. */
+    types?: Array<EventType | string>;
+}
+/** Options for subscribing to real-time events. */
+interface SubscribeOptions {
+    /** Replay events that occurred after this ISO 8601 timestamp. */
+    since?: string;
+}
+/** Options for querying historical events. */
+interface EventHistoryOptions extends PaginationOptions {
+    /** Filter to a specific Organization. */
+    organizationId?: string;
+    /** Filter to a specific Workspace. */
+    workspaceId?: string;
+    /** Filter to events affecting a specific resource type. */
+    resourceType?: string;
+    /** Filter to events affecting a specific resource UUID. */
+    resourceId?: string;
+    /** Filter to specific event types. */
+    types?: Array<EventType | string>;
+    /** Return only events after this ISO 8601 timestamp. */
+    since?: string;
+    /** Return only events before this ISO 8601 timestamp. */
+    until?: string;
+}
+/** Callback invoked when a matching event is received. */
+type EventHandler = (event: CpodEvent) => void;
+/** Handle returned by `EventService.subscribe()`. */
+interface Subscription {
+    /** Stop receiving events for this subscription. */
+    unsubscribe(): void;
+}
+
+/**
+ * Manages event subscriptions and history for cPod resources.
+ *
+ * Subscriptions use a poll-based EventEmitter-like pattern over the REST API.
+ * For real-time SSE, the server must expose a `/api/v1/events/stream` endpoint.
+ *
+ * @example
+ * ```typescript
+ * const sub = client.events.subscribe(
+ *   { organizationId: "b2c3d4e5-...", types: ["pod.failed"] },
+ *   (event) => {
+ *     console.log("Pod failed:", event.resourceId, event.payload);
+ *   }
+ * );
+ *
+ * // Later, stop receiving events:
+ * sub.unsubscribe();
+ * ```
+ */
+declare class EventService {
+    private readonly http;
+    private readonly listeners;
+    constructor(http: HttpClient);
+    /**
+     * Subscribe to events matching the given filter.
+     * The handler is called for each matching event received.
+     *
+     * Returns a Subscription handle — call `.unsubscribe()` to stop.
+     */
+    subscribe(filter: EventFilter, handler: EventHandler, _opts?: SubscribeOptions): Subscription;
+    /**
+     * Dispatch a raw event object to all matching subscribers.
+     * Typically called internally when processing SSE or webhook payloads.
+     */
+    dispatch(event: CpodEvent): void;
+    /**
+     * Retrieve historical events from the API.
+     */
+    getHistory(opts?: EventHistoryOptions, requestOpts?: RequestOptions): Promise<ApiResponse<CpodEvent[]>>;
+    private matchesFilter;
+}
+
+export { type CpodEvent, type EventFilter, type EventHandler, type EventHistoryOptions, EventService, EventType, type SubscribeOptions, type Subscription };

package/dist/events/index.d.ts

@@ -0,0 +1,139 @@
+import { V as PaginationOptions, O as HttpClient, ac as RequestOptions, a as ApiResponse } from '../client-BRW4z8Ls.js';
+
+/**
+ * Well-known event type strings emitted by the cPod platform.
+ * Additional event types may be emitted for enterprise features — use string
+ * literals for those until they are added to this enum.
+ */
+declare enum EventType {
+    PodCreated = "pod.created",
+    PodUpdated = "pod.updated",
+    PodDeleted = "pod.deleted",
+    PodStatusChanged = "pod.status_changed",
+    PodStarted = "pod.started",
+    PodStopped = "pod.stopped",
+    PodFailed = "pod.failed",
+    OrganizationCreated = "organization.created",
+    OrganizationUpdated = "organization.updated",
+    OrganizationArchived = "organization.archived",
+    OrganizationMemberAdded = "organization.member_added",
+    OrganizationMemberRemoved = "organization.member_removed",
+    WorkspaceCreated = "workspace.created",
+    WorkspaceUpdated = "workspace.updated",
+    WorkspaceArchived = "workspace.archived",
+    CredentialCreated = "credential.created",
+    CredentialRevoked = "credential.revoked",
+    CredentialExpired = "credential.expired",
+    PolicyCreated = "policy.created",
+    PolicyUpdated = "policy.updated",
+    PolicyDeleted = "policy.deleted",
+    UserSuspended = "user.suspended",
+    UserReactivated = "user.reactivated"
+}
+/** A platform event delivered to subscribers or returned from event history. */
+interface CpodEvent {
+    /** Unique event identifier (UUID). */
+    id: string;
+    /** Dot-notation event type (e.g., 'pod.created', 'credential.revoked'). */
+    type: EventType | string;
+    /** UUID of the Organization in whose context this event occurred. */
+    organizationId: string;
+    /** UUID of the Workspace, if this event is workspace-scoped. */
+    workspaceId?: string;
+    /** UUID of the specific resource affected. */
+    resourceId: string;
+    /** Entity type of the resource (e.g., 'Pod', 'Credential'). */
+    resourceType: string;
+    /** Event-specific payload. Shape varies by event type. */
+    payload: Record<string, unknown>;
+    /** ISO 8601 timestamp of when the event occurred. */
+    timestamp: string;
+    /** Schema version of the payload (e.g., '1.0'). */
+    version: string;
+}
+/** Filter criteria for event subscriptions and history queries. */
+interface EventFilter {
+    /** Filter to events in a specific Organization. */
+    organizationId?: string;
+    /** Filter to events in a specific Workspace. */
+    workspaceId?: string;
+    /** Filter to events affecting a specific resource type. */
+    resourceType?: string;
+    /** Filter to events affecting a specific resource UUID. */
+    resourceId?: string;
+    /** Filter to specific event types. */
+    types?: Array<EventType | string>;
+}
+/** Options for subscribing to real-time events. */
+interface SubscribeOptions {
+    /** Replay events that occurred after this ISO 8601 timestamp. */
+    since?: string;
+}
+/** Options for querying historical events. */
+interface EventHistoryOptions extends PaginationOptions {
+    /** Filter to a specific Organization. */
+    organizationId?: string;
+    /** Filter to a specific Workspace. */
+    workspaceId?: string;
+    /** Filter to events affecting a specific resource type. */
+    resourceType?: string;
+    /** Filter to events affecting a specific resource UUID. */
+    resourceId?: string;
+    /** Filter to specific event types. */
+    types?: Array<EventType | string>;
+    /** Return only events after this ISO 8601 timestamp. */
+    since?: string;
+    /** Return only events before this ISO 8601 timestamp. */
+    until?: string;
+}
+/** Callback invoked when a matching event is received. */
+type EventHandler = (event: CpodEvent) => void;
+/** Handle returned by `EventService.subscribe()`. */
+interface Subscription {
+    /** Stop receiving events for this subscription. */
+    unsubscribe(): void;
+}
+
+/**
+ * Manages event subscriptions and history for cPod resources.
+ *
+ * Subscriptions use a poll-based EventEmitter-like pattern over the REST API.
+ * For real-time SSE, the server must expose a `/api/v1/events/stream` endpoint.
+ *
+ * @example
+ * ```typescript
+ * const sub = client.events.subscribe(
+ *   { organizationId: "b2c3d4e5-...", types: ["pod.failed"] },
+ *   (event) => {
+ *     console.log("Pod failed:", event.resourceId, event.payload);
+ *   }
+ * );
+ *
+ * // Later, stop receiving events:
+ * sub.unsubscribe();
+ * ```
+ */
+declare class EventService {
+    private readonly http;
+    private readonly listeners;
+    constructor(http: HttpClient);
+    /**
+     * Subscribe to events matching the given filter.
+     * The handler is called for each matching event received.
+     *
+     * Returns a Subscription handle — call `.unsubscribe()` to stop.
+     */
+    subscribe(filter: EventFilter, handler: EventHandler, _opts?: SubscribeOptions): Subscription;
+    /**
+     * Dispatch a raw event object to all matching subscribers.
+     * Typically called internally when processing SSE or webhook payloads.
+     */
+    dispatch(event: CpodEvent): void;
+    /**
+     * Retrieve historical events from the API.
+     */
+    getHistory(opts?: EventHistoryOptions, requestOpts?: RequestOptions): Promise<ApiResponse<CpodEvent[]>>;
+    private matchesFilter;
+}
+
+export { type CpodEvent, type EventFilter, type EventHandler, type EventHistoryOptions, EventService, EventType, type SubscribeOptions, type Subscription };

package/dist/events/index.js

@@ -0,0 +1,112 @@
+'use strict';
+
+// src/events/service.ts
+var EventService = class {
+  http;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Subscribe to events matching the given filter.
+   * The handler is called for each matching event received.
+   *
+   * Returns a Subscription handle — call `.unsubscribe()` to stop.
+   */
+  subscribe(filter, handler, _opts = {}) {
+    const key = /* @__PURE__ */ Symbol("subscription");
+    this.listeners.set(key, { filter, handler });
+    return {
+      unsubscribe: () => {
+        this.listeners.delete(key);
+      }
+    };
+  }
+  /**
+   * Dispatch a raw event object to all matching subscribers.
+   * Typically called internally when processing SSE or webhook payloads.
+   */
+  dispatch(event) {
+    for (const { filter, handler } of this.listeners.values()) {
+      if (this.matchesFilter(event, filter)) {
+        try {
+          handler(event);
+        } catch {
+        }
+      }
+    }
+  }
+  /**
+   * Retrieve historical events from the API.
+   */
+  async getHistory(opts = {}, requestOpts) {
+    const params = new URLSearchParams();
+    if (opts.limit !== void 0) params.set("limit", String(opts.limit));
+    if (opts.offset !== void 0) params.set("offset", String(opts.offset));
+    if (opts.organizationId !== void 0)
+      params.set("organizationId", opts.organizationId);
+    if (opts.workspaceId !== void 0)
+      params.set("workspaceId", opts.workspaceId);
+    if (opts.resourceType !== void 0)
+      params.set("resourceType", opts.resourceType);
+    if (opts.resourceId !== void 0)
+      params.set("resourceId", opts.resourceId);
+    if (opts.since !== void 0) params.set("since", opts.since);
+    if (opts.until !== void 0) params.set("until", opts.until);
+    if (opts.types && opts.types.length > 0) {
+      params.set("types", opts.types.join(","));
+    }
+    const qs = params.toString();
+    return this.http.get(
+      `/api/v1/events${qs ? `?${qs}` : ""}`,
+      requestOpts
+    );
+  }
+  matchesFilter(event, filter) {
+    if (filter.organizationId && event.organizationId !== filter.organizationId)
+      return false;
+    if (filter.workspaceId && event.workspaceId !== filter.workspaceId)
+      return false;
+    if (filter.resourceType && event.resourceType !== filter.resourceType)
+      return false;
+    if (filter.resourceId && event.resourceId !== filter.resourceId)
+      return false;
+    if (filter.types && filter.types.length > 0) {
+      if (!filter.types.includes(event.type)) return false;
+    }
+    return true;
+  }
+};
+
+// src/events/types.ts
+var EventType = /* @__PURE__ */ ((EventType2) => {
+  EventType2["PodCreated"] = "pod.created";
+  EventType2["PodUpdated"] = "pod.updated";
+  EventType2["PodDeleted"] = "pod.deleted";
+  EventType2["PodStatusChanged"] = "pod.status_changed";
+  EventType2["PodStarted"] = "pod.started";
+  EventType2["PodStopped"] = "pod.stopped";
+  EventType2["PodFailed"] = "pod.failed";
+  EventType2["OrganizationCreated"] = "organization.created";
+  EventType2["OrganizationUpdated"] = "organization.updated";
+  EventType2["OrganizationArchived"] = "organization.archived";
+  EventType2["OrganizationMemberAdded"] = "organization.member_added";
+  EventType2["OrganizationMemberRemoved"] = "organization.member_removed";
+  EventType2["WorkspaceCreated"] = "workspace.created";
+  EventType2["WorkspaceUpdated"] = "workspace.updated";
+  EventType2["WorkspaceArchived"] = "workspace.archived";
+  EventType2["CredentialCreated"] = "credential.created";
+  EventType2["CredentialRevoked"] = "credential.revoked";
+  EventType2["CredentialExpired"] = "credential.expired";
+  EventType2["PolicyCreated"] = "policy.created";
+  EventType2["PolicyUpdated"] = "policy.updated";
+  EventType2["PolicyDeleted"] = "policy.deleted";
+  EventType2["UserSuspended"] = "user.suspended";
+  EventType2["UserReactivated"] = "user.reactivated";
+  return EventType2;
+})(EventType || {});
+
+exports.EventService = EventService;
+exports.EventType = EventType;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/events/service.ts","../../src/events/types.ts"],"names":["EventType"],"mappings":";;;AA8BO,IAAM,eAAN,MAAmB;AAAA,EACP,IAAA;AAAA,EACA,SAAA,uBAGT,GAAA,EAAI;AAAA,EAEZ,YAAY,IAAA,EAAkB;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAA,CACE,MAAA,EACA,OAAA,EACA,KAAA,GAA0B,EAAC,EACb;AACd,IAAA,MAAM,GAAA,0BAAa,cAAc,CAAA;AACjC,IAAA,IAAA,CAAK,UAAU,GAAA,CAAI,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAS,CAAA;AAE3C,IAAA,OAAO;AAAA,MACL,aAAa,MAAM;AACjB,QAAA,IAAA,CAAK,SAAA,CAAU,OAAO,GAAG,CAAA;AAAA,MAC3B;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,KAAA,EAAwB;AAC/B,IAAA,KAAA,MAAW,EAAE,MAAA,EAAQ,OAAA,MAAa,IAAA,CAAK,SAAA,CAAU,QAAO,EAAG;AACzD,MAAA,IAAI,IAAA,CAAK,aAAA,CAAc,KAAA,EAAO,MAAM,CAAA,EAAG;AACrC,QAAA,IAAI;AACF,UAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,QACf,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAA,CACJ,IAAA,GAA4B,IAC5B,WAAA,EACmC;AACnC,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAW,MAAA,CAAO,IAAI,OAAA,EAAS,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AACpE,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW,MAAA,CAAO,IAAI,QAAA,EAAU,MAAA,CAAO,IAAA,CAAK,MAAM,CAAC,CAAA;AACvE,IAAA,IAAI,KAAK,cAAA,KAAmB,MAAA;AAC1B,MAAA,MAAA,CAAO,GAAA,CAAI,gBAAA,EAAkB,IAAA,CAAK,cAAc,CAAA;AAClD,IAAA,IAAI,KAAK,WAAA,KAAgB,MAAA;AACvB,MAAA,MAAA,CAAO,GAAA,CAAI,aAAA,EAAe,IAAA,CAAK,WAAW,CAAA;AAC5C,IAAA,IAAI,KAAK,YAAA,KAAiB,MAAA;AACxB,MAAA,MAAA,CAAO,GAAA,CAAI,cAAA,EAAgB,IAAA,CAAK,YAAY,CAAA;AAC9C,IAAA,IAAI,KAAK,UAAA,KAAe,MAAA;AACtB,MAAA,MAAA,CAAO,GAAA,CAAI,YAAA,EAAc,IAAA,CAAK,UAAU,CAAA;AAC1C,IAAA,IAAI,KAAK,KAAA,KAAU,MAAA,SAAkB,GAAA,CAAI,OAAA,EAAS,KAAK,KAAK,CAAA;AAC5D,IAAA,IAAI,KAAK,KAAA,KAAU,MAAA,SAAkB,GAAA,CAAI,OAAA,EAAS,KAAK,KAAK,CAAA;AAC5D,IAAA,IAAI,IAAA,CAAK,KAAA,IAAS,IAAA,CAAK,KAAA,CAAM,SAAS,CAAA,EAAG;AACvC,MAAA,MAAA,CAAO,IAAI,OAAA,EAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAC,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,EAAA,GAAK,OAAO,QAAA,EAAS;AAC3B,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,cAAA,EAAiB,EAAA,GAAK,CAAA,CAAA,EAAI,EAAE,KAAK,EAAE,CAAA,CAAA;AAAA,MACnC;AAAA,KACF;AAAA,EACF;AAAA,EAEQ,aAAA,CAAc,OAAkB,MAAA,EAA8B;AACpE,IAAA,IACE,MAAA,CAAO,cAAA,IACP,KAAA,CAAM,cAAA,KAAmB,MAAA,CAAO,cAAA;AAEhC,MAAA,OAAO,KAAA;AACT,IAAA,IAAI,MAAA,CAAO,WAAA,IAAe,KAAA,CAAM,WAAA,KAAgB,MAAA,CAAO,WAAA;AACrD,MAAA,OAAO,KAAA;AACT,IAAA,IAAI,MAAA,CAAO,YAAA,IAAgB,KAAA,CAAM,YAAA,KAAiB,MAAA,CAAO,YAAA;AACvD,MAAA,OAAO,KAAA;AACT,IAAA,IAAI,MAAA,CAAO,UAAA,IAAc,KAAA,CAAM,UAAA,KAAe,MAAA,CAAO,UAAA;AACnD,MAAA,OAAO,KAAA;AACT,IAAA,IAAI,MAAA,CAAO,KAAA,IAAS,MAAA,CAAO,KAAA,CAAM,SAAS,CAAA,EAAG;AAC3C,MAAA,IAAI,CAAC,MAAA,CAAO,KAAA,CAAM,SAAS,KAAA,CAAM,IAAI,GAAG,OAAO,KAAA;AAAA,IACjD;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACF;;;ACvHO,IAAK,SAAA,qBAAAA,UAAAA,KAAL;AAEL,EAAAA,WAAA,YAAA,CAAA,GAAa,aAAA;AACb,EAAAA,WAAA,YAAA,CAAA,GAAa,aAAA;AACb,EAAAA,WAAA,YAAA,CAAA,GAAa,aAAA;AACb,EAAAA,WAAA,kBAAA,CAAA,GAAmB,oBAAA;AACnB,EAAAA,WAAA,YAAA,CAAA,GAAa,aAAA;AACb,EAAAA,WAAA,YAAA,CAAA,GAAa,aAAA;AACb,EAAAA,WAAA,WAAA,CAAA,GAAY,YAAA;AAEZ,EAAAA,WAAA,qBAAA,CAAA,GAAsB,sBAAA;AACtB,EAAAA,WAAA,qBAAA,CAAA,GAAsB,sBAAA;AACtB,EAAAA,WAAA,sBAAA,CAAA,GAAuB,uBAAA;AACvB,EAAAA,WAAA,yBAAA,CAAA,GAA0B,2BAAA;AAC1B,EAAAA,WAAA,2BAAA,CAAA,GAA4B,6BAAA;AAE5B,EAAAA,WAAA,kBAAA,CAAA,GAAmB,mBAAA;AACnB,EAAAA,WAAA,kBAAA,CAAA,GAAmB,mBAAA;AACnB,EAAAA,WAAA,mBAAA,CAAA,GAAoB,oBAAA;AAEpB,EAAAA,WAAA,mBAAA,CAAA,GAAoB,oBAAA;AACpB,EAAAA,WAAA,mBAAA,CAAA,GAAoB,oBAAA;AACpB,EAAAA,WAAA,mBAAA,CAAA,GAAoB,oBAAA;AAEpB,EAAAA,WAAA,eAAA,CAAA,GAAgB,gBAAA;AAChB,EAAAA,WAAA,eAAA,CAAA,GAAgB,gBAAA;AAChB,EAAAA,WAAA,eAAA,CAAA,GAAgB,gBAAA;AAEhB,EAAAA,WAAA,eAAA,CAAA,GAAgB,gBAAA;AAChB,EAAAA,WAAA,iBAAA,CAAA,GAAkB,kBAAA;AA7BR,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA","file":"index.js","sourcesContent":["import type { HttpClient } from \"../http/client.js\";\nimport type { ApiResponse, RequestOptions } from \"../types/index.js\";\nimport type {\n  CpodEvent,\n  EventFilter,\n  EventHandler,\n  EventHistoryOptions,\n  SubscribeOptions,\n  Subscription,\n} from \"./types.js\";\n\n/**\n * Manages event subscriptions and history for cPod resources.\n *\n * Subscriptions use a poll-based EventEmitter-like pattern over the REST API.\n * For real-time SSE, the server must expose a `/api/v1/events/stream` endpoint.\n *\n * @example\n * ```typescript\n * const sub = client.events.subscribe(\n *   { organizationId: \"b2c3d4e5-...\", types: [\"pod.failed\"] },\n *   (event) => {\n *     console.log(\"Pod failed:\", event.resourceId, event.payload);\n *   }\n * );\n *\n * // Later, stop receiving events:\n * sub.unsubscribe();\n * ```\n */\nexport class EventService {\n  private readonly http: HttpClient;\n  private readonly listeners: Map<\n    symbol,\n    { filter: EventFilter; handler: EventHandler }\n  > = new Map();\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  /**\n   * Subscribe to events matching the given filter.\n   * The handler is called for each matching event received.\n   *\n   * Returns a Subscription handle — call `.unsubscribe()` to stop.\n   */\n  subscribe(\n    filter: EventFilter,\n    handler: EventHandler,\n    _opts: SubscribeOptions = {}\n  ): Subscription {\n    const key = Symbol(\"subscription\");\n    this.listeners.set(key, { filter, handler });\n\n    return {\n      unsubscribe: () => {\n        this.listeners.delete(key);\n      },\n    };\n  }\n\n  /**\n   * Dispatch a raw event object to all matching subscribers.\n   * Typically called internally when processing SSE or webhook payloads.\n   */\n  dispatch(event: CpodEvent): void {\n    for (const { filter, handler } of this.listeners.values()) {\n      if (this.matchesFilter(event, filter)) {\n        try {\n          handler(event);\n        } catch {\n          // Individual handler errors must not interrupt other handlers.\n        }\n      }\n    }\n  }\n\n  /**\n   * Retrieve historical events from the API.\n   */\n  async getHistory(\n    opts: EventHistoryOptions = {},\n    requestOpts?: RequestOptions\n  ): Promise<ApiResponse<CpodEvent[]>> {\n    const params = new URLSearchParams();\n    if (opts.limit !== undefined) params.set(\"limit\", String(opts.limit));\n    if (opts.offset !== undefined) params.set(\"offset\", String(opts.offset));\n    if (opts.organizationId !== undefined)\n      params.set(\"organizationId\", opts.organizationId);\n    if (opts.workspaceId !== undefined)\n      params.set(\"workspaceId\", opts.workspaceId);\n    if (opts.resourceType !== undefined)\n      params.set(\"resourceType\", opts.resourceType);\n    if (opts.resourceId !== undefined)\n      params.set(\"resourceId\", opts.resourceId);\n    if (opts.since !== undefined) params.set(\"since\", opts.since);\n    if (opts.until !== undefined) params.set(\"until\", opts.until);\n    if (opts.types && opts.types.length > 0) {\n      params.set(\"types\", opts.types.join(\",\"));\n    }\n\n    const qs = params.toString();\n    return this.http.get<ApiResponse<CpodEvent[]>>(\n      `/api/v1/events${qs ? `?${qs}` : \"\"}`,\n      requestOpts\n    );\n  }\n\n  private matchesFilter(event: CpodEvent, filter: EventFilter): boolean {\n    if (\n      filter.organizationId &&\n      event.organizationId !== filter.organizationId\n    )\n      return false;\n    if (filter.workspaceId && event.workspaceId !== filter.workspaceId)\n      return false;\n    if (filter.resourceType && event.resourceType !== filter.resourceType)\n      return false;\n    if (filter.resourceId && event.resourceId !== filter.resourceId)\n      return false;\n    if (filter.types && filter.types.length > 0) {\n      if (!filter.types.includes(event.type)) return false;\n    }\n    return true;\n  }\n}\n","import type { PaginationOptions } from \"../types/index.js\";\n\n/**\n * Well-known event type strings emitted by the cPod platform.\n * Additional event types may be emitted for enterprise features — use string\n * literals for those until they are added to this enum.\n */\nexport enum EventType {\n  // Pod lifecycle events\n  PodCreated = \"pod.created\",\n  PodUpdated = \"pod.updated\",\n  PodDeleted = \"pod.deleted\",\n  PodStatusChanged = \"pod.status_changed\",\n  PodStarted = \"pod.started\",\n  PodStopped = \"pod.stopped\",\n  PodFailed = \"pod.failed\",\n  // Organization events\n  OrganizationCreated = \"organization.created\",\n  OrganizationUpdated = \"organization.updated\",\n  OrganizationArchived = \"organization.archived\",\n  OrganizationMemberAdded = \"organization.member_added\",\n  OrganizationMemberRemoved = \"organization.member_removed\",\n  // Workspace events\n  WorkspaceCreated = \"workspace.created\",\n  WorkspaceUpdated = \"workspace.updated\",\n  WorkspaceArchived = \"workspace.archived\",\n  // Credential events\n  CredentialCreated = \"credential.created\",\n  CredentialRevoked = \"credential.revoked\",\n  CredentialExpired = \"credential.expired\",\n  // Policy events\n  PolicyCreated = \"policy.created\",\n  PolicyUpdated = \"policy.updated\",\n  PolicyDeleted = \"policy.deleted\",\n  // User events\n  UserSuspended = \"user.suspended\",\n  UserReactivated = \"user.reactivated\",\n}\n\n/** A platform event delivered to subscribers or returned from event history. */\nexport interface CpodEvent {\n  /** Unique event identifier (UUID). */\n  id: string;\n  /** Dot-notation event type (e.g., 'pod.created', 'credential.revoked'). */\n  type: EventType | string;\n  /** UUID of the Organization in whose context this event occurred. */\n  organizationId: string;\n  /** UUID of the Workspace, if this event is workspace-scoped. */\n  workspaceId?: string;\n  /** UUID of the specific resource affected. */\n  resourceId: string;\n  /** Entity type of the resource (e.g., 'Pod', 'Credential'). */\n  resourceType: string;\n  /** Event-specific payload. Shape varies by event type. */\n  payload: Record<string, unknown>;\n  /** ISO 8601 timestamp of when the event occurred. */\n  timestamp: string;\n  /** Schema version of the payload (e.g., '1.0'). */\n  version: string;\n}\n\n/** Filter criteria for event subscriptions and history queries. */\nexport interface EventFilter {\n  /** Filter to events in a specific Organization. */\n  organizationId?: string;\n  /** Filter to events in a specific Workspace. */\n  workspaceId?: string;\n  /** Filter to events affecting a specific resource type. */\n  resourceType?: string;\n  /** Filter to events affecting a specific resource UUID. */\n  resourceId?: string;\n  /** Filter to specific event types. */\n  types?: Array<EventType | string>;\n}\n\n/** Options for subscribing to real-time events. */\nexport interface SubscribeOptions {\n  /** Replay events that occurred after this ISO 8601 timestamp. */\n  since?: string;\n}\n\n/** Options for querying historical events. */\nexport interface EventHistoryOptions extends PaginationOptions {\n  /** Filter to a specific Organization. */\n  organizationId?: string;\n  /** Filter to a specific Workspace. */\n  workspaceId?: string;\n  /** Filter to events affecting a specific resource type. */\n  resourceType?: string;\n  /** Filter to events affecting a specific resource UUID. */\n  resourceId?: string;\n  /** Filter to specific event types. */\n  types?: Array<EventType | string>;\n  /** Return only events after this ISO 8601 timestamp. */\n  since?: string;\n  /** Return only events before this ISO 8601 timestamp. */\n  until?: string;\n}\n\n/** Callback invoked when a matching event is received. */\nexport type EventHandler = (event: CpodEvent) => void;\n\n/** Handle returned by `EventService.subscribe()`. */\nexport interface Subscription {\n  /** Stop receiving events for this subscription. */\n  unsubscribe(): void;\n}\n"]}

package/dist/events/index.mjs

@@ -0,0 +1,109 @@
+// src/events/service.ts
+var EventService = class {
+  http;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Subscribe to events matching the given filter.
+   * The handler is called for each matching event received.
+   *
+   * Returns a Subscription handle — call `.unsubscribe()` to stop.
+   */
+  subscribe(filter, handler, _opts = {}) {
+    const key = /* @__PURE__ */ Symbol("subscription");
+    this.listeners.set(key, { filter, handler });
+    return {
+      unsubscribe: () => {
+        this.listeners.delete(key);
+      }
+    };
+  }
+  /**
+   * Dispatch a raw event object to all matching subscribers.
+   * Typically called internally when processing SSE or webhook payloads.
+   */
+  dispatch(event) {
+    for (const { filter, handler } of this.listeners.values()) {
+      if (this.matchesFilter(event, filter)) {
+        try {
+          handler(event);
+        } catch {
+        }
+      }
+    }
+  }
+  /**
+   * Retrieve historical events from the API.
+   */
+  async getHistory(opts = {}, requestOpts) {
+    const params = new URLSearchParams();
+    if (opts.limit !== void 0) params.set("limit", String(opts.limit));
+    if (opts.offset !== void 0) params.set("offset", String(opts.offset));
+    if (opts.organizationId !== void 0)
+      params.set("organizationId", opts.organizationId);
+    if (opts.workspaceId !== void 0)
+      params.set("workspaceId", opts.workspaceId);
+    if (opts.resourceType !== void 0)
+      params.set("resourceType", opts.resourceType);
+    if (opts.resourceId !== void 0)
+      params.set("resourceId", opts.resourceId);
+    if (opts.since !== void 0) params.set("since", opts.since);
+    if (opts.until !== void 0) params.set("until", opts.until);
+    if (opts.types && opts.types.length > 0) {
+      params.set("types", opts.types.join(","));
+    }
+    const qs = params.toString();
+    return this.http.get(
+      `/api/v1/events${qs ? `?${qs}` : ""}`,
+      requestOpts
+    );
+  }
+  matchesFilter(event, filter) {
+    if (filter.organizationId && event.organizationId !== filter.organizationId)
+      return false;
+    if (filter.workspaceId && event.workspaceId !== filter.workspaceId)
+      return false;
+    if (filter.resourceType && event.resourceType !== filter.resourceType)
+      return false;
+    if (filter.resourceId && event.resourceId !== filter.resourceId)
+      return false;
+    if (filter.types && filter.types.length > 0) {
+      if (!filter.types.includes(event.type)) return false;
+    }
+    return true;
+  }
+};
+
+// src/events/types.ts
+var EventType = /* @__PURE__ */ ((EventType2) => {
+  EventType2["PodCreated"] = "pod.created";
+  EventType2["PodUpdated"] = "pod.updated";
+  EventType2["PodDeleted"] = "pod.deleted";
+  EventType2["PodStatusChanged"] = "pod.status_changed";
+  EventType2["PodStarted"] = "pod.started";
+  EventType2["PodStopped"] = "pod.stopped";
+  EventType2["PodFailed"] = "pod.failed";
+  EventType2["OrganizationCreated"] = "organization.created";
+  EventType2["OrganizationUpdated"] = "organization.updated";
+  EventType2["OrganizationArchived"] = "organization.archived";
+  EventType2["OrganizationMemberAdded"] = "organization.member_added";
+  EventType2["OrganizationMemberRemoved"] = "organization.member_removed";
+  EventType2["WorkspaceCreated"] = "workspace.created";
+  EventType2["WorkspaceUpdated"] = "workspace.updated";
+  EventType2["WorkspaceArchived"] = "workspace.archived";
+  EventType2["CredentialCreated"] = "credential.created";
+  EventType2["CredentialRevoked"] = "credential.revoked";
+  EventType2["CredentialExpired"] = "credential.expired";
+  EventType2["PolicyCreated"] = "policy.created";
+  EventType2["PolicyUpdated"] = "policy.updated";
+  EventType2["PolicyDeleted"] = "policy.deleted";
+  EventType2["UserSuspended"] = "user.suspended";
+  EventType2["UserReactivated"] = "user.reactivated";
+  return EventType2;
+})(EventType || {});
+
+export { EventService, EventType };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/events/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/events/service.ts","../../src/events/types.ts"],"names":["EventType"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { HttpClient } from \"../http/client.js\";\nimport type { ApiResponse, RequestOptions } from \"../types/index.js\";\nimport type {\n  CpodEvent,\n  EventFilter,\n  EventHandler,\n  EventHistoryOptions,\n  SubscribeOptions,\n  Subscription,\n} from \"./types.js\";\n\n/**\n * Manages event subscriptions and history for cPod resources.\n *\n * Subscriptions use a poll-based EventEmitter-like pattern over the REST API.\n * For real-time SSE, the server must expose a `/api/v1/events/stream` endpoint.\n *\n * @example\n * ```typescript\n * const sub = client.events.subscribe(\n *   { organizationId: \"b2c3d4e5-...\", types: [\"pod.failed\"] },\n *   (event) => {\n *     console.log(\"Pod failed:\", event.resourceId, event.payload);\n *   }\n * );\n *\n * // Later, stop receiving events:\n * sub.unsubscribe();\n * ```\n */\nexport class EventService {\n  private readonly http: HttpClient;\n  private readonly listeners: Map<\n    symbol,\n    { filter: EventFilter; handler: EventHandler }\n  > = new Map();\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  /**\n   * Subscribe to events matching the given filter.\n   * The handler is called for each matching event received.\n   *\n   * Returns a Subscription handle — call `.unsubscribe()` to stop.\n   */\n  subscribe(\n    filter: EventFilter,\n    handler: EventHandler,\n    _opts: SubscribeOptions = {}\n  ): Subscription {\n    const key = Symbol(\"subscription\");\n    this.listeners.set(key, { filter, handler });\n\n    return {\n      unsubscribe: () => {\n        this.listeners.delete(key);\n      },\n    };\n  }\n\n  /**\n   * Dispatch a raw event object to all matching subscribers.\n   * Typically called internally when processing SSE or webhook payloads.\n   */\n  dispatch(event: CpodEvent): void {\n    for (const { filter, handler } of this.listeners.values()) {\n      if (this.matchesFilter(event, filter)) {\n        try {\n          handler(event);\n        } catch {\n          // Individual handler errors must not interrupt other handlers.\n        }\n      }\n    }\n  }\n\n  /**\n   * Retrieve historical events from the API.\n   */\n  async getHistory(\n    opts: EventHistoryOptions = {},\n    requestOpts?: RequestOptions\n  ): Promise<ApiResponse<CpodEvent[]>> {\n    const params = new URLSearchParams();\n    if (opts.limit !== undefined) params.set(\"limit\", String(opts.limit));\n    if (opts.offset !== undefined) params.set(\"offset\", String(opts.offset));\n    if (opts.organizationId !== undefined)\n      params.set(\"organizationId\", opts.organizationId);\n    if (opts.workspaceId !== undefined)\n      params.set(\"workspaceId\", opts.workspaceId);\n    if (opts.resourceType !== undefined)\n      params.set(\"resourceType\", opts.resourceType);\n    if (opts.resourceId !== undefined)\n      params.set(\"resourceId\", opts.resourceId);\n    if (opts.since !== undefined) params.set(\"since\", opts.since);\n    if (opts.until !== undefined) params.set(\"until\", opts.until);\n    if (opts.types && opts.types.length > 0) {\n      params.set(\"types\", opts.types.join(\",\"));\n    }\n\n    const qs = params.toString();\n    return this.http.get<ApiResponse<CpodEvent[]>>(\n      `/api/v1/events${qs ? `?${qs}` : \"\"}`,\n      requestOpts\n    );\n  }\n\n  private matchesFilter(event: CpodEvent, filter: EventFilter): boolean {\n    if (\n      filter.organizationId &&\n      event.organizationId !== filter.organizationId\n    )\n      return false;\n    if (filter.workspaceId && event.workspaceId !== filter.workspaceId)\n      return false;\n    if (filter.resourceType && event.resourceType !== filter.resourceType)\n      return false;\n    if (filter.resourceId && event.resourceId !== filter.resourceId)\n      return false;\n    if (filter.types && filter.types.length > 0) {\n      if (!filter.types.includes(event.type)) return false;\n    }\n    return true;\n  }\n}\n","import type { PaginationOptions } from \"../types/index.js\";\n\n/**\n * Well-known event type strings emitted by the cPod platform.\n * Additional event types may be emitted for enterprise features — use string\n * literals for those until they are added to this enum.\n */\nexport enum EventType {\n  // Pod lifecycle events\n  PodCreated = \"pod.created\",\n  PodUpdated = \"pod.updated\",\n  PodDeleted = \"pod.deleted\",\n  PodStatusChanged = \"pod.status_changed\",\n  PodStarted = \"pod.started\",\n  PodStopped = \"pod.stopped\",\n  PodFailed = \"pod.failed\",\n  // Organization events\n  OrganizationCreated = \"organization.created\",\n  OrganizationUpdated = \"organization.updated\",\n  OrganizationArchived = \"organization.archived\",\n  OrganizationMemberAdded = \"organization.member_added\",\n  OrganizationMemberRemoved = \"organization.member_removed\",\n  // Workspace events\n  WorkspaceCreated = \"workspace.created\",\n  WorkspaceUpdated = \"workspace.updated\",\n  WorkspaceArchived = \"workspace.archived\",\n  // Credential events\n  CredentialCreated = \"credential.created\",\n  CredentialRevoked = \"credential.revoked\",\n  CredentialExpired = \"credential.expired\",\n  // Policy events\n  PolicyCreated = \"policy.created\",\n  PolicyUpdated = \"policy.updated\",\n  PolicyDeleted = \"policy.deleted\",\n  // User events\n  UserSuspended = \"user.suspended\",\n  UserReactivated = \"user.reactivated\",\n}\n\n/** A platform event delivered to subscribers or returned from event history. */\nexport interface CpodEvent {\n  /** Unique event identifier (UUID). */\n  id: string;\n  /** Dot-notation event type (e.g., 'pod.created', 'credential.revoked'). */\n  type: EventType | string;\n  /** UUID of the Organization in whose context this event occurred. */\n  organizationId: string;\n  /** UUID of the Workspace, if this event is workspace-scoped. */\n  workspaceId?: string;\n  /** UUID of the specific resource affected. */\n  resourceId: string;\n  /** Entity type of the resource (e.g., 'Pod', 'Credential'). */\n  resourceType: string;\n  /** Event-specific payload. Shape varies by event type. */\n  payload: Record<string, unknown>;\n  /** ISO 8601 timestamp of when the event occurred. */\n  timestamp: string;\n  /** Schema version of the payload (e.g., '1.0'). */\n  version: string;\n}\n\n/** Filter criteria for event subscriptions and history queries. */\nexport interface EventFilter {\n  /** Filter to events in a specific Organization. */\n  organizationId?: string;\n  /** Filter to events in a specific Workspace. */\n  workspaceId?: string;\n  /** Filter to events affecting a specific resource type. */\n  resourceType?: string;\n  /** Filter to events affecting a specific resource UUID. */\n  resourceId?: string;\n  /** Filter to specific event types. */\n  types?: Array<EventType | string>;\n}\n\n/** Options for subscribing to real-time events. */\nexport interface SubscribeOptions {\n  /** Replay events that occurred after this ISO 8601 timestamp. */\n  since?: string;\n}\n\n/** Options for querying historical events. */\nexport interface EventHistoryOptions extends PaginationOptions {\n  /** Filter to a specific Organization. */\n  organizationId?: string;\n  /** Filter to a specific Workspace. */\n  workspaceId?: string;\n  /** Filter to events affecting a specific resource type. */\n  resourceType?: string;\n  /** Filter to events affecting a specific resource UUID. */\n  resourceId?: string;\n  /** Filter to specific event types. */\n  types?: Array<EventType | string>;\n  /** Return only events after this ISO 8601 timestamp. */\n  since?: string;\n  /** Return only events before this ISO 8601 timestamp. */\n  until?: string;\n}\n\n/** Callback invoked when a matching event is received. */\nexport type EventHandler = (event: CpodEvent) => void;\n\n/** Handle returned by `EventService.subscribe()`. */\nexport interface Subscription {\n  /** Stop receiving events for this subscription. */\n  unsubscribe(): void;\n}\n"]}