@pikku/azure-functions 0.12.1 → 0.12.3

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## 0.12.3
+
+### Patch Changes
+
+- daec082: Drop Node 22 support — the minimum supported runtime is now Node 24 (LTS).
+
+  Node 22 deadlocks `pikku dev` at `loadUserBootstrap` (tsx `register()` + `require(esm)` cycle handling on node 22.12+), and Node 20 is already below our floor. The `engines.node` requirement is raised to `>=24` across all packages, matching `.nvmrc` and the CI test matrix. Closes #751.
+
+- Updated dependencies [7b17b14]
+- Updated dependencies [daec082]
+- Updated dependencies [e0fd352]
+  - @pikku/core@0.12.58
+
+## 0.12.2
+
+### Patch Changes
+
+- 41ce2cb: Upgrade to TypeScript 6 and raise the minimum Node.js version to 22.
+
+  All packages now build against `typescript@^6.0.3` and declare `engines.node >= 22`. Internal tooling (`ts-json-schema-generator`, `zod-to-ts`) was bumped to TypeScript 6-compatible releases.
+
+- Updated dependencies [41ce2cb]
+  - @pikku/core@0.12.44
+
 ## 0.12.0
 
 ## 0.12.1
@@ -16,7 +40,6 @@
 - Updated dependencies [62a8725]
 - Updated dependencies [62a8725]
 - Updated dependencies [62a8725]
-
   - @pikku/core@0.12.1
 
 - Updated dependencies

package/dist/azure-deployment-service.d.ts

@@ -0,0 +1,13 @@
+import type { DeploymentService, DeploymentConfig } from '@pikku/core/services';
+import type { JWTService } from '@pikku/core/services';
+import type { SecretService } from '@pikku/core/services';
+export declare class AzureDeploymentService implements DeploymentService {
+    private jwt;
+    private secrets;
+    private bindings;
+    constructor(jwt: JWTService | undefined, secrets: SecretService, functionBindings: Record<string, string>);
+    init(): Promise<void>;
+    start(_config: DeploymentConfig): Promise<void>;
+    stop(): Promise<void>;
+    invoke(funcName: string, data: unknown, session?: unknown, traceId?: string): Promise<unknown>;
+}

package/dist/azure-deployment-service.js

@@ -0,0 +1,60 @@
+import { encryptJSON } from '@pikku/core/crypto-utils';
+export class AzureDeploymentService {
+    jwt;
+    secrets;
+    bindings;
+    constructor(jwt, secrets, functionBindings) {
+        this.jwt = jwt;
+        this.secrets = secrets;
+        this.bindings = new Map(Object.entries(functionBindings));
+    }
+    async init() { }
+    async start(_config) { }
+    async stop() { }
+    async invoke(funcName, data, session, traceId) {
+        const functionUrl = this.bindings.get(funcName);
+        if (!functionUrl) {
+            throw new Error(`No Azure Function binding for function '${funcName}'. ` +
+                `Available bindings: ${[...this.bindings.keys()].join(', ')}`);
+        }
+        const headers = {
+            'content-type': 'application/json',
+            ...(traceId && { 'x-request-id': traceId }),
+        };
+        let secret;
+        try {
+            secret = await this.secrets.getSecret('PIKKU_REMOTE_SECRET');
+        }
+        catch { }
+        if (secret && this.jwt) {
+            const sessionEnc = session
+                ? await encryptJSON(secret, { session })
+                : undefined;
+            const token = await this.jwt.encode({ value: 5, unit: 'minute' }, {
+                aud: 'pikku-remote',
+                fn: funcName,
+                iat: Math.floor(Date.now() / 1000),
+                session: sessionEnc,
+            });
+            headers.authorization = `Bearer ${token}`;
+        }
+        const url = `${functionUrl}/remote/rpc/${encodeURIComponent(funcName)}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ data }),
+        });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = JSON.stringify(await response.json());
+            }
+            catch {
+                errorBody = await response.text();
+            }
+            throw new Error(`Remote RPC call to '${funcName}' failed: ${response.status} ${response.statusText}. ${errorBody}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=azure-deployment-service.js.map

package/dist/azure-deployment-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-deployment-service.js","sourceRoot":"","sources":["../src/azure-deployment-service.ts"],"names":[],"mappings":"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"}

package/dist/azure-queue-service.d.ts

@@ -0,0 +1,11 @@
+import type { QueueService, QueueJob, JobOptions } from '@pikku/core/queue';
+export declare class AzureQueueService implements QueueService {
+    readonly supportsResults = false;
+    private queueServiceClient;
+    private queueClients;
+    constructor(connectionString?: string);
+    add<T>(queueName: string, data: T, options?: JobOptions): Promise<string>;
+    getJob<T, R>(_queueName: string, _jobId: string): Promise<QueueJob<T, R> | null>;
+    private getQueueClient;
+    private resolveQueueName;
+}

package/dist/azure-queue-service.js

@@ -0,0 +1,53 @@
+import { QueueServiceClient } from '@azure/storage-queue';
+export class AzureQueueService {
+    supportsResults = false;
+    queueServiceClient;
+    queueClients = new Map();
+    constructor(connectionString) {
+        const connStr = connectionString ?? process.env.AzureWebJobsStorage;
+        if (!connStr) {
+            throw new Error('Azure Queue connection string not provided; supply connectionString or set AzureWebJobsStorage');
+        }
+        this.queueServiceClient = QueueServiceClient.fromConnectionString(connStr);
+    }
+    async add(queueName, data, options) {
+        const client = this.getQueueClient(queueName);
+        const messageId = crypto.randomUUID();
+        const message = {
+            id: messageId,
+            queueName,
+            data,
+            pikkuUserId: options?.pikkuUserId,
+        };
+        const encoded = Buffer.from(JSON.stringify(message)).toString('base64');
+        const visibilityTimeout = options?.delay
+            ? Math.min(Math.ceil(options.delay / 1000), 604800)
+            : undefined;
+        await client.sendMessage(encoded, { visibilityTimeout });
+        return messageId;
+    }
+    async getJob(_queueName, _jobId) {
+        throw new Error('AzureQueueService does not support getJob(). ' +
+            'Azure Storage Queues are fire-and-forget. ' +
+            'Use BullMQ or PgBoss if you need job result tracking.');
+    }
+    getQueueClient(queueName) {
+        if (!this.queueClients.has(queueName)) {
+            const resolvedName = this.resolveQueueName(queueName);
+            const client = this.queueServiceClient.getQueueClient(resolvedName);
+            this.queueClients.set(queueName, client);
+        }
+        return this.queueClients.get(queueName);
+    }
+    resolveQueueName(queueName) {
+        const envKey = `AZURE_QUEUE_NAME_${toScreamingSnake(queueName)}`;
+        return process.env[envKey] ?? queueName;
+    }
+}
+function toScreamingSnake(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/-/g, '_')
+        .toUpperCase();
+}
+//# sourceMappingURL=azure-queue-service.js.map

package/dist/azure-queue-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-queue-service.js","sourceRoot":"","sources":["../src/azure-queue-service.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAIzD,MAAM,OAAO,iBAAiB;IACnB,eAAe,GAAG,KAAK,CAAA;IACxB,kBAAkB,CAAoB;IACtC,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAA;IAErD,YAAY,gBAAyB;QACnC,MAAM,OAAO,GAAG,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAA;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAA;QACH,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAC5E,CAAC;IAED,KAAK,CAAC,GAAG,CACP,SAAiB,EACjB,IAAO,EACP,OAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QAErC,MAAM,OAAO,GAAG;YACd,EAAE,EAAE,SAAS;YACb,SAAS;YACT,IAAI;YACJ,WAAW,EAAE,OAAO,EAAE,WAAW;SAClC,CAAA;QAGD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAEvE,MAAM,iBAAiB,GAAG,OAAO,EAAE,KAAK;YACtC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,MAAM,CAAC;YACnD,CAAC,CAAC,SAAS,CAAA;QAEb,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAA;QACxD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,MAAc;QAEd,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC7C,4CAA4C;YAC5C,uDAAuD,CAC1D,CAAA;IACH,CAAC;IAEO,cAAc,CAAC,SAAiB;QACtC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAA;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;YACnE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAE,CAAA;IAC1C,CAAC;IAMO,gBAAgB,CAAC,SAAiB;QACxC,MAAM,MAAM,GAAG,oBAAoB,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAA;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,CAAA;IACzC,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,WAAW,EAAE,CAAA;AAClB,CAAC"}

package/dist/handler-factories.d.ts

@@ -0,0 +1,13 @@
+import { LocalVariablesService } from '@pikku/core/services';
+import type { CoreSingletonServices } from '@pikku/core';
+import type { HttpRequest, HttpResponseInit, InvocationContext } from '@azure/functions';
+export interface AzureServiceFactories {
+    createConfig: (variables: LocalVariablesService, ...args: unknown[]) => Promise<unknown>;
+    createSingletonServices: (config: unknown, existingServices?: Partial<Record<string, unknown>>) => Promise<CoreSingletonServices>;
+    createPlatformServices?: () => Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+export declare function createAzureHandler(factories: AzureServiceFactories, handlerTypes: string[]): Record<string, unknown>;
+export declare function createAzureWorkerHandler(factories: AzureServiceFactories): Record<string, unknown>;
+export declare function createAzureWebSocketHandler(_factories: AzureServiceFactories): {
+    negotiate(_request: HttpRequest, _context: InvocationContext): Promise<HttpResponseInit>;
+};

package/dist/handler-factories.js

@@ -0,0 +1,121 @@
+import { LocalVariablesService, LocalSecretService } from '@pikku/core/services';
+import { PikkuFetchHTTPResponse, fetchData } from '@pikku/core/http';
+import { runQueueJob } from '@pikku/core/queue';
+import { runScheduledTask, getScheduledTasks } from '@pikku/core/scheduler';
+let cachedServices = null;
+async function setupServices(factories) {
+    if (cachedServices)
+        return cachedServices;
+    const variables = new LocalVariablesService(process.env);
+    const config = await factories.createConfig(variables);
+    const secrets = new LocalSecretService(variables);
+    const platformServices = factories.createPlatformServices
+        ? await factories.createPlatformServices()
+        : {};
+    cachedServices = await factories.createSingletonServices(config, {
+        variables,
+        secrets,
+        ...platformServices,
+    });
+    return cachedServices;
+}
+export function createAzureHandler(factories, handlerTypes) {
+    const result = {};
+    if (handlerTypes.includes('fetch')) {
+        result.http = async (request, _context) => {
+            await setupServices(factories);
+            const body = request.method !== 'GET' && request.method !== 'HEAD'
+                ? await request.text()
+                : undefined;
+            const webRequest = new Request(request.url, {
+                method: request.method,
+                headers: Object.fromEntries(request.headers.entries()),
+                body,
+            });
+            const response = new PikkuFetchHTTPResponse();
+            try {
+                await fetchData(webRequest, response);
+            }
+            catch (err) {
+                console.error('Azure HTTP handler: fetchData error', err);
+            }
+            const fetchResponse = response.toResponse();
+            const headers = {};
+            fetchResponse.headers.forEach((value, key) => {
+                headers[key] = value;
+            });
+            return {
+                status: fetchResponse.status,
+                headers,
+                body: await fetchResponse.text(),
+            };
+        };
+    }
+    if (handlerTypes.includes('queue')) {
+        result.queue = async (queueItem, context) => {
+            await setupServices(factories);
+            let data;
+            if (typeof queueItem === 'string') {
+                try {
+                    data = JSON.parse(queueItem);
+                }
+                catch {
+                    data = { body: queueItem };
+                }
+            }
+            else {
+                data = queueItem;
+            }
+            const queueName = data.queueName ??
+                context.triggerMetadata?.queueTrigger ??
+                'unknown';
+            const job = {
+                queueName,
+                data: data.data ?? data,
+                id: context.invocationId,
+                status: async () => 'active',
+                metadata: () => ({
+                    processedAt: new Date(),
+                    attemptsMade: context.triggerMetadata?.dequeueCount ?? 0,
+                    maxAttempts: undefined,
+                    result: undefined,
+                    progress: 0,
+                    createdAt: new Date(),
+                    completedAt: undefined,
+                    failedAt: undefined,
+                    error: undefined,
+                }),
+                waitForCompletion: async () => {
+                    throw new Error('Azure Storage Queues do not support waitForCompletion');
+                },
+            };
+            await runQueueJob({ job });
+        };
+    }
+    if (handlerTypes.includes('scheduled')) {
+        result.timer = async (_timer, _context) => {
+            await setupServices(factories);
+            const traceId = `cron-${crypto.randomUUID()}`;
+            const scheduledTasks = getScheduledTasks();
+            for (const [name] of scheduledTasks) {
+                await runScheduledTask({ name, traceId });
+            }
+        };
+    }
+    return result;
+}
+export function createAzureWorkerHandler(factories) {
+    const handlers = createAzureHandler(factories, ['fetch']);
+    return handlers;
+}
+export function createAzureWebSocketHandler(_factories) {
+    return {
+        async negotiate(_request, _context) {
+            return {
+                status: 501,
+                body: 'WebSocket via Azure Web PubSub not yet implemented',
+            };
+        },
+    };
+}
+//# sourceMappingURL=handler-factories.js.map

package/dist/handler-factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-factories.js","sourceRoot":"","sources":["../src/handler-factories.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,2 +1,5 @@
 export * from './pikku-az-functions-logger.js';
 export * from './pikku-az-timer-request.js';
+export * from './handler-factories.js';
+export { AzureQueueService } from './azure-queue-service.js';
+export { AzureDeploymentService } from './azure-deployment-service.js';

package/dist/index.js

@@ -1,3 +1,6 @@
 export * from './pikku-az-functions-logger.js';
 export * from './pikku-az-timer-request.js';
+export * from './handler-factories.js';
+export { AzureQueueService } from './azure-queue-service.js';
+export { AzureDeploymentService } from './azure-deployment-service.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/azure-functions",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "license": "MIT",
   "author": "yasser.fadl@gmail.com",
   "module": "dist/index.js",
@@ -13,18 +13,23 @@
     "release": "npm run build && npm test",
     "test": "bash run-tests.sh",
     "test:watch": "bash run-tests.sh --watch",
-    "test:coverage": "bash run-tests.sh --coverage"
+    "test:coverage": "bash run-tests.sh --coverage",
+    "prepublishOnly": "yarn build"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.1"
+    "@pikku/core": "^0.12.58"
   },
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=24"
   },
   "dependencies": {
-    "@azure/functions": "4.11.2"
+    "@azure/functions": "4.11.2",
+    "@azure/storage-queue": "^12.25.0"
+  },
+  "exports": {
+    ".": "./dist/index.js"
   }
 }

package/run-tests.sh

@@ -38,16 +38,16 @@ if [ ${#files[@]} -eq 0 ]; then
 fi
 
 # Construct the node command
-node_cmd="node --import tsx --test"
+node_cmd=(node --import tsx --test)
 
 # Append options based on flags
 if [ "$watch_mode" = true ]; then
-  node_cmd="$node_cmd --watch"
+  node_cmd+=(--watch)
 fi
 
 if [ "$coverage_mode" = true ]; then
-  node_cmd="$node_cmd --test-coverage-include=\"src/**/*.{ts,js}\" --test-coverage-exclude=\"**/dist/**\" --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=lcov.info"
+  node_cmd+=(--test-coverage-include="src/**/*.{ts,js}" --test-coverage-exclude="**/dist/**" --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=lcov.info)
 fi
 
 # Execute the node command with the expanded list of files
-$node_cmd "${files[@]}"
+"${node_cmd[@]}" "${files[@]}"

package/src/azure-deployment-service.ts

@@ -0,0 +1,94 @@
+/**
+ * Azure Functions deployment service — routes remote() calls via HTTP.
+ *
+ * When a gateway (agent, MCP, channel, workflow orchestrator) calls
+ * remote('funcName'), this service dispatches to the function's
+ * Azure Function via HTTP. Uses the function's URL endpoint.
+ *
+ * Session propagation uses the existing pikkuRemoteAuthMiddleware:
+ * JWT signed with PIKKU_REMOTE_SECRET, session encrypted in payload.
+ */
+
+import type { DeploymentService, DeploymentConfig } from '@pikku/core/services'
+import type { JWTService } from '@pikku/core/services'
+import type { SecretService } from '@pikku/core/services'
+import { encryptJSON } from '@pikku/core/crypto-utils'
+
+export class AzureDeploymentService implements DeploymentService {
+  private bindings: Map<string, string>
+
+  constructor(
+    private jwt: JWTService | undefined,
+    private secrets: SecretService,
+    functionBindings: Record<string, string>
+  ) {
+    this.bindings = new Map(Object.entries(functionBindings))
+  }
+
+  async init(): Promise<void> {}
+  async start(_config: DeploymentConfig): Promise<void> {}
+  async stop(): Promise<void> {}
+
+  async invoke(
+    funcName: string,
+    data: unknown,
+    session?: unknown,
+    traceId?: string
+  ): Promise<unknown> {
+    const functionUrl = this.bindings.get(funcName)
+    if (!functionUrl) {
+      throw new Error(
+        `No Azure Function binding for function '${funcName}'. ` +
+          `Available bindings: ${[...this.bindings.keys()].join(', ')}`
+      )
+    }
+
+    const headers: Record<string, string> = {
+      'content-type': 'application/json',
+      ...(traceId && { 'x-request-id': traceId }),
+    }
+
+    // Sign session as JWT for pikkuRemoteAuthMiddleware
+    let secret: string | undefined
+    try {
+      secret = await this.secrets.getSecret('PIKKU_REMOTE_SECRET')
+    } catch {}
+
+    if (secret && this.jwt) {
+      const sessionEnc = session
+        ? await encryptJSON(secret, { session })
+        : undefined
+      const token = await this.jwt.encode(
+        { value: 5, unit: 'minute' },
+        {
+          aud: 'pikku-remote',
+          fn: funcName,
+          iat: Math.floor(Date.now() / 1000),
+          session: sessionEnc,
+        }
+      )
+      headers.authorization = `Bearer ${token}`
+    }
+
+    const url = `${functionUrl}/remote/rpc/${encodeURIComponent(funcName)}`
+    const response = await fetch(url, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify({ data }),
+    })
+
+    if (!response.ok) {
+      let errorBody: string
+      try {
+        errorBody = JSON.stringify(await response.json())
+      } catch {
+        errorBody = await response.text()
+      }
+      throw new Error(
+        `Remote RPC call to '${funcName}' failed: ${response.status} ${response.statusText}. ${errorBody}`
+      )
+    }
+
+    return response.json()
+  }
+}

package/src/azure-queue-service.ts

@@ -0,0 +1,90 @@
+/**
+ * Azure Storage Queue implementation of QueueService (producer side).
+ *
+ * Sends messages to Azure Storage Queues. Queue URLs are resolved from
+ * environment variables following the convention:
+ * AZURE_QUEUE_NAME_<SCREAMING_SNAKE> (queue name) with the connection
+ * string from AzureWebJobsStorage.
+ */
+
+import { QueueServiceClient } from '@azure/storage-queue'
+import type { QueueClient } from '@azure/storage-queue'
+import type { QueueService, QueueJob, JobOptions } from '@pikku/core/queue'
+
+export class AzureQueueService implements QueueService {
+  readonly supportsResults = false
+  private queueServiceClient: QueueServiceClient
+  private queueClients = new Map<string, QueueClient>()
+
+  constructor(connectionString?: string) {
+    const connStr = connectionString ?? process.env.AzureWebJobsStorage
+    if (!connStr) {
+      throw new Error(
+        'Azure Queue connection string not provided; supply connectionString or set AzureWebJobsStorage'
+      )
+    }
+    this.queueServiceClient = QueueServiceClient.fromConnectionString(connStr)
+  }
+
+  async add<T>(
+    queueName: string,
+    data: T,
+    options?: JobOptions
+  ): Promise<string> {
+    const client = this.getQueueClient(queueName)
+    const messageId = crypto.randomUUID()
+
+    const message = {
+      id: messageId,
+      queueName,
+      data,
+      pikkuUserId: options?.pikkuUserId,
+    }
+
+    // Azure Storage Queue messages must be base64-encoded strings
+    const encoded = Buffer.from(JSON.stringify(message)).toString('base64')
+
+    const visibilityTimeout = options?.delay
+      ? Math.min(Math.ceil(options.delay / 1000), 604800) // max 7 days
+      : undefined
+
+    await client.sendMessage(encoded, { visibilityTimeout })
+    return messageId
+  }
+
+  async getJob<T, R>(
+    _queueName: string,
+    _jobId: string
+  ): Promise<QueueJob<T, R> | null> {
+    throw new Error(
+      'AzureQueueService does not support getJob(). ' +
+        'Azure Storage Queues are fire-and-forget. ' +
+        'Use BullMQ or PgBoss if you need job result tracking.'
+    )
+  }
+
+  private getQueueClient(queueName: string): QueueClient {
+    if (!this.queueClients.has(queueName)) {
+      const resolvedName = this.resolveQueueName(queueName)
+      const client = this.queueServiceClient.getQueueClient(resolvedName)
+      this.queueClients.set(queueName, client)
+    }
+    return this.queueClients.get(queueName)!
+  }
+
+  /**
+   * Resolves the Azure queue name. Checks env var
+   * AZURE_QUEUE_NAME_<SCREAMING_SNAKE> first, falls back to the name as-is.
+   */
+  private resolveQueueName(queueName: string): string {
+    const envKey = `AZURE_QUEUE_NAME_${toScreamingSnake(queueName)}`
+    return process.env[envKey] ?? queueName
+  }
+}
+
+function toScreamingSnake(name: string): string {
+  return name
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+    .replace(/-/g, '_')
+    .toUpperCase()
+}

package/src/handler-factories.ts

@@ -0,0 +1,205 @@
+/**
+ * Azure Functions handler factories — mirrors Lambda/CF handler factories.
+ *
+ * Creates handlers for Azure Functions v4 programming model:
+ * - HTTP triggers (HttpRequest → HttpResponseInit)
+ * - Storage Queue triggers (QueueItem → void)
+ * - Timer triggers (Timer → void)
+ *
+ * Services are cached across invocations within the same function app instance.
+ */
+
+import { LocalVariablesService, LocalSecretService } from '@pikku/core/services'
+import type { CoreSingletonServices } from '@pikku/core'
+import { PikkuFetchHTTPResponse, fetchData } from '@pikku/core/http'
+import { runQueueJob } from '@pikku/core/queue'
+import type { QueueJob, QueueJobStatus } from '@pikku/core/queue'
+import { runScheduledTask, getScheduledTasks } from '@pikku/core/scheduler'
+import type {
+  HttpRequest,
+  HttpResponseInit,
+  InvocationContext,
+  Timer,
+} from '@azure/functions'
+
+export interface AzureServiceFactories {
+  createConfig: (
+    variables: LocalVariablesService,
+    ...args: unknown[]
+  ) => Promise<unknown>
+  createSingletonServices: (
+    config: unknown,
+    existingServices?: Partial<Record<string, unknown>>
+  ) => Promise<CoreSingletonServices>
+  createPlatformServices?: () =>
+    | Record<string, unknown>
+    | Promise<Record<string, unknown>>
+}
+
+let cachedServices: CoreSingletonServices | null = null
+
+async function setupServices(
+  factories: AzureServiceFactories
+): Promise<CoreSingletonServices> {
+  if (cachedServices) return cachedServices
+  const variables = new LocalVariablesService(
+    process.env as Record<string, string | undefined>
+  )
+  const config = await factories.createConfig(variables)
+  const secrets = new LocalSecretService(variables)
+
+  const platformServices = factories.createPlatformServices
+    ? await factories.createPlatformServices()
+    : {}
+
+  cachedServices = await factories.createSingletonServices(config, {
+    variables,
+    secrets,
+    ...platformServices,
+  })
+  return cachedServices
+}
+
+/**
+ * Creates combined Azure Function handlers based on which handler types
+ * the unit needs. Returns an object with named handler functions that
+ * the entry file registers via app.http(), app.storageQueue(), app.timer().
+ */
+export function createAzureHandler(
+  factories: AzureServiceFactories,
+  handlerTypes: string[]
+) {
+  const result: Record<string, unknown> = {}
+
+  if (handlerTypes.includes('fetch')) {
+    result.http = async (
+      request: HttpRequest,
+      _context: InvocationContext
+    ): Promise<HttpResponseInit> => {
+      await setupServices(factories)
+
+      // Convert Azure HttpRequest to standard Request
+      const body =
+        request.method !== 'GET' && request.method !== 'HEAD'
+          ? await request.text()
+          : undefined
+      const webRequest = new Request(request.url, {
+        method: request.method,
+        headers: Object.fromEntries(request.headers.entries()),
+        body,
+      })
+
+      const response = new PikkuFetchHTTPResponse()
+      try {
+        await fetchData(webRequest, response)
+      } catch (err) {
+        console.error('Azure HTTP handler: fetchData error', err)
+      }
+
+      const fetchResponse = response.toResponse()
+      const headers: Record<string, string> = {}
+      fetchResponse.headers.forEach((value, key) => {
+        headers[key] = value
+      })
+
+      return {
+        status: fetchResponse.status,
+        headers,
+        body: await fetchResponse.text(),
+      }
+    }
+  }
+
+  if (handlerTypes.includes('queue')) {
+    result.queue = async (
+      queueItem: unknown,
+      context: InvocationContext
+    ): Promise<void> => {
+      await setupServices(factories)
+
+      let data: Record<string, unknown>
+      if (typeof queueItem === 'string') {
+        try {
+          data = JSON.parse(queueItem)
+        } catch {
+          data = { body: queueItem }
+        }
+      } else {
+        data = queueItem as Record<string, unknown>
+      }
+
+      const queueName =
+        (data.queueName as string) ??
+        context.triggerMetadata?.queueTrigger ??
+        'unknown'
+
+      const job: QueueJob = {
+        queueName,
+        data: data.data ?? data,
+        id: context.invocationId,
+        status: async () => 'active' as QueueJobStatus,
+        metadata: () => ({
+          processedAt: new Date(),
+          attemptsMade: (context.triggerMetadata?.dequeueCount as number) ?? 0,
+          maxAttempts: undefined,
+          result: undefined,
+          progress: 0,
+          createdAt: new Date(),
+          completedAt: undefined,
+          failedAt: undefined,
+          error: undefined,
+        }),
+        waitForCompletion: async () => {
+          throw new Error(
+            'Azure Storage Queues do not support waitForCompletion'
+          )
+        },
+      }
+
+      await runQueueJob({ job })
+    }
+  }
+
+  if (handlerTypes.includes('scheduled')) {
+    result.timer = async (
+      _timer: Timer,
+      _context: InvocationContext
+    ): Promise<void> => {
+      await setupServices(factories)
+      const traceId = `cron-${crypto.randomUUID()}`
+      const scheduledTasks = getScheduledTasks()
+      for (const [name] of scheduledTasks) {
+        await runScheduledTask({ name, traceId })
+      }
+    }
+  }
+
+  return result
+}
+
+/**
+ * Creates an Azure Function handler with an HTTP trigger for gateway units.
+ */
+export function createAzureWorkerHandler(factories: AzureServiceFactories) {
+  const handlers = createAzureHandler(factories, ['fetch'])
+  return handlers
+}
+
+/**
+ * Creates Azure Function handlers for WebSocket channel units.
+ * Uses HTTP negotiation endpoint for Azure Web PubSub.
+ */
+export function createAzureWebSocketHandler(_factories: AzureServiceFactories) {
+  return {
+    async negotiate(
+      _request: HttpRequest,
+      _context: InvocationContext
+    ): Promise<HttpResponseInit> {
+      // Web PubSub negotiation — to be implemented with @azure/web-pubsub
+      return {
+        status: 501,
+        body: 'WebSocket via Azure Web PubSub not yet implemented',
+      }
+    },
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,13 @@
+import assert from 'node:assert/strict'
+import { describe, test } from 'node:test'
+
+import * as azureFunctions from './index.js'
+
+describe('@pikku/azure-functions', () => {
+  test('exports the azure runtime API', () => {
+    assert.equal(typeof azureFunctions.createAzureHandler, 'function')
+    assert.equal(typeof azureFunctions.AzureDeploymentService, 'function')
+    assert.equal(typeof azureFunctions.AzureQueueService, 'function')
+    assert.equal(typeof azureFunctions.AzInvocationLogger, 'function')
+  })
+})

package/src/index.ts

@@ -1,2 +1,5 @@
 export * from './pikku-az-functions-logger.js'
 export * from './pikku-az-timer-request.js'
+export * from './handler-factories.js'
+export { AzureQueueService } from './azure-queue-service.js'
+export { AzureDeploymentService } from './azure-deployment-service.js'

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/index.ts","./src/pikku-az-functions-logger.ts","./src/pikku-az-timer-request.ts"],"version":"5.9.3"}
+{"root":["./src/azure-deployment-service.ts","./src/azure-queue-service.ts","./src/handler-factories.ts","./src/index.ts","./src/pikku-az-functions-logger.ts","./src/pikku-az-timer-request.ts"],"version":"6.0.3"}