@pc-nexus/async 0.8.0-next.2

package/index.d.ts

@@ -0,0 +1,3 @@
+export { queue, type QueuePushResult } from "./lib/queue.js";
+export type { ConsumerHandler, QueueTask, QueueConsumer } from "./lib/consumer.js";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/index.js

@@ -0,0 +1 @@
+export { queue } from "./lib/queue.js";

package/lib/consumer.d.ts

@@ -0,0 +1,29 @@
+import type { NexusAppContext } from "@pc-nexus/internal";
+/** 处理该任务的消费者信息 */
+export interface QueueConsumer {
+    /** 消费者 key（manifest `async.consumers[].key`） */
+    key: string;
+    /** 该消费者的并发度：manifest 声明值，未声明时为平台默认值 */
+    concurrency: number;
+}
+/**
+ * 队列消费者收到的任务。
+ *
+ * 投递语义是 at-least-once，handler 必须幂等——去重要用 `task_id`（单条任务）而不是 `job_id`（一次 push 内共享）。
+ */
+export interface QueueTask<T = unknown> {
+    /** 推送时传入的载荷，原样带回 */
+    payload: T;
+    /** 单条任务的标识，幂等去重以它为准 */
+    task_id: string;
+    /** 一次 push 调用的标识，批量推送的多条任务共享 */
+    job_id: string;
+    /** 处理该任务的消费者信息。同一队列有多个消费者时，用它区分当前是哪一个 */
+    consumer: QueueConsumer;
+}
+/**
+ * 队列消费者处理函数。第二个参数直接是任务本身——消费者不是事件，
+ * 不套 `event.payload` 那层包装。
+ */
+export type ConsumerHandler<T = unknown> = (context: NexusAppContext, task: QueueTask<T>) => Promise<void>;
+//# sourceMappingURL=consumer.d.ts.map

package/lib/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/lib/consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC1B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IAClC,oBAAoB;IACpB,OAAO,EAAE,CAAC,CAAC;IACX,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,aAAa,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/lib/consumer.js

@@ -0,0 +1 @@
+export {};

package/lib/queue.d.ts

@@ -0,0 +1,16 @@
+export interface QueuePushResult {
+    /** 服务端生成，一次 push 一个；批量推送时所有任务共享 */
+    jobId: string;
+}
+declare class Queue {
+    /**
+     * 把一条或多条任务推入队列。调用只保证入队，不等待消费者执行。
+     *
+     * @param key 队列名，必须等于 manifest 中某个 `async.queues` 条目的 `key`
+     * @param payload 单条载荷或载荷数组
+     */
+    push<T = unknown>(key: string, payload: T | T[]): Promise<QueuePushResult>;
+}
+export declare const queue: Queue;
+export {};
+//# sourceMappingURL=queue.d.ts.map

package/lib/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/lib/queue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC5B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACjB;AACD,cAAM,KAAK;IACP;;;;;OAKG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAS1F;AAED,eAAO,MAAM,KAAK,OAAc,CAAC"}

package/lib/queue.js

@@ -0,0 +1,19 @@
+import { invoke } from "@pc-nexus/internal";
+class Queue {
+    /**
+     * 把一条或多条任务推入队列。调用只保证入队，不等待消费者执行。
+     *
+     * @param key 队列名，必须等于 manifest 中某个 `async.queues` 条目的 `key`
+     * @param payload 单条载荷或载荷数组
+     */
+    async push(key, payload) {
+        const payloads = Array.isArray(payload) ? payload : [payload];
+        const response = await invoke("async", "queue/push", {
+            queue_key: key,
+            payloads,
+        });
+        const result = (await response.json());
+        return result.value;
+    }
+}
+export const queue = new Queue();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@pc-nexus/async",
+  "version": "0.8.0-next.2",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "pub:alpha": "cd dist && npm publish --access public --tag alpha",
+    "pub": "cd dist && npm publish --access public --tag latest",
+    "pub-next": "cd dist && npm publish --access public --tag next"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atinc/pc-nexus.git"
+  },
+  "author": "",
+  "license": "ISC",
+  "directories": {
+    "test": "test",
+    "lib": "dist"
+  },
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "default": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "@pc-nexus/internal": "0.8.0-next.2"
+  },
+  "devDependencies": {},
+  "peerDependencies": {}
+}