@gravito/stream 1.0.0-alpha.2

package/dist/orbit-queue/src/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Serialized job payload.
+ */
+export interface SerializedJob {
+    /**
+     * Unique job identifier.
+     */
+    id: string;
+    /**
+     * Serializer type: `'json'` or `'class'`.
+     */
+    type: 'json' | 'class';
+    /**
+     * Serialized data.
+     */
+    data: string;
+    /**
+     * Class name (only for `type === 'class'`).
+     */
+    className?: string;
+    /**
+     * Created timestamp.
+     */
+    createdAt: number;
+    /**
+     * Delay before execution (seconds).
+     */
+    delaySeconds?: number;
+    /**
+     * Current attempt number.
+     */
+    attempts?: number;
+    /**
+     * Maximum attempts.
+     */
+    maxAttempts?: number;
+}
+/**
+ * Topic options (for Kafka, etc.).
+ */
+export interface TopicOptions {
+    /**
+     * Number of partitions.
+     */
+    partitions?: number;
+    /**
+     * Replication factor.
+     */
+    replicationFactor?: number;
+    /**
+     * Additional config.
+     */
+    config?: Record<string, string>;
+}
+/**
+ * Queue connection config.
+ */
+export interface QueueConnectionConfig {
+    /**
+     * Driver type.
+     */
+    driver: 'memory' | 'database' | 'redis' | 'kafka' | 'sqs' | 'rabbitmq' | 'nats';
+    /**
+     * Driver-specific config.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Queue manager config.
+ */
+export interface QueueConfig {
+    /**
+     * Default connection name.
+     */
+    default?: string;
+    /**
+     * Connection configs.
+     */
+    connections?: Record<string, QueueConnectionConfig>;
+    /**
+     * Default serializer type.
+     */
+    defaultSerializer?: 'json' | 'class';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/orbit-queue/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAEtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;IAE/E;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAEnD;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrC"}

package/dist/serializers/ClassNameSerializer.d.ts

@@ -0,0 +1,46 @@
+import type { Job } from '../Job';
+import type { SerializedJob } from '../types';
+import type { JobSerializer } from './JobSerializer';
+/**
+ * Class name serializer (Laravel-style).
+ *
+ * Stores the class name and properties, then recreates an instance at runtime.
+ * This is the recommended serializer because it can restore class instances correctly.
+ *
+ * Requirement: Job classes must be dynamically loadable (by class name).
+ *
+ * @example
+ * ```typescript
+ * const serializer = new ClassNameSerializer()
+ * const serialized = serializer.serialize(new SendEmail('user@example.com'))
+ * // serialized.data contains class name and properties
+ *
+ * const job = serializer.deserialize(serialized)
+ * // job is an instance of SendEmail
+ * ```
+ */
+export declare class ClassNameSerializer implements JobSerializer {
+    /**
+     * Job class registry (for resolving classes by name).
+     */
+    private jobClasses;
+    /**
+     * Register a Job class.
+     * @param jobClass - Job class
+     */
+    register(jobClass: new (...args: unknown[]) => Job): void;
+    /**
+     * Register multiple Job classes.
+     * @param jobClasses - Job class array
+     */
+    registerMany(jobClasses: Array<new (...args: unknown[]) => Job>): void;
+    /**
+     * Serialize a Job.
+     */
+    serialize(job: Job): SerializedJob;
+    /**
+     * Deserialize a Job.
+     */
+    deserialize(serialized: SerializedJob): Job;
+}
+//# sourceMappingURL=ClassNameSerializer.d.ts.map

package/dist/serializers/ClassNameSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassNameSerializer.d.ts","sourceRoot":"","sources":["../../src/serializers/ClassNameSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD;;OAEG;IACH,OAAO,CAAC,UAAU,CAAqD;IAEvE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,GAAG,IAAI;IAIzD;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI;IAMtE;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa;IA8BlC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,GAAG;CAqC5C"}

package/dist/serializers/JobSerializer.d.ts

@@ -0,0 +1,36 @@
+import type { Job } from '../Job';
+import type { SerializedJob } from '../types';
+/**
+ * Job serializer interface.
+ *
+ * Responsible for serializing and deserializing jobs.
+ * Supports multiple strategies (JSON, class-name, etc.).
+ *
+ * @example
+ * ```typescript
+ * class MySerializer implements JobSerializer {
+ *   serialize(job: Job): SerializedJob {
+ *     // serialization logic
+ *   }
+ *
+ *   deserialize(serialized: SerializedJob): Job {
+ *     // deserialization logic
+ *   }
+ * }
+ * ```
+ */
+export interface JobSerializer {
+    /**
+     * Serialize a job.
+     * @param job - Job instance
+     * @returns Serialized job payload
+     */
+    serialize(job: Job): SerializedJob;
+    /**
+     * Deserialize a job.
+     * @param serialized - Serialized job payload
+     * @returns Job instance
+     */
+    deserialize(serialized: SerializedJob): Job;
+}
+//# sourceMappingURL=JobSerializer.d.ts.map

package/dist/serializers/JobSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobSerializer.d.ts","sourceRoot":"","sources":["../../src/serializers/JobSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAA;IAElC;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,GAAG,CAAA;CAC5C"}

package/dist/serializers/JsonSerializer.d.ts

@@ -0,0 +1,32 @@
+import type { Job } from '../Job';
+import type { SerializedJob } from '../types';
+import type { JobSerializer } from './JobSerializer';
+/**
+ * JSON Serializer
+ *
+ * Serializes jobs using JSON.
+ * Suitable for simple scenarios where you only need to persist plain properties.
+ *
+ * Limitation: cannot restore class instances, functions, or complex objects.
+ *
+ * @example
+ * ```typescript
+ * const serializer = new JsonSerializer()
+ * const serialized = serializer.serialize(job)
+ * const job = serializer.deserialize(serialized)
+ * ```
+ */
+export declare class JsonSerializer implements JobSerializer {
+    /**
+     * Serialize a job.
+     */
+    serialize(job: Job): SerializedJob;
+    /**
+     * Deserialize a job.
+     *
+     * Note: this implementation only restores properties and does not recreate class instances.
+     * For class instances, use `ClassNameSerializer`.
+     */
+    deserialize(serialized: SerializedJob): Job;
+}
+//# sourceMappingURL=JsonSerializer.d.ts.map

package/dist/serializers/JsonSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSerializer.d.ts","sourceRoot":"","sources":["../../src/serializers/JsonSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa;IAiBlC;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,GAAG;CAW5C"}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Serialized job payload.
+ */
+export interface SerializedJob {
+    /**
+     * Unique job identifier.
+     */
+    id: string;
+    /**
+     * Serializer type: `'json'` or `'class'`.
+     */
+    type: 'json' | 'class';
+    /**
+     * Serialized data.
+     */
+    data: string;
+    /**
+     * Class name (only for `type === 'class'`).
+     */
+    className?: string;
+    /**
+     * Created timestamp.
+     */
+    createdAt: number;
+    /**
+     * Delay before execution (seconds).
+     */
+    delaySeconds?: number;
+    /**
+     * Current attempt number.
+     */
+    attempts?: number;
+    /**
+     * Maximum attempts.
+     */
+    maxAttempts?: number;
+}
+/**
+ * Topic options (for Kafka, etc.).
+ */
+export interface TopicOptions {
+    /**
+     * Number of partitions.
+     */
+    partitions?: number;
+    /**
+     * Replication factor.
+     */
+    replicationFactor?: number;
+    /**
+     * Additional config.
+     */
+    config?: Record<string, string>;
+}
+/**
+ * Queue connection config.
+ */
+export interface QueueConnectionConfig {
+    /**
+     * Driver type.
+     */
+    driver: 'memory' | 'database' | 'redis' | 'kafka' | 'sqs' | 'rabbitmq' | 'nats';
+    /**
+     * Driver-specific config.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Queue manager config.
+ */
+export interface QueueConfig {
+    /**
+     * Default connection name.
+     */
+    default?: string;
+    /**
+     * Connection configs.
+     */
+    connections?: Record<string, QueueConnectionConfig>;
+    /**
+     * Default serializer type.
+     */
+    defaultSerializer?: 'json' | 'class';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAEtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;IAE/E;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAEnD;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@gravito/stream",
+  "version": "1.0.0-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Lightweight, high-performance queue system for Gravito framework. Supports multiple brokers (Database, Redis, Kafka, SQS) with zero runtime overhead.",
+  "module": "./dist/index.mjs",
+  "main": "./dist/index.cjs",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "gravito",
+    "orbit",
+    "queue",
+    "job",
+    "worker",
+    "kafka",
+    "sqs",
+    "redis"
+  ],
+  "author": "Carl Lee <carllee0520@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@aws-sdk/client-sqs": "^3.955.0",
+    "gravito-core": "1.0.0-beta.2"
+  },
+  "devDependencies": {
+    "@gravito/db": "1.0.0-alpha.2",
+    "bun-types": "latest",
+    "hono": "^4.11.1",
+    "typescript": "^5.9.3"
+  },
+  "homepage": "https://github.com/gravito-framework/gravito#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "packages/stream"
+  }
+}