@pedi/chika-types 1.0.0

package/README.md

@@ -0,0 +1,41 @@
+# @pedi/chika-types
+
+Shared TypeScript types and Zod validation schemas for the Pedi Chika chat system.
+
+## What It Does
+
+Provides the single source of truth for all data structures in the chat system. Every message, participant, channel event, and API request/response is defined here and shared across both the server and the SDK.
+
+## Problems It Solves
+
+- **Type drift between client and server** — A single package defines the contract, so the SDK and server can never disagree on the shape of a message or participant
+- **Runtime validation** — Zod schemas validate incoming data at API boundaries while TypeScript generics enforce correctness at compile time
+- **Domain flexibility** — The generic `ChatDomain` system lets you reuse the entire type system for different chat contexts (ride-hailing, customer support, etc.) with full type safety
+
+## Key Features
+
+- Generic `ChatDomain` interface for defining strongly-typed chat domains
+- Pre-built `PediChat` domain for ride-hailing (driver/rider roles, booking events, vehicle metadata)
+- Zod schemas for all API request validation (participants, messages, history queries)
+- Full TypeScript generics — `Message<PediChat>`, `Participant<PediChat>`, etc.
+- Zero dependencies beyond Zod
+
+## Quick Start
+
+```typescript
+import type { Message, Participant, PediChat } from '@pedi/chika-types';
+import { sendMessageRequestSchema } from '@pedi/chika-types';
+
+// Strongly typed for ride-hailing
+const msg: Message<PediChat> = { /* autocomplete guides you */ };
+
+// Runtime validation at API boundaries
+const parsed = sendMessageRequestSchema.parse(requestBody);
+```
+
+## Documentation
+
+See the [docs](./docs/) for detailed documentation:
+
+- [Type Reference](./docs/type-reference.md) — All types, interfaces, and schemas
+- [Chat Domain Guide](./docs/chat-domain-guide.md) — How the generic domain system works, with examples

package/dist/index.d.mts

@@ -0,0 +1,257 @@
+import { z } from 'zod';
+
+interface ChatDomain {
+    role: string;
+    metadata: Record<string, unknown>;
+    messageType: string;
+    attributes: Record<string, unknown>;
+}
+interface DefaultDomain extends ChatDomain {
+    role: string;
+    metadata: Record<string, unknown>;
+    messageType: string;
+    attributes: Record<string, unknown>;
+}
+
+declare const participantSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    name: z.ZodString;
+    profile_image: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+interface Participant<D extends ChatDomain = DefaultDomain> {
+    id: string;
+    role: D['role'];
+    name: string;
+    profile_image?: string;
+    metadata?: D['metadata'];
+}
+
+declare const messageAttributesSchema: z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>;
+type MessageAttributes<D extends ChatDomain = DefaultDomain> = D['attributes'];
+interface Message<D extends ChatDomain = DefaultDomain> {
+    id: string;
+    channel_id: string;
+    sender_id: string | null;
+    sender_role: D['role'] | 'system';
+    type: D['messageType'];
+    body: string;
+    attributes: MessageAttributes<D>;
+    created_at: string;
+}
+declare const sendMessageRequestSchema: z.ZodObject<{
+    sender_id: z.ZodString;
+    type: z.ZodString;
+    body: z.ZodString;
+    attributes: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    sender_id: string;
+    body: string;
+    attributes?: z.objectOutputType<{}, z.ZodUnknown, "strip"> | undefined;
+}, {
+    type: string;
+    sender_id: string;
+    body: string;
+    attributes?: z.objectInputType<{}, z.ZodUnknown, "strip"> | undefined;
+}>;
+interface SendMessageRequest<D extends ChatDomain = DefaultDomain> {
+    sender_id: string;
+    type: D['messageType'];
+    body: string;
+    attributes?: MessageAttributes<D>;
+}
+interface SendMessageResponse {
+    id: string;
+    created_at: string;
+}
+declare const systemMessageRequestSchema: z.ZodObject<{
+    type: z.ZodString;
+    body: z.ZodString;
+    attributes: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    body: string;
+    attributes?: z.objectOutputType<{}, z.ZodUnknown, "strip"> | undefined;
+}, {
+    type: string;
+    body: string;
+    attributes?: z.objectInputType<{}, z.ZodUnknown, "strip"> | undefined;
+}>;
+interface SystemMessageRequest<D extends ChatDomain = DefaultDomain> {
+    type: D['messageType'];
+    body: string;
+    attributes?: MessageAttributes<D>;
+}
+declare const messageHistoryQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    before: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    before?: string | undefined;
+    after?: string | undefined;
+}, {
+    limit?: number | undefined;
+    before?: string | undefined;
+    after?: string | undefined;
+}>;
+interface MessageHistoryQuery {
+    limit?: number;
+    before?: string;
+    after?: string;
+}
+interface MessageHistoryResponse<D extends ChatDomain = DefaultDomain> {
+    channel_id: string;
+    participants: Participant<D>[];
+    messages: Message<D>[];
+    has_more: boolean;
+}
+
+declare const joinRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    name: z.ZodString;
+    profile_image: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+type JoinRequest = z.infer<typeof joinRequestSchema>;
+interface JoinResponse<D extends ChatDomain = DefaultDomain> {
+    channel_id: string;
+    status: 'active' | 'closed';
+    participants: Participant<D>[];
+    messages: Message<D>[];
+    joined_at: string;
+}
+
+interface SSEMessageEvent<D extends ChatDomain = DefaultDomain> {
+    id: string;
+    event: 'message';
+    data: Message<D>;
+}
+interface SSEResyncEvent {
+    event: 'resync';
+    data: {
+        reason: string;
+        missed_count: number;
+    };
+}
+type SSEEvent<D extends ChatDomain = DefaultDomain> = SSEMessageEvent<D> | SSEResyncEvent;
+
+interface ChatBucket {
+    group: string;
+    range: [number, number];
+    server_url: string;
+}
+interface ChatManifest {
+    buckets: ChatBucket[];
+}
+
+/**
+ * Configurable auth validator types.
+ *
+ * Implementors create an `auth.config.ts` file (gitignored) that exports
+ * an {@link AuthConfig} object.  The server dynamically imports it at
+ * startup; if the file is absent, auth is disabled.
+ */
+/** The context passed to every validator invocation. */
+interface AuthValidatorContext {
+    /** All request headers (lowercased keys). */
+    headers: Record<string, string>;
+    /** The channel being accessed. */
+    channelId: string;
+}
+/** What the validator must return. */
+interface AuthValidatorResult {
+    /** Whether the request is allowed. */
+    valid: boolean;
+    /** Optional user identifier — stored for audit / logging. */
+    userId?: string;
+}
+/**
+ * A function that decides whether an incoming request is authorised.
+ *
+ * Return `{ valid: true }` to allow, `{ valid: false }` to reject (401).
+ */
+type AuthValidator = (ctx: AuthValidatorContext) => Promise<AuthValidatorResult> | AuthValidatorResult;
+/** The shape of the default export in `auth.config.ts`. */
+interface AuthConfig {
+    /** The validation function. */
+    validate: AuthValidator;
+    /**
+     * How long (ms) a **valid** result is cached per cache-key.
+     * Set to `0` to disable caching.  Defaults to `300_000` (5 min).
+     */
+    cacheTtl?: number;
+    /**
+     * How long (ms) an **invalid** result is cached per cache-key.
+     * Defaults to `2_000` (2 s).
+     */
+    invalidCacheTtl?: number;
+    /**
+     * Derive a cache key from the request context.
+     * Defaults to the full `Authorization` header value.
+     * Return `null` to skip caching for a request.
+     */
+    cacheKey?: (ctx: AuthValidatorContext) => string | null;
+}
+
+interface PediVehicle {
+    plate_number: string;
+    body_number: string;
+    color: string;
+    brand: string;
+}
+interface PediLocation {
+    latitude: number;
+    longitude: number;
+}
+type PediRole = 'driver' | 'rider';
+type PediMessageType = 'chat' | 'driver_arrived' | 'booking_started' | 'booking_completed' | 'booking_cancelled' | 'system_notice';
+interface PediParticipantMeta {
+    vehicle?: PediVehicle;
+    rating?: number;
+    current_location?: PediLocation | null;
+    [key: string]: unknown;
+}
+interface PediMessageAttributes {
+    location?: PediLocation;
+    device?: 'android' | 'ios';
+    app_version?: string;
+    booking_id?: string;
+    booking_status?: string;
+    [key: string]: unknown;
+}
+interface PediChat extends ChatDomain {
+    role: PediRole;
+    metadata: PediParticipantMeta;
+    messageType: PediMessageType;
+    attributes: PediMessageAttributes;
+}
+
+export { type AuthConfig, type AuthValidator, type AuthValidatorContext, type AuthValidatorResult, type ChatBucket, type ChatDomain, type ChatManifest, type DefaultDomain, type JoinRequest, type JoinResponse, type Message, type MessageAttributes, type MessageHistoryQuery, type MessageHistoryResponse, type Participant, type PediChat, type PediLocation, type PediMessageAttributes, type PediMessageType, type PediParticipantMeta, type PediRole, type PediVehicle, type SSEEvent, type SSEMessageEvent, type SSEResyncEvent, type SendMessageRequest, type SendMessageResponse, type SystemMessageRequest, joinRequestSchema, messageAttributesSchema, messageHistoryQuerySchema, participantSchema, sendMessageRequestSchema, systemMessageRequestSchema };

package/dist/index.d.ts

@@ -0,0 +1,257 @@
+import { z } from 'zod';
+
+interface ChatDomain {
+    role: string;
+    metadata: Record<string, unknown>;
+    messageType: string;
+    attributes: Record<string, unknown>;
+}
+interface DefaultDomain extends ChatDomain {
+    role: string;
+    metadata: Record<string, unknown>;
+    messageType: string;
+    attributes: Record<string, unknown>;
+}
+
+declare const participantSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    name: z.ZodString;
+    profile_image: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+interface Participant<D extends ChatDomain = DefaultDomain> {
+    id: string;
+    role: D['role'];
+    name: string;
+    profile_image?: string;
+    metadata?: D['metadata'];
+}
+
+declare const messageAttributesSchema: z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>;
+type MessageAttributes<D extends ChatDomain = DefaultDomain> = D['attributes'];
+interface Message<D extends ChatDomain = DefaultDomain> {
+    id: string;
+    channel_id: string;
+    sender_id: string | null;
+    sender_role: D['role'] | 'system';
+    type: D['messageType'];
+    body: string;
+    attributes: MessageAttributes<D>;
+    created_at: string;
+}
+declare const sendMessageRequestSchema: z.ZodObject<{
+    sender_id: z.ZodString;
+    type: z.ZodString;
+    body: z.ZodString;
+    attributes: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    sender_id: string;
+    body: string;
+    attributes?: z.objectOutputType<{}, z.ZodUnknown, "strip"> | undefined;
+}, {
+    type: string;
+    sender_id: string;
+    body: string;
+    attributes?: z.objectInputType<{}, z.ZodUnknown, "strip"> | undefined;
+}>;
+interface SendMessageRequest<D extends ChatDomain = DefaultDomain> {
+    sender_id: string;
+    type: D['messageType'];
+    body: string;
+    attributes?: MessageAttributes<D>;
+}
+interface SendMessageResponse {
+    id: string;
+    created_at: string;
+}
+declare const systemMessageRequestSchema: z.ZodObject<{
+    type: z.ZodString;
+    body: z.ZodString;
+    attributes: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    body: string;
+    attributes?: z.objectOutputType<{}, z.ZodUnknown, "strip"> | undefined;
+}, {
+    type: string;
+    body: string;
+    attributes?: z.objectInputType<{}, z.ZodUnknown, "strip"> | undefined;
+}>;
+interface SystemMessageRequest<D extends ChatDomain = DefaultDomain> {
+    type: D['messageType'];
+    body: string;
+    attributes?: MessageAttributes<D>;
+}
+declare const messageHistoryQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    before: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    before?: string | undefined;
+    after?: string | undefined;
+}, {
+    limit?: number | undefined;
+    before?: string | undefined;
+    after?: string | undefined;
+}>;
+interface MessageHistoryQuery {
+    limit?: number;
+    before?: string;
+    after?: string;
+}
+interface MessageHistoryResponse<D extends ChatDomain = DefaultDomain> {
+    channel_id: string;
+    participants: Participant<D>[];
+    messages: Message<D>[];
+    has_more: boolean;
+}
+
+declare const joinRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    name: z.ZodString;
+    profile_image: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    role: string;
+    name: string;
+    profile_image?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+type JoinRequest = z.infer<typeof joinRequestSchema>;
+interface JoinResponse<D extends ChatDomain = DefaultDomain> {
+    channel_id: string;
+    status: 'active' | 'closed';
+    participants: Participant<D>[];
+    messages: Message<D>[];
+    joined_at: string;
+}
+
+interface SSEMessageEvent<D extends ChatDomain = DefaultDomain> {
+    id: string;
+    event: 'message';
+    data: Message<D>;
+}
+interface SSEResyncEvent {
+    event: 'resync';
+    data: {
+        reason: string;
+        missed_count: number;
+    };
+}
+type SSEEvent<D extends ChatDomain = DefaultDomain> = SSEMessageEvent<D> | SSEResyncEvent;
+
+interface ChatBucket {
+    group: string;
+    range: [number, number];
+    server_url: string;
+}
+interface ChatManifest {
+    buckets: ChatBucket[];
+}
+
+/**
+ * Configurable auth validator types.
+ *
+ * Implementors create an `auth.config.ts` file (gitignored) that exports
+ * an {@link AuthConfig} object.  The server dynamically imports it at
+ * startup; if the file is absent, auth is disabled.
+ */
+/** The context passed to every validator invocation. */
+interface AuthValidatorContext {
+    /** All request headers (lowercased keys). */
+    headers: Record<string, string>;
+    /** The channel being accessed. */
+    channelId: string;
+}
+/** What the validator must return. */
+interface AuthValidatorResult {
+    /** Whether the request is allowed. */
+    valid: boolean;
+    /** Optional user identifier — stored for audit / logging. */
+    userId?: string;
+}
+/**
+ * A function that decides whether an incoming request is authorised.
+ *
+ * Return `{ valid: true }` to allow, `{ valid: false }` to reject (401).
+ */
+type AuthValidator = (ctx: AuthValidatorContext) => Promise<AuthValidatorResult> | AuthValidatorResult;
+/** The shape of the default export in `auth.config.ts`. */
+interface AuthConfig {
+    /** The validation function. */
+    validate: AuthValidator;
+    /**
+     * How long (ms) a **valid** result is cached per cache-key.
+     * Set to `0` to disable caching.  Defaults to `300_000` (5 min).
+     */
+    cacheTtl?: number;
+    /**
+     * How long (ms) an **invalid** result is cached per cache-key.
+     * Defaults to `2_000` (2 s).
+     */
+    invalidCacheTtl?: number;
+    /**
+     * Derive a cache key from the request context.
+     * Defaults to the full `Authorization` header value.
+     * Return `null` to skip caching for a request.
+     */
+    cacheKey?: (ctx: AuthValidatorContext) => string | null;
+}
+
+interface PediVehicle {
+    plate_number: string;
+    body_number: string;
+    color: string;
+    brand: string;
+}
+interface PediLocation {
+    latitude: number;
+    longitude: number;
+}
+type PediRole = 'driver' | 'rider';
+type PediMessageType = 'chat' | 'driver_arrived' | 'booking_started' | 'booking_completed' | 'booking_cancelled' | 'system_notice';
+interface PediParticipantMeta {
+    vehicle?: PediVehicle;
+    rating?: number;
+    current_location?: PediLocation | null;
+    [key: string]: unknown;
+}
+interface PediMessageAttributes {
+    location?: PediLocation;
+    device?: 'android' | 'ios';
+    app_version?: string;
+    booking_id?: string;
+    booking_status?: string;
+    [key: string]: unknown;
+}
+interface PediChat extends ChatDomain {
+    role: PediRole;
+    metadata: PediParticipantMeta;
+    messageType: PediMessageType;
+    attributes: PediMessageAttributes;
+}
+
+export { type AuthConfig, type AuthValidator, type AuthValidatorContext, type AuthValidatorResult, type ChatBucket, type ChatDomain, type ChatManifest, type DefaultDomain, type JoinRequest, type JoinResponse, type Message, type MessageAttributes, type MessageHistoryQuery, type MessageHistoryResponse, type Participant, type PediChat, type PediLocation, type PediMessageAttributes, type PediMessageType, type PediParticipantMeta, type PediRole, type PediVehicle, type SSEEvent, type SSEMessageEvent, type SSEResyncEvent, type SendMessageRequest, type SendMessageResponse, type SystemMessageRequest, joinRequestSchema, messageAttributesSchema, messageHistoryQuerySchema, participantSchema, sendMessageRequestSchema, systemMessageRequestSchema };

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  joinRequestSchema: () => joinRequestSchema,
+  messageAttributesSchema: () => messageAttributesSchema,
+  messageHistoryQuerySchema: () => messageHistoryQuerySchema,
+  participantSchema: () => participantSchema,
+  sendMessageRequestSchema: () => sendMessageRequestSchema,
+  systemMessageRequestSchema: () => systemMessageRequestSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/participant.ts
+var import_zod = require("zod");
+var participantSchema = import_zod.z.object({
+  id: import_zod.z.string().min(1),
+  role: import_zod.z.string().min(1),
+  name: import_zod.z.string().min(1),
+  profile_image: import_zod.z.string().url().optional(),
+  metadata: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+
+// src/channel.ts
+var joinRequestSchema = participantSchema;
+
+// src/message.ts
+var import_zod2 = require("zod");
+var messageAttributesSchema = import_zod2.z.object({}).catchall(import_zod2.z.unknown());
+var sendMessageRequestSchema = import_zod2.z.object({
+  sender_id: import_zod2.z.string().min(1),
+  type: import_zod2.z.string().min(1),
+  body: import_zod2.z.string().min(1).max(1e4),
+  attributes: messageAttributesSchema.optional()
+});
+var systemMessageRequestSchema = import_zod2.z.object({
+  type: import_zod2.z.string().min(1),
+  body: import_zod2.z.string().min(1).max(1e4),
+  attributes: messageAttributesSchema.optional()
+});
+var messageHistoryQuerySchema = import_zod2.z.object({
+  limit: import_zod2.z.coerce.number().int().positive().max(200).default(50),
+  before: import_zod2.z.string().datetime().optional(),
+  after: import_zod2.z.string().datetime().optional()
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  joinRequestSchema,
+  messageAttributesSchema,
+  messageHistoryQuerySchema,
+  participantSchema,
+  sendMessageRequestSchema,
+  systemMessageRequestSchema
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/participant.ts","../src/channel.ts","../src/message.ts"],"sourcesContent":["export type { ChatDomain, DefaultDomain } from './domain';\nexport type { Participant } from './participant';\nexport type {\n  MessageAttributes,\n  Message,\n  SendMessageRequest,\n  SendMessageResponse,\n  SystemMessageRequest,\n  MessageHistoryQuery,\n  MessageHistoryResponse,\n} from './message';\nexport type { JoinRequest, JoinResponse } from './channel';\nexport type { SSEMessageEvent, SSEResyncEvent, SSEEvent } from './sse';\nexport type { ChatBucket, ChatManifest } from './manifest';\nexport type {\n  AuthValidatorContext,\n  AuthValidatorResult,\n  AuthValidator,\n  AuthConfig,\n} from './auth';\n\nexport type {\n  PediChat,\n  PediRole,\n  PediVehicle,\n  PediLocation,\n  PediParticipantMeta,\n  PediMessageType,\n  PediMessageAttributes,\n} from './domains';\n\nexport { participantSchema } from './participant';\nexport { joinRequestSchema } from './channel';\nexport {\n  messageAttributesSchema,\n  sendMessageRequestSchema,\n  systemMessageRequestSchema,\n  messageHistoryQuerySchema,\n} from './message';\n","import { z } from 'zod';\nimport type { ChatDomain, DefaultDomain } from './domain';\n\nexport const participantSchema = z.object({\n  id: z.string().min(1),\n  role: z.string().min(1),\n  name: z.string().min(1),\n  profile_image: z.string().url().optional(),\n  metadata: z.record(z.unknown()).optional(),\n});\n\nexport interface Participant<D extends ChatDomain = DefaultDomain> {\n  id: string;\n  role: D['role'];\n  name: string;\n  profile_image?: string;\n  metadata?: D['metadata'];\n}\n","import { z } from 'zod';\nimport { participantSchema, type Participant } from './participant';\nimport type { Message } from './message';\nimport type { ChatDomain, DefaultDomain } from './domain';\n\nexport const joinRequestSchema = participantSchema;\n\nexport type JoinRequest = z.infer<typeof joinRequestSchema>;\n\nexport interface JoinResponse<D extends ChatDomain = DefaultDomain> {\n  channel_id: string;\n  status: 'active' | 'closed';\n  participants: Participant<D>[];\n  messages: Message<D>[];\n  joined_at: string;\n}\n","import { z } from 'zod';\nimport type { ChatDomain, DefaultDomain } from './domain';\nimport type { Participant } from './participant';\n\nexport const messageAttributesSchema = z\n  .object({})\n  .catchall(z.unknown());\n\nexport type MessageAttributes<D extends ChatDomain = DefaultDomain> = D['attributes'];\n\nexport interface Message<D extends ChatDomain = DefaultDomain> {\n  id: string;\n  channel_id: string;\n  sender_id: string | null;\n  sender_role: D['role'] | 'system';\n  type: D['messageType'];\n  body: string;\n  attributes: MessageAttributes<D>;\n  created_at: string;\n}\n\nexport const sendMessageRequestSchema = z.object({\n  sender_id: z.string().min(1),\n  type: z.string().min(1),\n  body: z.string().min(1).max(10_000),\n  attributes: messageAttributesSchema.optional(),\n});\n\nexport interface SendMessageRequest<D extends ChatDomain = DefaultDomain> {\n  sender_id: string;\n  type: D['messageType'];\n  body: string;\n  attributes?: MessageAttributes<D>;\n}\n\nexport interface SendMessageResponse {\n  id: string;\n  created_at: string;\n}\n\nexport const systemMessageRequestSchema = z.object({\n  type: z.string().min(1),\n  body: z.string().min(1).max(10_000),\n  attributes: messageAttributesSchema.optional(),\n});\n\nexport interface SystemMessageRequest<D extends ChatDomain = DefaultDomain> {\n  type: D['messageType'];\n  body: string;\n  attributes?: MessageAttributes<D>;\n}\n\nexport const messageHistoryQuerySchema = z.object({\n  limit: z.coerce.number().int().positive().max(200).default(50),\n  before: z.string().datetime().optional(),\n  after: z.string().datetime().optional(),\n});\n\nexport interface MessageHistoryQuery {\n  limit?: number;\n  before?: string;\n  after?: string;\n}\n\nexport interface MessageHistoryResponse<D extends ChatDomain = DefaultDomain> {\n  channel_id: string;\n  participants: Participant<D>[];\n  messages: Message<D>[];\n  has_more: boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAkB;AAGX,IAAM,oBAAoB,aAAE,OAAO;AAAA,EACxC,IAAI,aAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACpB,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,eAAe,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACzC,UAAU,aAAE,OAAO,aAAE,QAAQ,CAAC,EAAE,SAAS;AAC3C,CAAC;;;ACJM,IAAM,oBAAoB;;;ACLjC,IAAAA,cAAkB;AAIX,IAAM,0BAA0B,cACpC,OAAO,CAAC,CAAC,EACT,SAAS,cAAE,QAAQ,CAAC;AAehB,IAAM,2BAA2B,cAAE,OAAO;AAAA,EAC/C,WAAW,cAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,MAAM,cAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAM,cAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAM;AAAA,EAClC,YAAY,wBAAwB,SAAS;AAC/C,CAAC;AAcM,IAAM,6BAA6B,cAAE,OAAO;AAAA,EACjD,MAAM,cAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAM,cAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAM;AAAA,EAClC,YAAY,wBAAwB,SAAS;AAC/C,CAAC;AAQM,IAAM,4BAA4B,cAAE,OAAO;AAAA,EAChD,OAAO,cAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AAAA,EAC7D,QAAQ,cAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EACvC,OAAO,cAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AACxC,CAAC;","names":["import_zod"]}

package/dist/index.mjs

@@ -0,0 +1,41 @@
+// src/participant.ts
+import { z } from "zod";
+var participantSchema = z.object({
+  id: z.string().min(1),
+  role: z.string().min(1),
+  name: z.string().min(1),
+  profile_image: z.string().url().optional(),
+  metadata: z.record(z.unknown()).optional()
+});
+
+// src/channel.ts
+var joinRequestSchema = participantSchema;
+
+// src/message.ts
+import { z as z2 } from "zod";
+var messageAttributesSchema = z2.object({}).catchall(z2.unknown());
+var sendMessageRequestSchema = z2.object({
+  sender_id: z2.string().min(1),
+  type: z2.string().min(1),
+  body: z2.string().min(1).max(1e4),
+  attributes: messageAttributesSchema.optional()
+});
+var systemMessageRequestSchema = z2.object({
+  type: z2.string().min(1),
+  body: z2.string().min(1).max(1e4),
+  attributes: messageAttributesSchema.optional()
+});
+var messageHistoryQuerySchema = z2.object({
+  limit: z2.coerce.number().int().positive().max(200).default(50),
+  before: z2.string().datetime().optional(),
+  after: z2.string().datetime().optional()
+});
+export {
+  joinRequestSchema,
+  messageAttributesSchema,
+  messageHistoryQuerySchema,
+  participantSchema,
+  sendMessageRequestSchema,
+  systemMessageRequestSchema
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/participant.ts","../src/channel.ts","../src/message.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { ChatDomain, DefaultDomain } from './domain';\n\nexport const participantSchema = z.object({\n  id: z.string().min(1),\n  role: z.string().min(1),\n  name: z.string().min(1),\n  profile_image: z.string().url().optional(),\n  metadata: z.record(z.unknown()).optional(),\n});\n\nexport interface Participant<D extends ChatDomain = DefaultDomain> {\n  id: string;\n  role: D['role'];\n  name: string;\n  profile_image?: string;\n  metadata?: D['metadata'];\n}\n","import { z } from 'zod';\nimport { participantSchema, type Participant } from './participant';\nimport type { Message } from './message';\nimport type { ChatDomain, DefaultDomain } from './domain';\n\nexport const joinRequestSchema = participantSchema;\n\nexport type JoinRequest = z.infer<typeof joinRequestSchema>;\n\nexport interface JoinResponse<D extends ChatDomain = DefaultDomain> {\n  channel_id: string;\n  status: 'active' | 'closed';\n  participants: Participant<D>[];\n  messages: Message<D>[];\n  joined_at: string;\n}\n","import { z } from 'zod';\nimport type { ChatDomain, DefaultDomain } from './domain';\nimport type { Participant } from './participant';\n\nexport const messageAttributesSchema = z\n  .object({})\n  .catchall(z.unknown());\n\nexport type MessageAttributes<D extends ChatDomain = DefaultDomain> = D['attributes'];\n\nexport interface Message<D extends ChatDomain = DefaultDomain> {\n  id: string;\n  channel_id: string;\n  sender_id: string | null;\n  sender_role: D['role'] | 'system';\n  type: D['messageType'];\n  body: string;\n  attributes: MessageAttributes<D>;\n  created_at: string;\n}\n\nexport const sendMessageRequestSchema = z.object({\n  sender_id: z.string().min(1),\n  type: z.string().min(1),\n  body: z.string().min(1).max(10_000),\n  attributes: messageAttributesSchema.optional(),\n});\n\nexport interface SendMessageRequest<D extends ChatDomain = DefaultDomain> {\n  sender_id: string;\n  type: D['messageType'];\n  body: string;\n  attributes?: MessageAttributes<D>;\n}\n\nexport interface SendMessageResponse {\n  id: string;\n  created_at: string;\n}\n\nexport const systemMessageRequestSchema = z.object({\n  type: z.string().min(1),\n  body: z.string().min(1).max(10_000),\n  attributes: messageAttributesSchema.optional(),\n});\n\nexport interface SystemMessageRequest<D extends ChatDomain = DefaultDomain> {\n  type: D['messageType'];\n  body: string;\n  attributes?: MessageAttributes<D>;\n}\n\nexport const messageHistoryQuerySchema = z.object({\n  limit: z.coerce.number().int().positive().max(200).default(50),\n  before: z.string().datetime().optional(),\n  after: z.string().datetime().optional(),\n});\n\nexport interface MessageHistoryQuery {\n  limit?: number;\n  before?: string;\n  after?: string;\n}\n\nexport interface MessageHistoryResponse<D extends ChatDomain = DefaultDomain> {\n  channel_id: string;\n  participants: Participant<D>[];\n  messages: Message<D>[];\n  has_more: boolean;\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAGX,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACpB,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACzC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS;AAC3C,CAAC;;;ACJM,IAAM,oBAAoB;;;ACLjC,SAAS,KAAAA,UAAS;AAIX,IAAM,0BAA0BA,GACpC,OAAO,CAAC,CAAC,EACT,SAASA,GAAE,QAAQ,CAAC;AAehB,IAAM,2BAA2BA,GAAE,OAAO;AAAA,EAC/C,WAAWA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAM;AAAA,EAClC,YAAY,wBAAwB,SAAS;AAC/C,CAAC;AAcM,IAAM,6BAA6BA,GAAE,OAAO;AAAA,EACjD,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAM;AAAA,EAClC,YAAY,wBAAwB,SAAS;AAC/C,CAAC;AAQM,IAAM,4BAA4BA,GAAE,OAAO;AAAA,EAChD,OAAOA,GAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AAAA,EAC7D,QAAQA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EACvC,OAAOA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AACxC,CAAC;","names":["z"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@pedi/chika-types",
+  "version": "1.0.0",
+  "description": "Shared TypeScript types and Zod schemas for Pedi Chika chat service",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0"
+  }
+}