@pc-nexus/async 0.8.0-next.10

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+# 0.8.0-next.10 (2026-08-27)
+
+# 0.8.0-next.9 (2026-08-25)
+
+# 0.8.0-next.8 (2026-08-14)
+
+# 0.8.0-next.7 (2026-08-12)
+
+# 0.8.0-next.6 (2026-08-07)
+
+### Bug Fixes
+
+- #NEXUS-4058 public SDK 发布配置补上 @pc-nexus/async (#1396) 5b6c4dd, closes #NEXUS-4058 #1396

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,15 @@
+import type { AsyncConsumerHandler, AsyncConsumerInfo, AsyncConsumerTask } from "@pc-nexus/internal";
+/** 处理该任务的消费者信息 */
+export type QueueConsumer = AsyncConsumerInfo;
+/**
+ * 队列消费者收到的任务。
+ *
+ * 投递语义是 at-least-once，handler 必须幂等——去重要用 `task_id`（单条任务）而不是 `job_id`（一次 push 内共享）。
+ */
+export type QueueTask<T = unknown> = AsyncConsumerTask<T>;
+/**
+ * 队列消费者处理函数。第二个参数直接是任务本身——消费者不是事件，
+ * 不套 `event.payload` 那层包装。
+ */
+export type ConsumerHandler<T = unknown> = AsyncConsumerHandler<T>;
+//# 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,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAErG,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC"}

package/lib/consumer.js

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

package/lib/queue.d.ts

@@ -0,0 +1,24 @@
+export interface QueuePushResult {
+    /** 服务端生成，一次 push 一个；批量推送时所有任务共享 */
+    jobId: string;
+}
+export interface QueuePushOptions {
+    /**
+     * 延时投递：入队后至少延迟该秒数才可被消费（延时任务）。
+     * 不传或传 0 表示尽快投递。批量推送时对本次所有任务生效。
+     */
+    delay?: number;
+}
+declare class Queue {
+    /**
+     * 把一条或多条任务推入队列。调用只保证入队，不等待消费者执行。
+     *
+     * @param key 队列名，必须等于 manifest 中某个 `async.queues` 条目的 `key`
+     * @param payload 单条载荷或载荷数组
+     * @param options 可选项；`delay` 指定延时投递的秒数
+     */
+    push<T = unknown>(key: string, payload: T | T[], options?: QueuePushOptions): 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;AAED,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,cAAM,KAAK;IACP;;;;;;OAMG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAUtH;AAED,eAAO,MAAM,KAAK,OAAc,CAAC"}

package/lib/queue.js

@@ -0,0 +1,21 @@
+import { invoke } from "@pc-nexus/internal";
+class Queue {
+    /**
+     * 把一条或多条任务推入队列。调用只保证入队，不等待消费者执行。
+     *
+     * @param key 队列名，必须等于 manifest 中某个 `async.queues` 条目的 `key`
+     * @param payload 单条载荷或载荷数组
+     * @param options 可选项；`delay` 指定延时投递的秒数
+     */
+    async push(key, payload, options) {
+        const payloads = Array.isArray(payload) ? payload : [payload];
+        const response = await invoke("async", "queue/push", {
+            queue_key: key,
+            payloads,
+            delay: options?.delay,
+        });
+        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.10",
+  "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.10"
+  },
+  "devDependencies": {},
+  "peerDependencies": {}
+}