@photon-ai/proto 0.0.0

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

@@ -0,0 +1,93 @@
+// MessageService — the Slack runtime contract for spectrum-ts.
+//
+// See slack.md "Runtime contract (gRPC)" for the full design. Every RPC
+// requires two metadata keys: `access_token` (LightAuth JWT) and `team_id`.
+
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file photon/slack/v1/message_service.proto (package photon.slack.v1, syntax proto3)
+/* eslint-disable */
+
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+
+/**
+ * Describes the file photon/slack/v1/message_service.proto.
+ */
+export const file_photon_slack_v1_message_service = /*@__PURE__*/
+  fileDesc("CiVwaG90b24vc2xhY2svdjEvbWVzc2FnZV9zZXJ2aWNlLnByb3RvEg9waG90b24uc2xhY2sudjEi2gIKElNlbmRNZXNzYWdlUmVxdWVzdBIPCgdjaGFubmVsGAEgASgJEiwKBHRleHQYCiABKAsyHC5waG90b24uc2xhY2sudjEuVGV4dENvbnRlbnRIABIwCgZibG9ja3MYCyABKAsyHi5waG90b24uc2xhY2sudjEuQmxvY2tzQ29udGVudEgAEjoKC2F0dGFjaG1lbnRzGAwgASgLMiMucGhvdG9uLnNsYWNrLnYxLkF0dGFjaG1lbnRzQ29udGVudEgAEjQKCHJlYWN0aW9uGA0gASgLMiAucGhvdG9uLnNsYWNrLnYxLlJlYWN0aW9uQ29udGVudEgAEhYKCXRocmVhZF90cxgeIAEoCUgBiAEBEhwKD3JlcGx5X2Jyb2FkY2FzdBgfIAEoCEgCiAEBQgkKB2NvbnRlbnRCDAoKX3RocmVhZF90c0ISChBfcmVwbHlfYnJvYWRjYXN0IhsKC1RleHRDb250ZW50EgwKBGJvZHkYASABKAkiOwoNQmxvY2tzQ29udGVudBITCgtibG9ja3NfanNvbhgBIAEoCRIVCg1mYWxsYmFja190ZXh0GAIgASgJIjwKEkF0dGFjaG1lbnRzQ29udGVudBIYChBhdHRhY2htZW50c19qc29uGAEgASgJEgwKBHRleHQYAiABKAkiRwoPUmVhY3Rpb25Db250ZW50Eg8KB2l0ZW1fdHMYASABKAkSFAoMaXRlbV9jaGFubmVsGAIgASgJEg0KBWVtb2ppGAMgASgJIjIKE1NlbmRNZXNzYWdlUmVzcG9uc2USCgoCdHMYASABKAkSDwoHY2hhbm5lbBgCIAEoCSIuCg9NYXJrUmVhZFJlcXVlc3QSDwoHY2hhbm5lbBgBIAEoCRIKCgJ0cxgCIAEoCSISChBNYXJrUmVhZFJlc3BvbnNlIg8KDVdob0FtSVJlcXVlc3QiRgoOV2hvQW1JUmVzcG9uc2USEwoLYm90X3VzZXJfaWQYASABKAkSDwoHdGVhbV9pZBgCIAEoCRIOCgZhcHBfaWQYAyABKAkyhgIKDk1lc3NhZ2VTZXJ2aWNlElgKC1NlbmRNZXNzYWdlEiMucGhvdG9uLnNsYWNrLnYxLlNlbmRNZXNzYWdlUmVxdWVzdBokLnBob3Rvbi5zbGFjay52MS5TZW5kTWVzc2FnZVJlc3BvbnNlEk8KCE1hcmtSZWFkEiAucGhvdG9uLnNsYWNrLnYxLk1hcmtSZWFkUmVxdWVzdBohLnBob3Rvbi5zbGFjay52MS5NYXJrUmVhZFJlc3BvbnNlEkkKBldob0FtSRIeLnBob3Rvbi5zbGFjay52MS5XaG9BbUlSZXF1ZXN0Gh8ucGhvdG9uLnNsYWNrLnYxLldob0FtSVJlc3BvbnNlYgZwcm90bzM");
+
+/**
+ * Describes the message photon.slack.v1.SendMessageRequest.
+ * Use `create(SendMessageRequestSchema)` to create a new message.
+ */
+export const SendMessageRequestSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 0);
+
+/**
+ * Describes the message photon.slack.v1.TextContent.
+ * Use `create(TextContentSchema)` to create a new message.
+ */
+export const TextContentSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 1);
+
+/**
+ * Describes the message photon.slack.v1.BlocksContent.
+ * Use `create(BlocksContentSchema)` to create a new message.
+ */
+export const BlocksContentSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 2);
+
+/**
+ * Describes the message photon.slack.v1.AttachmentsContent.
+ * Use `create(AttachmentsContentSchema)` to create a new message.
+ */
+export const AttachmentsContentSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 3);
+
+/**
+ * Describes the message photon.slack.v1.ReactionContent.
+ * Use `create(ReactionContentSchema)` to create a new message.
+ */
+export const ReactionContentSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 4);
+
+/**
+ * Describes the message photon.slack.v1.SendMessageResponse.
+ * Use `create(SendMessageResponseSchema)` to create a new message.
+ */
+export const SendMessageResponseSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 5);
+
+/**
+ * Describes the message photon.slack.v1.MarkReadRequest.
+ * Use `create(MarkReadRequestSchema)` to create a new message.
+ */
+export const MarkReadRequestSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 6);
+
+/**
+ * Describes the message photon.slack.v1.MarkReadResponse.
+ * Use `create(MarkReadResponseSchema)` to create a new message.
+ */
+export const MarkReadResponseSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 7);
+
+/**
+ * Describes the message photon.slack.v1.WhoAmIRequest.
+ * Use `create(WhoAmIRequestSchema)` to create a new message.
+ */
+export const WhoAmIRequestSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 8);
+
+/**
+ * Describes the message photon.slack.v1.WhoAmIResponse.
+ * Use `create(WhoAmIResponseSchema)` to create a new message.
+ */
+export const WhoAmIResponseSchema = /*@__PURE__*/
+  messageDesc(file_photon_slack_v1_message_service, 9);
+
+/**
+ * @generated from service photon.slack.v1.MessageService
+ */
+export const MessageService = /*@__PURE__*/
+  serviceDesc(file_photon_slack_v1_message_service, 0);
+

package/gen/photon/spectrum/v1/inbound_pb.d.ts

@@ -0,0 +1,182 @@
+// Cross-channel envelope for raw inbound events as they enter the Spectrum
+// platform.
+//
+// The design promise is "zero server-side payload normalization": each channel
+// adapter (spectrum-slack, spectrum-whatsapp-business, ...) verifies the
+// channel-specific signature, then publishes the original HTTP body bit-exact
+// inside this envelope onto NATS JetStream subject
+// `inbound.<project_id>.<channel>`. Parsers live SDK-side
+// (`@photon-hq/spectrum-parsers-*`), keeping channel shape knowledge at the
+// edges and letting Spectrum add new channels without touching the routing
+// fabric.
+//
+// `body` is bytes (not a string) so callers can transport any encoding without
+// risk of UTF-8 sanitization; `headers` carries the original signature header
+// (X-Slack-Signature, X-Hub-Signature-256, ...) so consumers that want a
+// second proof-of-origin can verify it themselves.
+
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file photon/spectrum/v1/inbound.proto (package photon.spectrum.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file photon/spectrum/v1/inbound.proto.
+ */
+export declare const file_photon_spectrum_v1_inbound: GenFile;
+
+/**
+ * The minimal envelope every channel adapter agrees on. spectrum-slack
+ * produces it from the verified `POST /slack/events` request;
+ * spectrum-grpc-fanout consumes it from JetStream and re-emits it to SDK
+ * clients verbatim.
+ *
+ * ── Routing + audit metadata. Low field numbers; cheap to skim. ──
+ *
+ * @generated from message photon.spectrum.v1.RawInboundEvent
+ */
+export declare type RawInboundEvent = Message<"photon.spectrum.v1.RawInboundEvent"> & {
+  /**
+   * UUIDv7 set by the publisher. Mirrored to the JetStream message's `Nats-Msg-Id`
+   * header so the broker's duplicate-detection window collapses Slack retries
+   * of the same delivery. SDKs can also use it for end-to-end dedup if they
+   * process the same stream twice.
+   *
+   * @generated from field: string event_id = 1;
+   */
+  eventId: string;
+
+  /**
+   * Project that owns this event. The first dotted segment after `inbound.`
+   * in the NATS subject is derived from this field; consumers filter on it.
+   *
+   * @generated from field: string project_id = 2;
+   */
+  projectId: string;
+
+  /**
+   * Which channel adapter produced the event. Same value the NATS subject's
+   * third segment encodes (`inbound.<project_id>.slack` for CHANNEL_SLACK).
+   *
+   * @generated from field: photon.spectrum.v1.Channel channel = 3;
+   */
+  channel: Channel;
+
+  /**
+   * Wall-clock time the publisher accepted the request. Independent of any
+   * timestamp the channel itself supplied inside `body`.
+   *
+   * @generated from field: google.protobuf.Timestamp received_at = 4;
+   */
+  receivedAt?: Timestamp | undefined;
+
+  /**
+   * Channel-side identifier for the source that produced the event. For
+   * spectrum-slack this is the Slack `api_app_id`; once `webhook_sources`
+   * lands in spectrum-cloud it becomes the `ws_…` source id. Optional from
+   * the SDK's point of view — useful for audit, not for parsing.
+   *
+   * @generated from field: string source_id = 5;
+   */
+  sourceId: string;
+
+  /**
+   * HTTP `Content-Type` of the original request. For Slack: typically
+   * `application/json` for event callbacks, `application/x-www-form-urlencoded`
+   * for interactive callbacks and slash commands.
+   *
+   * @generated from field: string content_type = 10;
+   */
+  contentType: string;
+
+  /**
+   * The raw HTTP body, byte-for-byte as the channel delivered it. NEVER
+   * re-serialized — HMAC verification on the consumer side needs the exact
+   * bytes the channel signed.
+   *
+   * @generated from field: bytes body = 11;
+   */
+  body: Uint8Array;
+
+  /**
+   * Subset of original HTTP request headers the publisher chose to preserve.
+   * Always includes the channel's signature pair (e.g. `X-Slack-Signature`
+   * + `X-Slack-Request-Timestamp`) so a downstream consumer can re-verify if
+   * it wants a second independent check. Casing matches what the channel
+   * sent — do not normalize.
+   *
+   * @generated from field: map<string, string> headers = 12;
+   */
+  headers: { [key: string]: string };
+
+  /**
+   * Path of the original HTTP request (e.g. `/slack/events`). Audit-only;
+   * parsers should not branch on it.
+   *
+   * @generated from field: string source_path = 13;
+   */
+  sourcePath: string;
+
+  /**
+   * HTTP method of the original request (always `POST` today; reserved for
+   * future protocols).
+   *
+   * @generated from field: string http_method = 14;
+   */
+  httpMethod: string;
+};
+
+/**
+ * Describes the message photon.spectrum.v1.RawInboundEvent.
+ * Use `create(RawInboundEventSchema)` to create a new message.
+ */
+export declare const RawInboundEventSchema: GenMessage<RawInboundEvent>;
+
+/**
+ * Wire identifier for the source channel that produced an event. Used as the
+ * third segment of the NATS subject (`inbound.<project_id>.<channel>`) and as
+ * a stable discriminator for SDK-side parsers — adding a new channel reserves
+ * a new enum value rather than introducing a new top-level message.
+ *
+ * @generated from enum photon.spectrum.v1.Channel
+ */
+export enum Channel {
+  /**
+   * @generated from enum value: CHANNEL_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: CHANNEL_SLACK = 1;
+   */
+  SLACK = 1,
+
+  /**
+   * @generated from enum value: CHANNEL_IMESSAGE = 2;
+   */
+  IMESSAGE = 2,
+
+  /**
+   * @generated from enum value: CHANNEL_WHATSAPP_BUSINESS = 3;
+   */
+  WHATSAPP_BUSINESS = 3,
+
+  /**
+   * @generated from enum value: CHANNEL_VOICE = 4;
+   */
+  VOICE = 4,
+
+  /**
+   * @generated from enum value: CHANNEL_SIP = 5;
+   */
+  SIP = 5,
+}
+
+/**
+ * Describes the enum photon.spectrum.v1.Channel.
+ */
+export declare const ChannelSchema: GenEnum<Channel>;
+

package/gen/photon/spectrum/v1/inbound_pb.js

@@ -0,0 +1,54 @@
+// Cross-channel envelope for raw inbound events as they enter the Spectrum
+// platform.
+//
+// The design promise is "zero server-side payload normalization": each channel
+// adapter (spectrum-slack, spectrum-whatsapp-business, ...) verifies the
+// channel-specific signature, then publishes the original HTTP body bit-exact
+// inside this envelope onto NATS JetStream subject
+// `inbound.<project_id>.<channel>`. Parsers live SDK-side
+// (`@photon-hq/spectrum-parsers-*`), keeping channel shape knowledge at the
+// edges and letting Spectrum add new channels without touching the routing
+// fabric.
+//
+// `body` is bytes (not a string) so callers can transport any encoding without
+// risk of UTF-8 sanitization; `headers` carries the original signature header
+// (X-Slack-Signature, X-Hub-Signature-256, ...) so consumers that want a
+// second proof-of-origin can verify it themselves.
+
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file photon/spectrum/v1/inbound.proto (package photon.spectrum.v1, syntax proto3)
+/* eslint-disable */
+
+import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file photon/spectrum/v1/inbound.proto.
+ */
+export const file_photon_spectrum_v1_inbound = /*@__PURE__*/
+  fileDesc("CiBwaG90b24vc3BlY3RydW0vdjEvaW5ib3VuZC5wcm90bxIScGhvdG9uLnNwZWN0cnVtLnYxIuoCCg9SYXdJbmJvdW5kRXZlbnQSEAoIZXZlbnRfaWQYASABKAkSEgoKcHJvamVjdF9pZBgCIAEoCRIsCgdjaGFubmVsGAMgASgOMhsucGhvdG9uLnNwZWN0cnVtLnYxLkNoYW5uZWwSLwoLcmVjZWl2ZWRfYXQYBCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhEKCXNvdXJjZV9pZBgFIAEoCRIUCgxjb250ZW50X3R5cGUYCiABKAkSDAoEYm9keRgLIAEoDBJBCgdoZWFkZXJzGAwgAygLMjAucGhvdG9uLnNwZWN0cnVtLnYxLlJhd0luYm91bmRFdmVudC5IZWFkZXJzRW50cnkSEwoLc291cmNlX3BhdGgYDSABKAkSEwoLaHR0cF9tZXRob2QYDiABKAkaLgoMSGVhZGVyc0VudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEqjgEKB0NoYW5uZWwSFwoTQ0hBTk5FTF9VTlNQRUNJRklFRBAAEhEKDUNIQU5ORUxfU0xBQ0sQARIUChBDSEFOTkVMX0lNRVNTQUdFEAISHQoZQ0hBTk5FTF9XSEFUU0FQUF9CVVNJTkVTUxADEhEKDUNIQU5ORUxfVk9JQ0UQBBIPCgtDSEFOTkVMX1NJUBAFYgZwcm90bzM", [file_google_protobuf_timestamp]);
+
+/**
+ * Describes the message photon.spectrum.v1.RawInboundEvent.
+ * Use `create(RawInboundEventSchema)` to create a new message.
+ */
+export const RawInboundEventSchema = /*@__PURE__*/
+  messageDesc(file_photon_spectrum_v1_inbound, 0);
+
+/**
+ * Describes the enum photon.spectrum.v1.Channel.
+ */
+export const ChannelSchema = /*@__PURE__*/
+  enumDesc(file_photon_spectrum_v1_inbound, 0);
+
+/**
+ * Wire identifier for the source channel that produced an event. Used as the
+ * third segment of the NATS subject (`inbound.<project_id>.<channel>`) and as
+ * a stable discriminator for SDK-side parsers — adding a new channel reserves
+ * a new enum value rather than introducing a new top-level message.
+ *
+ * @generated from enum photon.spectrum.v1.Channel
+ */
+export const Channel = /*@__PURE__*/
+  tsEnum(ChannelSchema);
+

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@photon-ai/proto",
+  "version": "0.0.0",
+  "description": "Generated TypeScript bindings for photon.slack.v1 and photon.spectrum.v1 gRPC services.",
+  "type": "module",
+  "sideEffects": false,
+  "files": ["gen/"],
+  "exports": {
+    "./*": {
+      "types": "./gen/*.d.ts",
+      "default": "./gen/*.js"
+    }
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.12.0"
+  },
+  "devDependencies": {
+    "@bufbuild/buf": "^1.69.0"
+  },
+  "scripts": {
+    "generate": "buf generate",
+    "prepublishOnly": "npm run generate"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/photon-hq/spectrum-slack-buf.git",
+    "directory": "public"
+  },
+  "license": "MIT"
+}