@pikku/azure-functions 0.12.7 → 0.12.9

package/CHANGELOG.md

@@ -1,3 +1,49 @@
+## 0.12.9
+
+### Patch Changes
+
+- 4c7a1b5: Run the monorepo's own scripts through bun instead of yarn. What moves is the
+  package manager each package's `prepublishOnly` and build scripts invoke, plus
+  the two manifest fixes bun needs to resolve the tree: `uWebSockets.js` is
+  declared with an explicit `github:` specifier, and `@pikku/uws-handler` marks
+  its `uWebSockets.js` peer optional so a bun install of a consumer that brings
+  its own uWS app does not try to fetch it from the registry.
+
+  Three published behaviours change, all of them cases where an isolated
+  `node_modules` or bun as the runtime had been papered over by yarn's hoisting:
+
+  - `@pikku/migrator-sql` turns foreign keys on when it opens a sqlite database
+    through bun. `node:sqlite` enforces them by default and `bun:sqlite` does not,
+    which silently turned every `ON DELETE CASCADE` into a no-op under
+    `bunx --bun pikku`.
+  - `@pikku/cli` resolves a deploy provider against the project being deployed
+    rather than against wherever the CLI itself is installed, which is what its
+    own "is not installed" error asks the user to arrange.
+  - `@pikku/cli` treats a specifier a runtime hands straight back — bun does this
+    for the modules it implements itself — as not resolved from the project, so
+    it falls back rather than loading the runtime's own copy.
+
+- Updated dependencies [4c7a1b5]
+  - @pikku/core@0.12.108
+
+## 0.12.8
+
+### Patch Changes
+
+- 3a83f85: Stop re-exporting package internals through entry points
+
+  66 names reached consumers only because an `export *` in an entry point swept
+  them up. Each one is referenced solely inside its own package, so the star is
+  now an explicit named re-export listing what is genuinely public. The
+  declarations themselves are untouched — this narrows the entry point, not the
+  module.
+
+- Updated dependencies [9687ad1]
+- Updated dependencies [2d21628]
+- Updated dependencies [985b87b]
+- Updated dependencies [3a83f85]
+  - @pikku/core@0.12.87
+
 ## 0.12.7
 
 ### Patch Changes

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

@@ -1 +1 @@
-{"version":3,"file":"azure-deployment-service.js","sourceRoot":"","sources":["../src/azure-deployment-service.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,OAAO,sBAAsB;IAIvB;IACA;IAJF,QAAQ,CAAqB;IAErC,YACU,GAA2B,EAC3B,OAAsB,EAC9B,gBAAwC;QAFhC,QAAG,GAAH,GAAG,CAAwB;QAC3B,YAAO,GAAP,OAAO,CAAe;QAG9B,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,KAAK,CAAC,OAAyB,IAAkB,CAAC;IACxD,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,IAAa,EACb,OAAiB,EACjB,OAAgB;QAEhB,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,KAAK;gBACtD,uBAAuB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CACtC,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,OAAO,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,CACR,CAAA;QAED,MAAM,GAAG,GAAG,GAAG,WAAW,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAA;QACvE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;SAC/B,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAiB,CAAA;YACrB,IAAI,CAAC;gBACH,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YACnC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,aAAa,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CACnG,CAAA;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;CACF"}
+{"version":3,"file":"azure-deployment-service.js","sourceRoot":"","sources":["../src/azure-deployment-service.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,OAAO,sBAAsB;IAIvB,GAAG;IACH,OAAO;IAJT,QAAQ,CAAqB;IAErC,YACU,GAA2B,EAC3B,OAAsB,EAC9B,gBAAwC;mBAFhC,GAAG;uBACH,OAAO;QAGf,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,KAAK,CAAC,OAAyB,IAAkB,CAAC;IACxD,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,IAAa,EACb,OAAiB,EACjB,OAAgB;QAEhB,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,KAAK;gBACtD,uBAAuB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CACtC,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,OAAO,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,CACR,CAAA;QAED,MAAM,GAAG,GAAG,GAAG,WAAW,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAA;QACvE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;SAC/B,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAiB,CAAA;YACrB,IAAI,CAAC;gBACH,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YACnC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,aAAa,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CACnG,CAAA;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;CACF"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,6 +1,6 @@
 export * from './pikku-az-functions-logger.js';
 export * from './pikku-az-timer-request.js';
-export * from './handler-factories.js';
+export { createAzureHandler, createAzureWorkerHandler, createAzureWebSocketHandler, } 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;AAC3C,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/pikku-az-functions-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-az-functions-logger.js","sourceRoot":"","sources":["../src/pikku-az-functions-logger.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,kBAAkB;IAGT;IAApB,YAAoB,OAA0B;QAA1B,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAE3C,IAAI,CACT,YAAqB,EACrB,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAmB,EAAE,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC;IAEM,IAAI,CACT,YAAqB,EACrB,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAmB,EAAE,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC;IAEM,KAAK,CAGV,YAAqB,EAAE,GAAG,IAAoC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAmB,EAAE,GAAG,IAAI,CAAC,CAAA;IAClD,CAAC;IAEM,KAAK,CACV,OAAe,EACf,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IAEM,KAAK,CACV,OAAe,EACf,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IAEM,QAAQ,CAAC,KAAe;IAE/B,CAAC;CACF"}
+{"version":3,"file":"pikku-az-functions-logger.js","sourceRoot":"","sources":["../src/pikku-az-functions-logger.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,kBAAkB;IAGT,OAAO;IAA3B,YAAoB,OAA0B;uBAA1B,OAAO;IAAsB,CAAC;IAE3C,IAAI,CACT,YAAqB,EACrB,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAmB,EAAE,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC;IAEM,IAAI,CACT,YAAqB,EACrB,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAmB,EAAE,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC;IAEM,KAAK,CAGV,YAAqB,EAAE,GAAG,IAAoC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAmB,EAAE,GAAG,IAAI,CAAC,CAAA;IAClD,CAAC;IAEM,KAAK,CACV,OAAe,EACf,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IAEM,KAAK,CACV,OAAe,EACf,GAAG,IAAoC;QAEvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IAEM,QAAQ,CAAC,KAAe;IAE/B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@pikku/azure-functions",
-  "version": "0.12.7",
+  "version": "0.12.9",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pikkujs/pikku.git",
+    "directory": "packages/runtimes/azure-functions"
+  },
   "description": "Azure Functions runtime for Pikku — HTTP, timer and storage-queue handlers",
   "license": "MIT",
   "author": "yasser.fadl@gmail.com",
@@ -15,13 +20,10 @@
     "test": "bash run-tests.sh",
     "test:watch": "bash run-tests.sh --watch",
     "test:coverage": "bash run-tests.sh --coverage",
-    "prepublishOnly": "yarn build"
+    "prepublishOnly": "bun run build"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.85"
-  },
-  "devDependencies": {
-    "typescript": "^6.0.3"
+    "@pikku/core": "^0.12.108"
   },
   "engines": {
     "node": ">=24"
@@ -33,4 +35,4 @@
   "exports": {
     ".": "./dist/index.js"
   }
-}
+}

package/run-tests.sh

@@ -34,20 +34,35 @@ files=($(find src -type f -name "*.test.ts"))
 # Check if any files matched the pattern
 if [ ${#files[@]} -eq 0 ]; then
   echo "No test files found matching pattern: $pattern"
+  if [ "${STRICT_TEST_DISCOVERY}" = "1" ]; then
+    exit 1
+  fi
   exit 0
 fi
 
-# Construct the node command
-node_cmd=(node --import tsx --test)
+# Construct the bun command
+#
+# --parallel gives every test file its own worker process, which is what node's
+# `--test` did. Several suites keep module-level caches (a TypeScript program, a
+# temp fixture directory) that a shared process would leak between files.
+#
+# --timeout because bun caps a test at 5s by default where node had no cap, and
+# the suites that build real TypeScript programs run well past that.
+bun_cmd=(bun test --parallel --timeout 120000)
 
 # Append options based on flags
 if [ "$watch_mode" = true ]; then
-  node_cmd+=(--watch)
+  # --watch reruns in one process; parallel workers have nothing to watch.
+  bun_cmd=(bun test --watch --timeout 120000)
 fi
 
 if [ "$coverage_mode" = true ]; then
-  node_cmd+=(--test-coverage-include="src/**/*.{ts,js}" --test-coverage-exclude="**/dist/**" --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=lcov.info)
+  # --coverage-dir=. keeps lcov.info at the package root: CI merges every
+  # package's report by prefixing its SF paths with the file's own directory,
+  # so a nested coverage/ directory would re-root them one level too deep.
+  bun_cmd+=(--coverage --coverage-reporter=lcov --coverage-reporter=text --coverage-dir=.)
+  export PIKKU_TEST_COVERAGE=1
 fi
 
-# Execute the node command with the expanded list of files
-"${node_cmd[@]}" "${files[@]}"
+# Execute the bun command with the expanded list of files
+"${bun_cmd[@]}" "${files[@]}"

package/src/azure-deployment-service.ts

@@ -1,75 +0,0 @@
-/**
- * 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 { buildRemoteHeaders } from '@pikku/core/remote'
-
-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 = await buildRemoteHeaders(
-      this.jwt,
-      this.secrets,
-      funcName,
-      session,
-      traceId
-    )
-
-    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

@@ -1,91 +0,0 @@
-/**
- * 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 } from '@pikku/core/queue'
-import type { 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

@@ -1,205 +0,0 @@
-/**
- * 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/types'
-import { PikkuFetchHTTPResponse, fetchData } from '@pikku/core/http'
-import { runQueueJob } from '@pikku/core/queue'
-import type { QueueJob, QueueJobStatus } from '@pikku/core/queue'
-import { runScheduledTask } from '@pikku/core/scheduler'
-import { 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

@@ -1,13 +0,0 @@
-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,5 +0,0 @@
-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/src/pikku-az-functions-logger.ts

@@ -1,48 +0,0 @@
-import type { InvocationContext } from '@azure/functions'
-import type { Logger, LogLevel } from '@pikku/core/services'
-import type { Safe } from '@pikku/core/classification'
-
-export class AzInvocationLogger implements Logger {
-  // private logLevel: LogLevel = LogLevel.info
-
-  constructor(private context: InvocationContext) {}
-
-  public info<M extends string | Record<string, any>, A extends unknown[]>(
-    messageOrObj: Safe<M>,
-    ...meta: { [K in keyof A]: Safe<A[K]> }
-  ): void {
-    this.context.info(messageOrObj as any, ...meta)
-  }
-
-  public warn<M extends string | Record<string, any>, A extends unknown[]>(
-    messageOrObj: Safe<M>,
-    ...meta: { [K in keyof A]: Safe<A[K]> }
-  ): void {
-    this.context.warn(messageOrObj as any, ...meta)
-  }
-
-  public error<
-    M extends string | Record<string, any> | Error,
-    A extends unknown[],
-  >(messageOrObj: Safe<M>, ...meta: { [K in keyof A]: Safe<A[K]> }): void {
-    this.context.error(messageOrObj as any, ...meta)
-  }
-
-  public debug<A extends unknown[]>(
-    message: string,
-    ...meta: { [K in keyof A]: Safe<A[K]> }
-  ): void {
-    this.context.debug(message, ...meta)
-  }
-
-  public trace<A extends unknown[]>(
-    message: string,
-    ...meta: { [K in keyof A]: Safe<A[K]> }
-  ): void {
-    this.context.trace(message, ...meta)
-  }
-
-  public setLevel(level: LogLevel): void {
-    // this.logLevel = level
-  }
-}

package/src/pikku-az-functions-logger.type.test.ts

@@ -1,18 +0,0 @@
-import { createSecretValue } from '@pikku/core/classification'
-import type { AzInvocationLogger } from './pikku-az-functions-logger.js'
-
-// A concrete logger must not be a way around the `Logger` guard.
-const _assertions = (logger: AzInvocationLogger) => {
-  const secret = createSecretValue('sk-live-DEADBEEF')
-
-  // @ts-expect-error a secret cannot be logged
-  logger.info(secret)
-  // @ts-expect-error nor nested in the message
-  logger.info({ token: secret })
-  // @ts-expect-error nor in the metadata
-  logger.warn('using', { token: secret })
-
-  logger.info('fine')
-  logger.info({ count: 1 })
-}
-void _assertions

package/src/pikku-az-timer-request.ts

@@ -1,8 +0,0 @@
-import type { InvocationContext } from '@azure/functions'
-import { PikkuRequest } from '@pikku/core/function'
-
-export class PikkuAZTimerRequest<In = any> extends PikkuRequest<In> {
-  constructor(_context: InvocationContext, data: In) {
-    super(data)
-  }
-}

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "rootDir": "./src",
-    "module": "Node18",
-    "outDir": "dist",
-    "target": "esnext",
-    "declaration": true
-  },
-  "include": ["bin/**/*.ts", "src/**/*.ts"],
-  "exclude": ["**/*.test.ts", "node_modules", "bin/dist"],
-  "references": [
-    {
-      "path": "../../core/tsconfig.json"
-    }
-  ]
-}

package/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"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"}

package/tsconfig.type-tests.json

@@ -1,10 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "noEmit": true,
-    "composite": false,
-    "declaration": false,
-    "declarationMap": false
-  },
-  "files": ["src/pikku-az-functions-logger.type.test.ts"]
-}