insforge 1.2.10 → 1.4.8

package/shared-schemas/src/realtime.schema.ts

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+
+// ============================================================================
+// Sender Type
+// ============================================================================
+
+export const senderTypeSchema = z.enum(['system', 'user']);
+
+// ============================================================================
+// Channel Schema
+// ============================================================================
+
+export const realtimeChannelSchema = z.object({
+  id: z.string().uuid(),
+  pattern: z.string().min(1),
+  description: z.string().nullable(),
+  webhookUrls: z.array(z.string().url()).nullable(),
+  enabled: z.boolean(),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+});
+
+export type RealtimeChannel = z.infer<typeof realtimeChannelSchema>;
+
+// ============================================================================
+// Message Schema
+// ============================================================================
+
+export const realtimeMessageSchema = z.object({
+  id: z.string().uuid(),
+  eventName: z.string().min(1),
+  channelId: z.string().uuid().nullable(),
+  channelName: z.string().min(1),
+  payload: z.record(z.string(), z.unknown()),
+  senderType: senderTypeSchema,
+  senderId: z.string().uuid().nullable(),
+  wsAudienceCount: z.number().int().min(0),
+  whAudienceCount: z.number().int().min(0),
+  whDeliveredCount: z.number().int().min(0),
+  createdAt: z.string().datetime(),
+});
+
+export type RealtimeMessage = z.infer<typeof realtimeMessageSchema>;
+
+// ============================================================================
+// WebSocket Event Payloads (for SDK/frontend)
+// ============================================================================
+
+/**
+ * Payload for realtime:subscribe client event
+ */
+export const subscribeChannelPayloadSchema = z.object({
+  channel: z.string().min(1), // The resolved channel instance, e.g., "order:123"
+});
+
+export type SubscribeChannelPayload = z.infer<typeof subscribeChannelPayloadSchema>;
+
+export const unsubscribeChannelPayloadSchema = z.object({
+  channel: z.string().min(1), // The resolved channel instance, e.g., "order:123"
+});
+
+export type UnsubscribeChannelPayload = z.infer<typeof unsubscribeChannelPayloadSchema>;
+/**
+ * Payload for realtime:publish client event
+ */
+export const publishEventPayloadSchema = z.object({
+  channel: z.string().min(1),
+  event: z.string().min(1),
+  payload: z.record(z.string(), z.unknown()),
+});
+
+export type PublishEventPayload = z.infer<typeof publishEventPayloadSchema>;
+
+/**
+ * Response for subscribe operations (used in Socket.IO ack callbacks)
+ */
+export const subscribeResponseSchema = z.discriminatedUnion('ok', [
+  z.object({
+    ok: z.literal(true),
+    channel: z.string().min(1),
+  }),
+  z.object({
+    ok: z.literal(false),
+    channel: z.string().min(1),
+    error: z.object({
+      code: z.string().min(1),
+      message: z.string().min(1),
+    }),
+  }),
+]);
+
+export type SubscribeResponse = z.infer<typeof subscribeResponseSchema>;
+
+/**
+ * Payload for realtime:error server event (for unsolicited errors like publish failures)
+ */
+export const realtimeErrorPayloadSchema = z.object({
+  channel: z.string().optional(),
+  code: z.string().min(1),
+  message: z.string().min(1),
+});
+
+export type RealtimeErrorPayload = z.infer<typeof realtimeErrorPayloadSchema>;
+
+/**
+ * Payload sent to webhook endpoints
+ */
+export const webhookMessageSchema = z.object({
+  messageId: z.string().uuid(),
+  channel: z.string().min(1),
+  eventName: z.string().min(1),
+  payload: z.record(z.string(), z.unknown()),
+});
+
+export type WebhookMessage = z.infer<typeof webhookMessageSchema>;
+
+// ============================================================================
+// Socket Message Schema
+// ============================================================================
+
+/**
+ * Meta object included in all socket messages
+ */
+export const socketMessageMetaSchema = z.object({
+  channel: z.string().optional(), // Present for room broadcasts
+  messageId: z.string().uuid(),
+  senderType: senderTypeSchema,
+  senderId: z.string().uuid().optional(),
+  timestamp: z.string().datetime(),
+});
+
+export type SocketMessageMeta = z.infer<typeof socketMessageMetaSchema>;
+
+/**
+ * Base socket message schema (meta + passthrough for payload)
+ */
+export const socketMessageSchema = z
+  .object({
+    meta: socketMessageMetaSchema,
+  })
+  .passthrough();
+
+export type SocketMessage = z.infer<typeof socketMessageSchema>;

package/shared-schemas/src/secrets-api.schema.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { secretSchema } from './secrets.schema';
+
+// GET /secrets - List all secrets
+export const listSecretsResponseSchema = z.object({
+  secrets: z.array(secretSchema),
+});
+
+// GET /secrets/:key - Get secret value
+export const getSecretValueResponseSchema = z.object({
+  key: z.string(),
+  value: z.string(),
+});
+
+// POST /secrets - Create secret (user-facing API)
+export const createSecretRequestSchema = z.object({
+  key: z.string().regex(/^[A-Z0-9_]+$/, 'Use uppercase letters, numbers, and underscores only'),
+  value: z.string().min(1, 'Value is required'),
+});
+
+export const createSecretResponseSchema = z.object({
+  success: z.literal(true),
+  message: z.string(),
+  id: z.string(),
+});
+
+export const updateSecretResponseSchema = z.object({
+  success: z.literal(true),
+  message: z.string(),
+});
+
+// DELETE /secrets/:key - Delete secret
+export const deleteSecretResponseSchema = z.object({
+  success: z.literal(true),
+  message: z.string(),
+});
+
+// Export types
+export type ListSecretsResponse = z.infer<typeof listSecretsResponseSchema>;
+export type GetSecretValueResponse = z.infer<typeof getSecretValueResponseSchema>;
+export type CreateSecretRequest = z.infer<typeof createSecretRequestSchema>;
+export type CreateSecretResponse = z.infer<typeof createSecretResponseSchema>;
+export type UpdateSecretResponse = z.infer<typeof updateSecretResponseSchema>;
+export type DeleteSecretResponse = z.infer<typeof deleteSecretResponseSchema>;

package/shared-schemas/src/secrets.schema.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+
+// Secret metadata (without value - for listing)
+export const secretSchema = z.object({
+  id: z.string(),
+  key: z.string(),
+  isActive: z.boolean(),
+  isReserved: z.boolean(),
+  lastUsedAt: z.string().nullable(),
+  expiresAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export type SecretSchema = z.infer<typeof secretSchema>;

package/shared-schemas/tsconfig.json

@@ -1,21 +1,21 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": ["ES2020"],
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "types": []
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": []
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsconfig.json

@@ -1,8 +1,8 @@
-{
-  "files": [],
-  "references": [
-    { "path": "./frontend" },
-    { "path": "./backend" },
-    { "path": "./shared-schemas" }
-  ]
+{
+  "files": [],
+  "references": [
+    { "path": "./frontend" },
+    { "path": "./backend" },
+    { "path": "./shared-schemas" }
+  ]
 }

package/zeabur/README.md

@@ -1,13 +1,26 @@
-# InsForge Zeabur Template
-
-Internal template for one-click InsForge deployment on Zeabur.
-
-## Deploy
-
-```bash
-npx zeabur@latest template deploy -f template.yml
-```
-
-## Documentation
-
-- Zeabur docs: https://zeabur.com/docs/en-US/template/template-in-code
+# InsForge Zeabur Template
+
+Internal template for one-click InsForge deployment on Zeabur.
+
+## CLI Authentication
+
+```bash
+npx zeabur@latest auth login
+npx zeabur@latest auth logout
+```
+
+## Deploy
+
+```bash
+npx zeabur@latest template deploy -f template.yml
+```
+
+## Update
+
+```bash
+npx zeabur@latest template update -c Q82M3Y -f template.yml
+```
+
+## Documentation
+
+- Zeabur docs: https://zeabur.com/docs/en-US/template/template-in-code