@lantharos/pult 0.9.0 → 0.11.0

package/cli.mjs

@@ -184,7 +184,7 @@ function actionChanges(prefix) {
 }
 //#endregion
 //#region package.json
-var version = "0.9.0";
+var version = "0.11.0";
 //#endregion
 //#region ../protocol/src/checks.ts
 const COLUMNS = [
@@ -294,6 +294,7 @@ function checkManifest(manifest) {
 			message: `${name}.${relation} points at unknown resource "${def.resource}"`
 		});
 		for (const [key, action] of Object.entries(resource.actions)) {
+			if (action.moves) checkMoves(manifest, name, key, action.moves, action.source, problems);
 			const inputs = action.input?.properties ?? {};
 			for (const field of [...Object.keys(action.pick), ...action.choices]) if (!inputs[field]) problems.push({
 				source: action.source,
@@ -356,6 +357,17 @@ function checkManifest(manifest) {
 	}
 	return problems;
 }
+function checkMoves(manifest, resource, key, state, source, problems) {
+	const inboxes = Object.values(manifest.inboxes).filter((inbox) => inbox.resource === resource);
+	if (!inboxes.length) problems.push({
+		source,
+		message: `${resource}.${key} moves items, but no inbox is about ${resource}`
+	});
+	else if (!inboxes.some((inbox) => inbox.states.includes(state))) problems.push({
+		source,
+		message: `${resource}.${key} moves items to "${state}", which no inbox about ${resource} has`
+	});
+}
 function checkSchedule(name, action, problems) {
 	const { cron, timezone } = action.schedule;
 	try {
@@ -561,6 +573,7 @@ function actionDef(source, key, action) {
 		approval: options.approval ?? false,
 		contextual: Boolean(options.when || options.defaults),
 		background: options.background ?? false,
+		moves: options.moves ?? null,
 		pick: options.pick ?? {},
 		choices: Object.keys(options.choices ?? {}),
 		schedule: options.schedule ? schedule(options.schedule) : null

package/index.d.mts

@@ -17,6 +17,7 @@ interface IncomingMessage {
   from: string;
   subject?: string;
   text: string;
+  attachments?: AttachmentBlock[];
 }
 type TriageDecision = {
   type: "state";
@@ -222,6 +223,9 @@ type Block = {
   flag: string;
   state?: FlagState;
 };
+type AttachmentBlock = Extract<Block, {
+  type: "attachment";
+}>;
 //#endregion
 //#region ../protocol/src/manifest.d.ts
 type JsonSchema = {
@@ -258,6 +262,7 @@ interface ActionDef {
   approval: boolean;
   contextual: boolean;
   background: boolean;
+  moves: string | null;
   pick: Record<string, string>;
   choices: string[];
   schedule: Schedule | null;
@@ -498,6 +503,7 @@ interface ActionOptions<R, S> {
   automatable?: boolean;
   approval?: boolean;
   background?: boolean;
+  moves?: string;
   when?: (record: R) => boolean;
   defaults?: (record: R) => Partial<ActionInput<S>>;
   pick?: { [K in keyof ActionInput<S>]?: string; };
@@ -512,7 +518,7 @@ type ScheduleInput = string | {
   cron: string;
   timezone?: string;
 };
-interface StandaloneOptions<S> extends Omit<ActionOptions<null, S>, "when"> {
+interface StandaloneOptions<S> extends Omit<ActionOptions<null, S>, "when" | "moves"> {
   schedule?: ScheduleInput;
 }
 interface Action<R = any, S = any> extends Located, ActionRef {
@@ -960,6 +966,9 @@ interface SendOptions<S extends Schema | undefined, Suggested extends unknown[]
   tags?: string[];
   suggest?: { [K in keyof Suggested]: Suggestion<Suggested[K]>; };
 }
+interface ReceivedMessage extends Omit<IncomingMessage, "attachments"> {
+  attachments?: BlockInput[];
+}
 interface ListenOptions {
   onStatus?: (status: "connected" | "disconnected") => void;
 }
@@ -969,7 +978,7 @@ export declare function createPult<Component extends string = string>({ key, pro
     blocks?: BlockInput[];
     by?: string;
   }) => Promise<void>;
-  receive: (message: IncomingMessage) => Promise<{
+  receive: ({ attachments, ...message }: ReceivedMessage) => Promise<{
     item: string;
   } | null>;
   flag: <T, A>(definition: Flag<T, A>, context?: string | FlagContext<A>) => Promise<T>;
@@ -986,4 +995,4 @@ export declare function createPult<Component extends string = string>({ key, pro
 };
 type Pult = ReturnType<typeof createPult>;
 //#endregion
-export type { Action, ActionContext, ActionOptions, ActionRef, Actor, Block, BlockInput, ButtonInput, Channel, ComponentState, Config, ConfigOptions, Duration, FieldInput, Flag, FlagContext, FlagOptions, Guard, Inbox, InboxOptions, ItemView, ListOptions, ListQuery, ListenOptions, Manifest, Notify, NotifyOptions, OutgoingEmail, Page, PageContext, PageOptions, Project, Pult, PultOptions, Question, Relation, Resource, ResourceOptions, Role, RoleOptions, Rule, SendOptions, SendResult, Space, SpaceOptions, StandaloneOptions, StateChange, Status, StatusOptions, Suggestion, Triage, View, ViewOptions };
+export type { Action, ActionContext, ActionOptions, ActionRef, Actor, Block, BlockInput, ButtonInput, Channel, ComponentState, Config, ConfigOptions, Duration, FieldInput, Flag, FlagContext, FlagOptions, Guard, Inbox, InboxOptions, ItemView, ListOptions, ListQuery, ListenOptions, Manifest, Notify, NotifyOptions, OutgoingEmail, Page, PageContext, PageOptions, Project, Pult, PultOptions, Question, ReceivedMessage, Relation, Resource, ResourceOptions, Role, RoleOptions, Rule, SendOptions, SendResult, Space, SpaceOptions, StandaloneOptions, StateChange, Status, StatusOptions, Suggestion, Triage, View, ViewOptions };

package/index.mjs

@@ -860,9 +860,13 @@ function createPult({ key = env("PULT_KEY"), project, url = env("PULT_URL") ?? "
 			blocks: options.blocks && await upload(options.blocks)
 		});
 	}
-	async function receive(message) {
+	async function receive({ attachments, ...message }) {
+		const incoming = attachments?.length ? {
+			...message,
+			attachments: (await upload(attachments)).filter(isAttachment)
+		} : message;
 		try {
-			return await transport.request("POST", "/v1/messages", message);
+			return await transport.request("POST", "/v1/messages", incoming);
 		} catch (error) {
 			if (error instanceof PultError && error.code === "no_thread") return null;
 			throw error;
@@ -936,6 +940,9 @@ function createPult({ key = env("PULT_KEY"), project, url = env("PULT_URL") ?? "
 		deploy
 	};
 }
+function isAttachment(block) {
+	return block.type === "attachment";
+}
 function signedHeaders(headers) {
 	const timestamp = headers.get(HEADER.timestamp);
 	const nonce = headers.get(HEADER.nonce);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lantharos/pult",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "The other side of your app",
   "license": "MIT",
   "keywords": [
@@ -31,7 +31,7 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "pult": "./cli.mjs"
+    "pult": "cli.mjs"
   },
   "publishConfig": {
     "access": "public"