@mawaru/sdk 0.15.0 → 0.17.0

package/_schemas/graph.ts

@@ -230,6 +230,36 @@ export const graphNodeHookSchema = z.object({
 export type GraphNodeHook = z.infer<typeof graphNodeHookSchema>
 
 // 新規ノードの id・ポートの id もクライアントが採番する（一時IDの解決を不要にする）
+// ノードの表示アイコン：プリセット・絵文字・画像 URL のいずれか一つ。
+// 未設定（省略）＝既定の kind アイコン（docs/tasks/wip/ノードのアイコン（プログラム任意設定・HUMAN担当者の自動表示）.md）。
+// preset は契約上不透明な文字列（承認ビューと同じ方式）：カタログはフロントが
+// 表示時に参照し、無い key は既定グリフへフォールバックする
+export const nodeIconSchema = z.union([
+  z.strictObject({ preset: z.string().min(1) }),
+  // ZWJ 合字の絵文字を許容する長さ（1グリフでも code unit は最大10超になりうる）
+  z.strictObject({ emoji: z.string().min(1).max(16) }),
+  z.strictObject({ image_url: z.url() }),
+])
+export type NodeIcon = z.infer<typeof nodeIconSchema>
+
+// mawaru 提供のプリセットアイコンのカタログ（SVG 実体はフロントに同梱）
+export const NODE_ICON_PRESETS = [
+  { key: "github", name: "GitHub" },
+  { key: "slack", name: "Slack" },
+  { key: "gmail", name: "Gmail" },
+  { key: "google-sheets", name: "Google スプレッドシート" },
+  { key: "google-drive", name: "Google Drive" },
+  { key: "google-analytics", name: "Google Analytics" },
+  { key: "notion", name: "Notion" },
+  { key: "salesforce", name: "Salesforce" },
+  { key: "freee", name: "freee" },
+  { key: "airtable", name: "Airtable" },
+  { key: "stripe", name: "Stripe" },
+  { key: "hubspot", name: "HubSpot" },
+  { key: "sentry", name: "Sentry" },
+] as const
+export type NodeIconPresetKey = (typeof NODE_ICON_PRESETS)[number]["key"]
+
 export const graphNodeSchema = z.object({
   id: z.uuid(),
   kind: graphNodeKindSchema,
@@ -238,6 +268,13 @@ export const graphNodeSchema = z.object({
   hooks: z.array(graphNodeHookSchema).default([]),
   position_x: z.number(),
   position_y: z.number(),
+  // 表示アイコン（全 kind 共通の任意設定。human はフロントが担当から導出するので通常設定しない）
+  icon: nodeIconSchema.optional(),
+  // Slack ビュー（全 kind 共通の任意設定。承認待ち・完了メッセージの見せ方）。
+  // human の view と同じ「不透明なキー」で、実在・可視性の検証は保存時に mawaru 側が行う
+  // （カタログは非公開。@mawaru/common の slack-view.ts）。省略時は従来表示。
+  // ポートの型には一切影響しない
+  slack_view: z.string().min(1).optional(),
   // kind 別設定（自 kind のときだけ意味を持つ。省略時は保存側がデフォルトを補う）
   wait: waitConfigSchema.optional(),
   program: programConfigSchema.optional(),

package/dist/_schemas/graph.d.ts

@@ -78,6 +78,55 @@ export declare const graphNodeHookSchema: z.ZodObject<{
     on_signal: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type GraphNodeHook = z.infer<typeof graphNodeHookSchema>;
+export declare const nodeIconSchema: z.ZodUnion<readonly [z.ZodObject<{
+    preset: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    emoji: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    image_url: z.ZodURL;
+}, z.core.$strict>]>;
+export type NodeIcon = z.infer<typeof nodeIconSchema>;
+export declare const NODE_ICON_PRESETS: readonly [{
+    readonly key: "github";
+    readonly name: "GitHub";
+}, {
+    readonly key: "slack";
+    readonly name: "Slack";
+}, {
+    readonly key: "gmail";
+    readonly name: "Gmail";
+}, {
+    readonly key: "google-sheets";
+    readonly name: "Google スプレッドシート";
+}, {
+    readonly key: "google-drive";
+    readonly name: "Google Drive";
+}, {
+    readonly key: "google-analytics";
+    readonly name: "Google Analytics";
+}, {
+    readonly key: "notion";
+    readonly name: "Notion";
+}, {
+    readonly key: "salesforce";
+    readonly name: "Salesforce";
+}, {
+    readonly key: "freee";
+    readonly name: "freee";
+}, {
+    readonly key: "airtable";
+    readonly name: "Airtable";
+}, {
+    readonly key: "stripe";
+    readonly name: "Stripe";
+}, {
+    readonly key: "hubspot";
+    readonly name: "HubSpot";
+}, {
+    readonly key: "sentry";
+    readonly name: "Sentry";
+}];
+export type NodeIconPresetKey = (typeof NODE_ICON_PRESETS)[number]["key"];
 export declare const graphNodeSchema: z.ZodObject<{
     id: z.ZodUUID;
     kind: z.ZodEnum<{
@@ -117,6 +166,14 @@ export declare const graphNodeSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     position_x: z.ZodNumber;
     position_y: z.ZodNumber;
+    icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        preset: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        emoji: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        image_url: z.ZodURL;
+    }, z.core.$strict>]>>;
+    slack_view: z.ZodOptional<z.ZodString>;
     wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         wait_type: z.ZodLiteral<"duration">;
         duration_seconds: z.ZodNumber;
@@ -209,6 +266,14 @@ export declare const saveGraphBodySchema: z.ZodObject<{
         }, z.core.$strip>>>;
         position_x: z.ZodNumber;
         position_y: z.ZodNumber;
+        icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            preset: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            emoji: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            image_url: z.ZodURL;
+        }, z.core.$strict>]>>;
+        slack_view: z.ZodOptional<z.ZodString>;
         wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             wait_type: z.ZodLiteral<"duration">;
             duration_seconds: z.ZodNumber;

package/dist/_schemas/graph.js

@@ -178,6 +178,32 @@ export const graphNodeHookSchema = z.object({
     on_signal: z.boolean().default(false),
 });
 // 新規ノードの id・ポートの id もクライアントが採番する（一時IDの解決を不要にする）
+// ノードの表示アイコン：プリセット・絵文字・画像 URL のいずれか一つ。
+// 未設定（省略）＝既定の kind アイコン（docs/tasks/wip/ノードのアイコン（プログラム任意設定・HUMAN担当者の自動表示）.md）。
+// preset は契約上不透明な文字列（承認ビューと同じ方式）：カタログはフロントが
+// 表示時に参照し、無い key は既定グリフへフォールバックする
+export const nodeIconSchema = z.union([
+    z.strictObject({ preset: z.string().min(1) }),
+    // ZWJ 合字の絵文字を許容する長さ（1グリフでも code unit は最大10超になりうる）
+    z.strictObject({ emoji: z.string().min(1).max(16) }),
+    z.strictObject({ image_url: z.url() }),
+]);
+// mawaru 提供のプリセットアイコンのカタログ（SVG 実体はフロントに同梱）
+export const NODE_ICON_PRESETS = [
+    { key: "github", name: "GitHub" },
+    { key: "slack", name: "Slack" },
+    { key: "gmail", name: "Gmail" },
+    { key: "google-sheets", name: "Google スプレッドシート" },
+    { key: "google-drive", name: "Google Drive" },
+    { key: "google-analytics", name: "Google Analytics" },
+    { key: "notion", name: "Notion" },
+    { key: "salesforce", name: "Salesforce" },
+    { key: "freee", name: "freee" },
+    { key: "airtable", name: "Airtable" },
+    { key: "stripe", name: "Stripe" },
+    { key: "hubspot", name: "HubSpot" },
+    { key: "sentry", name: "Sentry" },
+];
 export const graphNodeSchema = z.object({
     id: z.uuid(),
     kind: graphNodeKindSchema,
@@ -186,6 +212,13 @@ export const graphNodeSchema = z.object({
     hooks: z.array(graphNodeHookSchema).default([]),
     position_x: z.number(),
     position_y: z.number(),
+    // 表示アイコン（全 kind 共通の任意設定。human はフロントが担当から導出するので通常設定しない）
+    icon: nodeIconSchema.optional(),
+    // Slack ビュー（全 kind 共通の任意設定。承認待ち・完了メッセージの見せ方）。
+    // human の view と同じ「不透明なキー」で、実在・可視性の検証は保存時に mawaru 側が行う
+    // （カタログは非公開。@mawaru/common の slack-view.ts）。省略時は従来表示。
+    // ポートの型には一切影響しない
+    slack_view: z.string().min(1).optional(),
     // kind 別設定（自 kind のときだけ意味を持つ。省略時は保存側がデフォルトを補う）
     wait: waitConfigSchema.optional(),
     program: programConfigSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mawaru/sdk",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "mawaru 実行 repo の開発 SDK。契約スキーマ（config.json 規約・ループ graph API）の正 ＋ typegen / validate CLI",
   "type": "module",
   "bin": {