@photon-ai/proto 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 Photon AI
+
+Permission is hereby granted,
+free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @photon-ai/proto
+
+Generated TypeScript bindings for the public Photon gRPC contracts.
+
+Wraps two proto packages:
+
+- `photon.slack.v1` — Slack runtime contract (`MessageService`, `FileService`, inbound event variants, file metadata).
+- `photon.spectrum.v1` — Cross-channel `RawInboundEvent` envelope.
+
+Generated with [`@bufbuild/protoc-gen-es`](https://github.com/bufbuild/protobuf-es) (`target=js+dts`). Ships schemas + service descriptors only — pair with [`@connectrpc/connect-node`](https://www.npmjs.com/package/@connectrpc/connect-node), [`@connectrpc/connect-web`](https://www.npmjs.com/package/@connectrpc/connect-web), or [`@grpc/grpc-js`](https://www.npmjs.com/package/@grpc/grpc-js) for the transport layer.
+
+## Install
+
+```sh
+npm install @photon-ai/proto
+```
+
+## Usage
+
+```ts
+import { create } from "@bufbuild/protobuf";
+import { InboundMessageSchema } from "@photon-ai/proto/photon/slack/v1/common_pb";
+
+const msg = create(InboundMessageSchema, {
+  channel: "C012345",
+  user: "U67890",
+  text: "hello",
+});
+```
+
+## Source
+
+Definitions live in [`photon-hq/spectrum-slack-buf`](https://github.com/photon-hq/spectrum-slack-buf). Releases are cut from `public/v*` git tags.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/gen/photon/slack/v1/common_pb.d.ts

@@ -0,0 +1,329 @@
+// Common message types for the photon.slack.v1 runtime contract.
+//
+// Mirrors photon.whatsapp.v1 in spirit so the spectrum-ts SDK can share its
+// provider-agnostic stream/reconnect/swap machinery (see slack.md "Runtime
+// contract"). When in doubt, prefer Slack semantics over WhatsApp semantics
+// even where it deviates — the SDK adapts.
+
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file photon/slack/v1/common.proto (package photon.slack.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file photon/slack/v1/common.proto.
+ */
+export declare const file_photon_slack_v1_common: GenFile;
+
+/**
+ * Cursor returned with every streamed event and accepted by FetchMissedEvents.
+ * Opaque to clients. Internally encodes (installation_id, sequence) base64url.
+ *
+ * @generated from message photon.slack.v1.StreamCursor
+ */
+export declare type StreamCursor = Message<"photon.slack.v1.StreamCursor"> & {
+  /**
+   * @generated from field: string opaque = 1;
+   */
+  opaque: string;
+};
+
+/**
+ * Describes the message photon.slack.v1.StreamCursor.
+ * Use `create(StreamCursorSchema)` to create a new message.
+ */
+export declare const StreamCursorSchema: GenMessage<StreamCursor>;
+
+/**
+ * Idle keepalive emitted every HEARTBEAT_INTERVAL_MS (default 30 s) on
+ * long-lived streams.
+ *
+ * @generated from message photon.slack.v1.Heartbeat
+ */
+export declare type Heartbeat = Message<"photon.slack.v1.Heartbeat"> & {
+  /**
+   * @generated from field: google.protobuf.Timestamp at = 1;
+   */
+  at?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message photon.slack.v1.Heartbeat.
+ * Use `create(HeartbeatSchema)` to create a new message.
+ */
+export declare const HeartbeatSchema: GenMessage<Heartbeat>;
+
+/**
+ * A message posted to a channel, group, DM, or thread.
+ *
+ * @generated from message photon.slack.v1.InboundMessage
+ */
+export declare type InboundMessage = Message<"photon.slack.v1.InboundMessage"> & {
+  /**
+   * @generated from field: string channel = 1;
+   */
+  channel: string;
+
+  /**
+   * @generated from field: string user = 2;
+   */
+  user: string;
+
+  /**
+   * @generated from field: string text = 3;
+   */
+  text: string;
+
+  /**
+   * @generated from field: string ts = 4;
+   */
+  ts: string;
+
+  /**
+   * @generated from field: optional string thread_ts = 5;
+   */
+  threadTs?: string | undefined;
+
+  /**
+   * @generated from field: optional string subtype = 6;
+   */
+  subtype?: string | undefined;
+
+  /**
+   * True when `user` is the installed bot's user id. Server-stamped so SDK
+   * consumers can filter self-echo without plumbing bot_user_id themselves.
+   *
+   * @generated from field: bool is_from_me = 7;
+   */
+  isFromMe: boolean;
+
+  /**
+   * @generated from field: repeated photon.slack.v1.File files = 10;
+   */
+  files: File[];
+};
+
+/**
+ * Describes the message photon.slack.v1.InboundMessage.
+ * Use `create(InboundMessageSchema)` to create a new message.
+ */
+export declare const InboundMessageSchema: GenMessage<InboundMessage>;
+
+/**
+ * A reaction (add/remove). `removed=true` for reaction_removed events.
+ *
+ * @generated from message photon.slack.v1.Reaction
+ */
+export declare type Reaction = Message<"photon.slack.v1.Reaction"> & {
+  /**
+   * @generated from field: string user = 1;
+   */
+  user: string;
+
+  /**
+   * @generated from field: string item_channel = 2;
+   */
+  itemChannel: string;
+
+  /**
+   * @generated from field: string item_ts = 3;
+   */
+  itemTs: string;
+
+  /**
+   * @generated from field: string name = 4;
+   */
+  name: string;
+
+  /**
+   * @generated from field: bool removed = 5;
+   */
+  removed: boolean;
+
+  /**
+   * True when the reactor is the installed bot's user id.
+   *
+   * @generated from field: bool is_from_me = 6;
+   */
+  isFromMe: boolean;
+};
+
+/**
+ * Describes the message photon.slack.v1.Reaction.
+ * Use `create(ReactionSchema)` to create a new message.
+ */
+export declare const ReactionSchema: GenMessage<Reaction>;
+
+/**
+ * User clicked a Block Kit element / submitted a view / etc.
+ *
+ * @generated from message photon.slack.v1.InteractiveCallback
+ */
+export declare type InteractiveCallback = Message<"photon.slack.v1.InteractiveCallback"> & {
+  /**
+   * block_actions | view_submission | shortcut | message_action ...
+   *
+   * @generated from field: string type = 1;
+   */
+  type: string;
+
+  /**
+   * @generated from field: string user = 2;
+   */
+  user: string;
+
+  /**
+   * True when the actor is the installed bot's user id. Almost always false
+   * in practice — Slack doesn't deliver bot-originated interactives — but
+   * present for symmetry with other event payloads.
+   *
+   * @generated from field: bool is_from_me = 3;
+   */
+  isFromMe: boolean;
+
+  /**
+   * JSON payload as Slack delivered it. Clients decode at their leisure.
+   *
+   * @generated from field: string raw_payload_json = 10;
+   */
+  rawPayloadJson: string;
+};
+
+/**
+ * Describes the message photon.slack.v1.InteractiveCallback.
+ * Use `create(InteractiveCallbackSchema)` to create a new message.
+ */
+export declare const InteractiveCallbackSchema: GenMessage<InteractiveCallback>;
+
+/**
+ * Slash command.
+ *
+ * @generated from message photon.slack.v1.SlashCommand
+ */
+export declare type SlashCommand = Message<"photon.slack.v1.SlashCommand"> & {
+  /**
+   * @generated from field: string command = 1;
+   */
+  command: string;
+
+  /**
+   * @generated from field: string text = 2;
+   */
+  text: string;
+
+  /**
+   * @generated from field: string user = 3;
+   */
+  user: string;
+
+  /**
+   * @generated from field: string channel = 4;
+   */
+  channel: string;
+
+  /**
+   * @generated from field: string response_url = 5;
+   */
+  responseUrl: string;
+
+  /**
+   * @generated from field: string trigger_id = 6;
+   */
+  triggerId: string;
+
+  /**
+   * True when the invoker is the installed bot's user id. Almost always
+   * false — slash commands are user-driven — present for symmetry.
+   *
+   * @generated from field: bool is_from_me = 7;
+   */
+  isFromMe: boolean;
+};
+
+/**
+ * Describes the message photon.slack.v1.SlashCommand.
+ * Use `create(SlashCommandSchema)` to create a new message.
+ */
+export declare const SlashCommandSchema: GenMessage<SlashCommand>;
+
+/**
+ * @-mention of the app.
+ *
+ * @generated from message photon.slack.v1.AppMention
+ */
+export declare type AppMention = Message<"photon.slack.v1.AppMention"> & {
+  /**
+   * @generated from field: string channel = 1;
+   */
+  channel: string;
+
+  /**
+   * @generated from field: string user = 2;
+   */
+  user: string;
+
+  /**
+   * @generated from field: string text = 3;
+   */
+  text: string;
+
+  /**
+   * @generated from field: string ts = 4;
+   */
+  ts: string;
+
+  /**
+   * True when `user` is the installed bot's user id.
+   *
+   * @generated from field: bool is_from_me = 5;
+   */
+  isFromMe: boolean;
+};
+
+/**
+ * Describes the message photon.slack.v1.AppMention.
+ * Use `create(AppMentionSchema)` to create a new message.
+ */
+export declare const AppMentionSchema: GenMessage<AppMention>;
+
+/**
+ * File metadata referenced from InboundMessage or returned by FileService.
+ *
+ * @generated from message photon.slack.v1.File
+ */
+export declare type File = Message<"photon.slack.v1.File"> & {
+  /**
+   * @generated from field: string id = 1;
+   */
+  id: string;
+
+  /**
+   * @generated from field: string name = 2;
+   */
+  name: string;
+
+  /**
+   * @generated from field: string mimetype = 3;
+   */
+  mimetype: string;
+
+  /**
+   * @generated from field: int64 size = 4;
+   */
+  size: bigint;
+
+  /**
+   * @generated from field: string url_private = 5;
+   */
+  urlPrivate: string;
+};
+
+/**
+ * Describes the message photon.slack.v1.File.
+ * Use `create(FileSchema)` to create a new message.
+ */
+export declare const FileSchema: GenMessage<File>;
+

package/gen/photon/slack/v1/common_pb.js

@@ -0,0 +1,76 @@
+// Common message types for the photon.slack.v1 runtime contract.
+//
+// Mirrors photon.whatsapp.v1 in spirit so the spectrum-ts SDK can share its
+// provider-agnostic stream/reconnect/swap machinery (see slack.md "Runtime
+// contract"). When in doubt, prefer Slack semantics over WhatsApp semantics
+// even where it deviates — the SDK adapts.
+
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file photon/slack/v1/common.proto (package photon.slack.v1, syntax proto3)
+/* eslint-disable */
+
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file photon/slack/v1/common.proto.
+ */
+export const file_photon_slack_v1_common = /*@__PURE__*/
+  fileDesc("ChxwaG90b24vc2xhY2svdjEvY29tbW9uLnByb3RvEg9waG90b24uc2xhY2sudjEiHgoMU3RyZWFtQ3Vyc29yEg4KBm9wYXF1ZRgBIAEoCSIzCglIZWFydGJlYXQSJgoCYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIssBCg5JbmJvdW5kTWVzc2FnZRIPCgdjaGFubmVsGAEgASgJEgwKBHVzZXIYAiABKAkSDAoEdGV4dBgDIAEoCRIKCgJ0cxgEIAEoCRIWCgl0aHJlYWRfdHMYBSABKAlIAIgBARIUCgdzdWJ0eXBlGAYgASgJSAGIAQESEgoKaXNfZnJvbV9tZRgHIAEoCBIkCgVmaWxlcxgKIAMoCzIVLnBob3Rvbi5zbGFjay52MS5GaWxlQgwKCl90aHJlYWRfdHNCCgoIX3N1YnR5cGUicgoIUmVhY3Rpb24SDAoEdXNlchgBIAEoCRIUCgxpdGVtX2NoYW5uZWwYAiABKAkSDwoHaXRlbV90cxgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3JlbW92ZWQYBSABKAgSEgoKaXNfZnJvbV9tZRgGIAEoCCJfChNJbnRlcmFjdGl2ZUNhbGxiYWNrEgwKBHR5cGUYASABKAkSDAoEdXNlchgCIAEoCRISCgppc19mcm9tX21lGAMgASgIEhgKEHJhd19wYXlsb2FkX2pzb24YCiABKAkiigEKDFNsYXNoQ29tbWFuZBIPCgdjb21tYW5kGAEgASgJEgwKBHRleHQYAiABKAkSDAoEdXNlchgDIAEoCRIPCgdjaGFubmVsGAQgASgJEhQKDHJlc3BvbnNlX3VybBgFIAEoCRISCgp0cmlnZ2VyX2lkGAYgASgJEhIKCmlzX2Zyb21fbWUYByABKAgiWQoKQXBwTWVudGlvbhIPCgdjaGFubmVsGAEgASgJEgwKBHVzZXIYAiABKAkSDAoEdGV4dBgDIAEoCRIKCgJ0cxgEIAEoCRISCgppc19mcm9tX21lGAUgASgIIlUKBEZpbGUSCgoCaWQYASABKAkSDAoEbmFtZRgCIAEoCRIQCghtaW1ldHlwZRgDIAEoCRIMCgRzaXplGAQgASgDEhMKC3VybF9wcml2YXRlGAUgASgJYgZwcm90bzM", [file_google_protobuf_timestamp]);
+
+/**
+ * Describes the message photon.slack.v1.StreamCursor.
+ * Use `create(StreamCursorSchema)` to create a new message.
+ */
+export const StreamCursorSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 0);
+
+/**
+ * Describes the message photon.slack.v1.Heartbeat.
+ * Use `create(HeartbeatSchema)` to create a new message.
+ */
+export const HeartbeatSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 1);
+
+/**
+ * Describes the message photon.slack.v1.InboundMessage.
+ * Use `create(InboundMessageSchema)` to create a new message.
+ */
+export const InboundMessageSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 2);
+
+/**
+ * Describes the message photon.slack.v1.Reaction.
+ * Use `create(ReactionSchema)` to create a new message.
+ */
+export const ReactionSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 3);
+
+/**
+ * Describes the message photon.slack.v1.InteractiveCallback.
+ * Use `create(InteractiveCallbackSchema)` to create a new message.
+ */
+export const InteractiveCallbackSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 4);
+
+/**
+ * Describes the message photon.slack.v1.SlashCommand.
+ * Use `create(SlashCommandSchema)` to create a new message.
+ */
+export const SlashCommandSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 5);
+
+/**
+ * Describes the message photon.slack.v1.AppMention.
+ * Use `create(AppMentionSchema)` to create a new message.
+ */
+export const AppMentionSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 6);
+
+/**
+ * Describes the message photon.slack.v1.File.
+ * Use `create(FileSchema)` to create a new message.
+ */
+export const FileSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_common, 7);
+