@squidcloud/cli 1.0.463 → 1.0.465

package/dist/resources/claude/skills/squid-development/SKILL.md

@@ -26,7 +26,7 @@ Squid is a backend-as-a-service platform that provides:
 - **[ai.md](reference/ai.md)** → AI agents, chat, ask, askWithAnnotations, askAsync, askWithVoiceResponse, transcribeAndChat, transcribeAndAsk, knowledge bases, RAG, embeddings, image generation, audio, transcription, text-to-speech, TTS, connectedAgents, connectedIntegrations, connectedKnowledgeBases, @aiFunction, @secureAiAgent, @secureAiQuery, memory, memoryOptions, voiceOptions, OpenAI, Anthropic, Gemini, Grok, DALL-E, Whisper, MCP, @mcpServer, @mcpTool, executeAiQuery, executeAiApiCall, extraction, createPdf, upsert agent, listAgents
 - **[chat-widget.md](reference/chat-widget.md)** → AI chat widget, @squidcloud/react-chat-widget, squid-chat-widget, squid-chat-widget-with-fab-button, embeddable chat, custom API webhook, AI query mode, chain-of-thought, status updates, session management, agentContext, memoryOptions, squid-ai-custom-api-url, squid-ai-agent-chat-options, FAB button, theming, CSS variables, localization, RTL, menu items slots, suggested prompts, voice transcription, error formatting, authentication, squid-auth-provider, onChange events
 - **[databases.md](reference/databases.md)** → collections, documents, queries, subscriptions, snapshots, insert, update, delete, CRUD, real-time, dereference, pagination, transactions, query operators, eq, neq, gt, gte, lt, lte, like, in, nin, arrayIncludesSome, arrayIncludesAll, sortBy, limit, join queries, OR queries, @trigger, native queries, SQL, MongoDB, Elasticsearch, incrementInPath, decrementInPath, watch changes, doc(), projectFields, field projection, __docId__, __id
-- **[backend.md](reference/backend.md)** → SquidService, @executable, @webhook, @trigger, TriggerRequest, @scheduler, @limits, rate limiting, quotas, decorators, backend functions, WebhookRequest, CronExpression, cron, file handling, SquidFile, getUserAuth, isAuthenticated, assertIsAuthenticated, createWebhookResponse, this.squid, this.secrets, @clientConnectionStateHandler, CLI, squid init, squid start, squid deploy, squid build, project structure, multiple services, service architecture, squidInject, cross-service communication
+- **[backend.md](reference/backend.md)** → SquidService, @executable, @webhook, @trigger, TriggerRequest, @scheduler, @limits, rate limiting, quotas, decorators, backend functions, WebhookRequest, CronExpression, cron, file handling, SquidFile, getUserAuth, isAuthenticated, assertIsAuthenticated, createWebhookResponse, this.squid, this.secrets, @clientConnectionStateHandler, @onQueueMessage, QueueMessageRequest, queue message handler, server-side queue consumer, CLI, squid init, squid start, squid deploy, squid build, project structure, multiple services, service architecture, squidInject, cross-service communication
 - **[security.md](reference/security.md)** → security rules, @secureDatabase, @secureCollection, @secureTopic, @secureStorage, @secureApi, @secureNativeQuery, @secureAiQuery, @secureAiAgent, @secureDistributedLock, @secureGraphQL, QueryContext, MutationContext, isSubqueryOf, affectsPath, permissions, authorization, row-level security, role-based access
 - **[admin.md](reference/admin.md)** → ManagementClient, management API keys, organizations, applications, programmatic management, CI/CD, automation, integrations admin, secrets admin, upsertIntegration, discoverDataConnectionSchema, testDataConnection, createOrganization, createApplication
 - **[api.md](reference/api.md)** → API, REST API, HTTP endpoints, API reference, Agent API, AI Audio API, AI Image API, KnowledgeBase API, Matchmaking API, Web Utilities API, Database API, Extraction API
@@ -79,6 +79,7 @@ Client → Squid Cloud → Your Backend → Integration → Response
 | Webhooks from external services | **Yes** | Use `@webhook` decorator |
 | Scheduled jobs | **Yes** | Use `@scheduler` decorator |
 | Server-side secrets | **Yes** | Access via `this.secrets` |
+| Handle queue messages server-side | **Yes** | Use `@onQueueMessage` decorator |
 
 ### What Squid Cloud Handles
 

package/dist/resources/claude/skills/squid-development/reference/backend.md

@@ -17,10 +17,11 @@ Docs: https://docs.getsquid.ai/reference-docs/backend/
 - Triggers (@trigger)
 - Schedulers (@scheduler)
 - Rate Limiting (@limits)
+- Queue Message Handlers (@onQueueMessage)
 - Client Connection State (@clientConnectionStateHandler)
 - Cross-Service Communication (squidInject)
 - Using Squid Client in Backend
-- File Handling``
+- File Handling
 
 ## CLI Commands
 
@@ -461,6 +462,44 @@ export class MyService extends SquidService {
 **Scopes:** `'global'`, `'user'`, `'ip'`
 **Periods:** `'hourly'`, `'daily'`, `'weekly'`, `'monthly'`, `'quarterly'`, `'annually'`
 
+## Queue Message Handlers (@onQueueMessage)
+
+The `@onQueueMessage` decorator registers a backend handler that is called server-side whenever a message is produced to a queue topic. Unlike client-side `.consume()`, this handler runs in the backend with full permissions and no client connection required.
+
+```typescript
+import { SquidService, onQueueMessage, QueueMessageRequest } from '@squidcloud/backend';
+
+export class MyService extends SquidService {
+  // Built-in queue (default integration)
+  @onQueueMessage<string>('notifications')
+  async onNotification(request: QueueMessageRequest<string>): Promise<void> {
+    console.log(request.message);      // The message payload (typed)
+    console.log(request.topicName);    // 'notifications'
+    console.log(request.integrationId); // 'built_in_queue'
+    // Full backend permissions: this.squid, this.secrets, etc.
+    await this.squid.collection('log').doc().insert({ msg: request.message });
+  }
+
+  // External Kafka integration
+  @onQueueMessage<OrderEvent>('orders', 'kafka')
+  async onKafkaOrder(request: QueueMessageRequest<OrderEvent>): Promise<void> {
+    console.log(request.message);       // Typed OrderEvent payload
+    console.log(request.integrationId); // 'kafka'
+  }
+}
+```
+
+**`QueueMessageRequest<T>`:**
+- `message: T` - The message payload (typed by the decorator's generic parameter)
+- `topicName: string` - The topic name the message was received on
+- `integrationId: string` - The integration ID (`'built_in_queue'` or custom)
+
+**Notes:**
+- The handler is called once per message, server-side — no client needs to be connected
+- Works with both built-in queue and external Kafka integrations
+- To secure the topic, use `@secureTopic` — see [security.md](security.md)
+- The handler receives each message individually (not batched)
+
 ## Client Connection State (@clientConnectionStateHandler)
 
 Handle client connection and disconnection events.

package/dist/resources/claude/skills/squid-development/reference/client.md

@@ -285,7 +285,7 @@ const subscription = queue.consume<Message>().subscribe(message => {
 subscription.unsubscribe();
 ```
 
-To secure queue topics, see [security.md](security.md) for `@secureTopic`. For Kafka and other queue integrations, see [connectors.md](connectors.md).
+To secure queue topics, see [security.md](security.md) for `@secureTopic`. For Kafka and other queue integrations, see [connectors.md](connectors.md). To handle messages server-side without a client subscriber, use `@onQueueMessage` in your backend — see [backend.md](backend.md).
 
 ## Distributed Locks
 

package/dist/resources/claude/skills/squid-development/reference/openai.md

@@ -73,13 +73,13 @@ const voiceResult = await agent.askWithVoiceResponse('Hello', {
 });
 ```
 
-## Image Generation (DALL-E)
+## Image Generation (gpt-image-*)
 
 ```typescript
 const imageUrl = await squid.ai().image().generate('A futuristic city', {
-  modelName: 'dall-e-3',
-  quality: 'hd',        // 'hd' | 'standard'
-  size: '1024x1024'     // '1024x1024' | '1792x1024' | '1024x1792'
+  modelName: 'gpt-image-1',
+  quality: 'high',      // 'auto' | 'high' | 'medium' | 'low'
+  size: '1024x1024'     // '1024x1024' | '1024x1536' | '1536x1024' | 'auto'
 });
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/cli",
-  "version": "1.0.463",
+  "version": "1.0.465",
   "description": "The Squid CLI",
   "main": "dist/index.js",
   "scripts": {
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@squidcloud/local-backend": "^1.0.463",
+    "@squidcloud/local-backend": "^1.0.465",
     "adm-zip": "^0.5.16",
     "copy-webpack-plugin": "^14.0.0",
     "decompress": "^4.2.1",