opennextjs-azure 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,35 @@
+export { A as AzureConfig, a as AzureDeploymentTarget, d as defineAzureConfig } from './shared/opennextjs-azure.d619537c.mjs';
+export { default as azureBlobCache } from './overrides/incrementalCache/azure-blob.mjs';
+export { default as azureTableTagCache } from './overrides/tagCache/azure-table.mjs';
+export { default as azureQueueRevalidation } from './overrides/queue/azure-queue.mjs';
+export { default as azureFunctionsWrapper } from './adapters/wrappers/azure-functions.mjs';
+export { default as azureHttpConverter } from './adapters/converters/azure-http.mjs';
+import '@opennextjs/aws/types/open-next.js';
+import '@opennextjs/aws/types/overrides.js';
+import '@azure/functions';
+
+interface ScaffoldOptions {
+    typescript?: boolean;
+    tailwind?: boolean;
+    eslint?: boolean;
+    srcDir?: boolean;
+    appRouter?: boolean;
+    importAlias?: string;
+    packageManager?: "npm" | "yarn" | "pnpm" | "bun";
+}
+
+declare function init(options?: ScaffoldOptions & {
+    scaffold?: boolean;
+}): Promise<void>;
+
+declare function build(configPath?: string): Promise<void>;
+
+declare function deploy(options: {
+    appName?: string;
+    resourceGroup?: string;
+    location?: string;
+    environment?: "dev" | "staging" | "prod";
+    skipInfrastructure?: boolean;
+}): Promise<void>;
+
+export { build, deploy, init };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+export { A as AzureConfig, a as AzureDeploymentTarget, d as defineAzureConfig } from './shared/opennextjs-azure.d619537c.js';
+export { default as azureBlobCache } from './overrides/incrementalCache/azure-blob.js';
+export { default as azureTableTagCache } from './overrides/tagCache/azure-table.js';
+export { default as azureQueueRevalidation } from './overrides/queue/azure-queue.js';
+export { default as azureFunctionsWrapper } from './adapters/wrappers/azure-functions.js';
+export { default as azureHttpConverter } from './adapters/converters/azure-http.js';
+import '@opennextjs/aws/types/open-next.js';
+import '@opennextjs/aws/types/overrides.js';
+import '@azure/functions';
+
+interface ScaffoldOptions {
+    typescript?: boolean;
+    tailwind?: boolean;
+    eslint?: boolean;
+    srcDir?: boolean;
+    appRouter?: boolean;
+    importAlias?: string;
+    packageManager?: "npm" | "yarn" | "pnpm" | "bun";
+}
+
+declare function init(options?: ScaffoldOptions & {
+    scaffold?: boolean;
+}): Promise<void>;
+
+declare function build(configPath?: string): Promise<void>;
+
+declare function deploy(options: {
+    appName?: string;
+    resourceGroup?: string;
+    location?: string;
+    environment?: "dev" | "staging" | "prod";
+    skipInfrastructure?: boolean;
+}): Promise<void>;
+
+export { build, deploy, init };

package/dist/index.js

@@ -0,0 +1,20 @@
+export { defineAzureConfig } from './config/index.js';
+export { b as build, d as deploy, i as init } from './deploy.js';
+export { default as azureBlobCache } from './overrides/incrementalCache/azure-blob.js';
+export { default as azureTableTagCache } from './overrides/tagCache/azure-table.js';
+export { default as azureQueueRevalidation } from './overrides/queue/azure-queue.js';
+export { default as azureFunctionsWrapper } from './adapters/wrappers/azure-functions.js';
+export { default as azureHttpConverter } from './adapters/converters/azure-http.js';
+import 'node:fs/promises';
+import 'node:path';
+import 'node:url';
+import 'node:child_process';
+import 'node:util';
+import '@opennextjs/aws/build.js';
+import 'node:fs';
+import 'node:readline';
+import '@azure/storage-blob';
+import '@azure/data-tables';
+import '@azure/storage-queue';
+import 'node:stream';
+import 'node:buffer';

package/dist/infrastructure/main.bicep

@@ -0,0 +1,241 @@
+// OpenNext Azure - Main Infrastructure Template
+// This creates all resources needed to run a Next.js app on Azure
+//
+// DO NOT EDIT THIS FILE, IT IS AUTO-GENERATED.
+
+@description('Name of the application (used as prefix for all resources)')
+param appName string
+
+@description('Location for all resources')
+param location string = resourceGroup().location
+
+@description('Environment (dev, staging, prod)')
+@allowed(['dev', 'staging', 'prod'])
+param environment string = 'dev'
+
+@description('Node.js version for Functions')
+@allowed(['20', '22'])
+param nodeVersion string = '20'
+
+@description('Enable Application Insights for monitoring and logging')
+param enableApplicationInsights bool = false
+
+// Variables
+var uniqueSuffix = uniqueString(resourceGroup().id)
+var sanitizedAppName = replace(toLower(appName), '-', '')
+var maxAppNameLength = 24 - length(uniqueSuffix)
+var truncatedAppName = length(sanitizedAppName) > maxAppNameLength
+  ? substring(sanitizedAppName, 0, maxAppNameLength)
+  : sanitizedAppName
+var storageAccountName = '${truncatedAppName}${uniqueSuffix}'
+var functionAppName = '${appName}-func-${environment}'
+var appServicePlanName = '${appName}-plan-${environment}'
+var containerName = 'nextjs-cache'
+var tableName = 'nextjstags'
+var queueName = 'nextjsrevalidation'
+var applicationInsightsName = '${appName}-insights-${environment}'
+
+// Application Insights (optional)
+resource applicationInsights 'Microsoft.Insights/components@2020-02-02' = if (enableApplicationInsights) {
+  name: applicationInsightsName
+  location: location
+  kind: 'web'
+  properties: {
+    Application_Type: 'web'
+    Request_Source: 'rest'
+    RetentionInDays: environment == 'prod' ? 90 : 30
+    publicNetworkAccessForIngestion: 'Enabled'
+    publicNetworkAccessForQuery: 'Enabled'
+  }
+}
+
+// Storage Account (for cache, static assets, and function storage)
+resource storageAccount 'Microsoft.Storage/storageAccounts@2023-01-01' = {
+  name: storageAccountName
+  location: location
+  sku: {
+    name: environment == 'prod' ? 'Standard_GRS' : 'Standard_LRS'
+  }
+  kind: 'StorageV2'
+  properties: {
+    minimumTlsVersion: 'TLS1_2'
+    supportsHttpsTrafficOnly: true
+    allowBlobPublicAccess: true
+    accessTier: 'Hot'
+  }
+
+  // Blob service for cache and static assets
+  resource blobService 'blobServices' = {
+    name: 'default'
+    properties: {
+      cors: {
+        corsRules: [
+          {
+            allowedOrigins: ['*']
+            allowedMethods: ['GET', 'HEAD']
+            maxAgeInSeconds: 3600
+            exposedHeaders: ['*']
+            allowedHeaders: ['*']
+          }
+        ]
+      }
+    }
+
+    // Container for Next.js cache
+    resource cacheContainer 'containers' = {
+      name: containerName
+      properties: {
+        publicAccess: 'None'
+      }
+    }
+
+    // Container for static assets (public CDN access)
+    resource assetsContainer 'containers' = {
+      name: 'assets'
+      properties: {
+        publicAccess: 'Blob'
+      }
+    }
+  }
+
+  // Table service for tag cache
+  resource tableService 'tableServices' = {
+    name: 'default'
+
+    resource tagTable 'tables' = {
+      name: tableName
+    }
+  }
+
+  // Queue service for ISR revalidation (revalidateTag/revalidatePath)
+  resource queueService 'queueServices' = {
+    name: 'default'
+
+    resource revalidationQueue 'queues' = {
+      name: queueName
+    }
+  }
+}
+
+// App Service Plan (Consumption or Premium based on environment)
+resource appServicePlan 'Microsoft.Web/serverfarms@2023-01-01' = {
+  name: appServicePlanName
+  location: location
+  sku: {
+    name: environment == 'prod' ? 'EP1' : 'Y1' // EP1 = Premium, Y1 = Consumption
+    tier: environment == 'prod' ? 'ElasticPremium' : 'Dynamic'
+  }
+  kind: 'functionapp'
+  properties: {
+    reserved: true // Linux
+  }
+}
+
+// Function App
+resource functionApp 'Microsoft.Web/sites@2023-01-01' = {
+  name: functionAppName
+  location: location
+  kind: 'functionapp,linux'
+  properties: {
+    serverFarmId: appServicePlan.id
+    siteConfig: {
+      linuxFxVersion: 'NODE|${nodeVersion}'
+      appSettings: concat([
+        {
+          name: 'AzureWebJobsStorage'
+          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};AccountKey=${storageAccount.listKeys().keys[0].value};EndpointSuffix=core.windows.net'
+        }
+        {
+          name: 'WEBSITE_CONTENTAZUREFILECONNECTIONSTRING'
+          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};AccountKey=${storageAccount.listKeys().keys[0].value};EndpointSuffix=core.windows.net'
+        }
+        {
+          name: 'WEBSITE_CONTENTSHARE'
+          value: toLower(functionAppName)
+        }
+        {
+          name: 'FUNCTIONS_EXTENSION_VERSION'
+          value: '~4'
+        }
+        {
+          name: 'FUNCTIONS_WORKER_RUNTIME'
+          value: 'node'
+        }
+        {
+          name: 'WEBSITE_NODE_DEFAULT_VERSION'
+          value: '~${nodeVersion}'
+        }
+        {
+          name: 'WEBSITE_RUN_FROM_PACKAGE'
+          value: '1'
+        }
+        {
+          name: 'AzureWebJobsDisableHomepage'
+          value: 'true'
+        }
+        // Next.js / OpenNext environment variables
+        {
+          name: 'AZURE_STORAGE_CONNECTION_STRING'
+          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};AccountKey=${storageAccount.listKeys().keys[0].value};EndpointSuffix=core.windows.net'
+        }
+        {
+          name: 'AZURE_STORAGE_ACCOUNT_NAME'
+          value: storageAccountName
+        }
+        {
+          name: 'AZURE_STORAGE_CONTAINER_NAME'
+          value: containerName
+        }
+        {
+          name: 'AZURE_TABLE_NAME'
+          value: tableName
+        }
+        {
+          name: 'AZURE_QUEUE_NAME'
+          value: queueName
+        }
+        {
+          name: 'NODE_ENV'
+          value: 'production'
+        }
+      ], enableApplicationInsights ? [
+        {
+          name: 'APPLICATIONINSIGHTS_CONNECTION_STRING'
+          value: applicationInsights.properties.ConnectionString
+        }
+        {
+          name: 'ApplicationInsightsAgent_EXTENSION_VERSION'
+          value: '~3'
+        }
+      ] : [])
+      
+      ftpsState: 'Disabled'
+      minTlsVersion: '1.2'
+      cors: {
+        allowedOrigins: ['*']
+      }
+    }
+    httpsOnly: true
+  }
+}
+
+// Outputs
+output functionAppName string = functionApp.name
+output functionAppUrl string = 'https://${functionApp.properties.defaultHostName}'
+output storageAccountName string = storageAccount.name
+output assetsUrl string = 'https://${storageAccount.name}.blob.${az.environment().suffixes.storage}/assets'
+output resourceGroupName string = resourceGroup().name
+output applicationInsightsName string = enableApplicationInsights ? applicationInsights.name : ''
+output applicationInsightsInstrumentationKey string = enableApplicationInsights ? applicationInsights.properties.InstrumentationKey : ''
+
+output deploymentInfo object = {
+  functionApp: functionAppName
+  storageAccount: storageAccountName
+  containerName: containerName
+  tableName: tableName
+  queueName: queueName
+  assetsUrl: 'https://${storageAccount.name}.blob.${az.environment().suffixes.storage}/assets'
+  functionUrl: 'https://${functionApp.properties.defaultHostName}'
+  appUrl: 'https://${functionApp.properties.defaultHostName}'
+  applicationInsights: enableApplicationInsights ? applicationInsightsName : null
+}

package/dist/overrides/incrementalCache/azure-blob.d.mts

@@ -0,0 +1,23 @@
+import { IncrementalCache, CacheEntryType, WithLastModified, CacheValue } from '@opennextjs/aws/types/overrides.js';
+
+/**
+ * Azure Blob Storage implementation of IncrementalCache.
+ *
+ * Stores Next.js ISR cache entries in Azure Blob Storage.
+ * Compatible with the S3 cache interface from @opennextjs/aws.
+ */
+declare class AzureBlobIncrementalCache implements IncrementalCache {
+    name: string;
+    private containerClient;
+    constructor();
+    /**
+     * Builds the blob key path, mimicking S3 structure:
+     * [prefix]/[__fetch]/[buildId]/[key].[extension]
+     */
+    private buildBlobKey;
+    get<CacheType extends CacheEntryType = "cache">(key: string, cacheType?: CacheType): Promise<WithLastModified<CacheValue<CacheType>> | null>;
+    set<CacheType extends CacheEntryType = "cache">(key: string, value: CacheValue<CacheType>, cacheType?: CacheType): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+
+export { AzureBlobIncrementalCache as default };

package/dist/overrides/incrementalCache/azure-blob.d.ts

@@ -0,0 +1,23 @@
+import { IncrementalCache, CacheEntryType, WithLastModified, CacheValue } from '@opennextjs/aws/types/overrides.js';
+
+/**
+ * Azure Blob Storage implementation of IncrementalCache.
+ *
+ * Stores Next.js ISR cache entries in Azure Blob Storage.
+ * Compatible with the S3 cache interface from @opennextjs/aws.
+ */
+declare class AzureBlobIncrementalCache implements IncrementalCache {
+    name: string;
+    private containerClient;
+    constructor();
+    /**
+     * Builds the blob key path, mimicking S3 structure:
+     * [prefix]/[__fetch]/[buildId]/[key].[extension]
+     */
+    private buildBlobKey;
+    get<CacheType extends CacheEntryType = "cache">(key: string, cacheType?: CacheType): Promise<WithLastModified<CacheValue<CacheType>> | null>;
+    set<CacheType extends CacheEntryType = "cache">(key: string, value: CacheValue<CacheType>, cacheType?: CacheType): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+
+export { AzureBlobIncrementalCache as default };

package/dist/overrides/incrementalCache/azure-blob.js

@@ -0,0 +1,89 @@
+import { BlobServiceClient } from '@azure/storage-blob';
+import { getAzureConfig } from '../../config/index.js';
+
+class AzureBlobIncrementalCache {
+  name = "azure-blob";
+  containerClient;
+  constructor() {
+    const { storage } = getAzureConfig();
+    const connectionString = storage.connectionString;
+    const accountName = storage.accountName;
+    const accountKey = storage.accountKey;
+    if (connectionString) {
+      const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString);
+      this.containerClient = blobServiceClient.getContainerClient(storage.containerName || "nextjs-cache");
+    } else if (accountName && accountKey) {
+      const blobServiceClient = new BlobServiceClient(`https://${accountName}.blob.core.windows.net`, {
+        accountName,
+        accountKey
+      });
+      this.containerClient = blobServiceClient.getContainerClient(storage.containerName || "nextjs-cache");
+    }
+  }
+  /**
+   * Builds the blob key path, mimicking S3 structure:
+   * [prefix]/[__fetch]/[buildId]/[key].[extension]
+   */
+  buildBlobKey(key, cacheType = "cache") {
+    const { storage } = getAzureConfig();
+    const { NEXT_BUILD_ID } = process.env;
+    const prefix = storage.containerName || "";
+    const type = cacheType === "fetch" ? "__fetch" : "";
+    return [prefix, type, NEXT_BUILD_ID, cacheType === "fetch" ? key : `${key}.${cacheType}`].filter(Boolean).join("/");
+  }
+  async get(key, cacheType) {
+    try {
+      const blobKey = this.buildBlobKey(key, cacheType);
+      const blobClient = this.containerClient.getBlobClient(blobKey);
+      const downloadResponse = await blobClient.download();
+      if (!downloadResponse.readableStreamBody) {
+        return null;
+      }
+      const chunks = [];
+      for await (const chunk of downloadResponse.readableStreamBody) {
+        chunks.push(Buffer.from(chunk));
+      }
+      const content = Buffer.concat(chunks).toString("utf8");
+      const value = JSON.parse(content);
+      return {
+        value,
+        lastModified: downloadResponse.lastModified?.getTime()
+      };
+    } catch (error) {
+      if (error.statusCode === 404) {
+        return null;
+      }
+      process.stderr.write(`Failed to get from Azure Blob cache: ${error}
+`);
+      return null;
+    }
+  }
+  async set(key, value, cacheType) {
+    try {
+      const blobKey = this.buildBlobKey(key, cacheType);
+      const blobClient = this.containerClient.getBlockBlobClient(blobKey);
+      const content = JSON.stringify(value);
+      await blobClient.upload(content, content.length, {
+        blobHTTPHeaders: {
+          blobContentType: "application/json"
+        }
+      });
+    } catch (error) {
+      process.stderr.write(`Failed to set Azure Blob cache: ${error}
+`);
+      throw error;
+    }
+  }
+  async delete(key) {
+    try {
+      const blobKey = this.buildBlobKey(key, "cache");
+      const blobClient = this.containerClient.getBlobClient(blobKey);
+      await blobClient.deleteIfExists();
+    } catch (error) {
+      process.stderr.write(`Failed to delete from Azure Blob cache: ${error}
+`);
+    }
+  }
+}
+
+export { AzureBlobIncrementalCache as default };

package/dist/overrides/queue/azure-queue.d.mts

@@ -0,0 +1,19 @@
+import { Queue, QueueMessage } from '@opennextjs/aws/types/overrides.js';
+
+/**
+ * Azure Queue Storage implementation of the revalidation queue.
+ *
+ * Handles on-demand ISR revalidation triggered by:
+ * - revalidateTag('product')
+ * - revalidatePath('/products/123')
+ *
+ * The queue receives revalidation messages and triggers re-renders.
+ */
+declare class AzureQueueRevalidation implements Queue {
+    name: string;
+    private queueClient;
+    constructor();
+    send(message: QueueMessage): Promise<void>;
+}
+
+export { AzureQueueRevalidation as default };

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

@@ -0,0 +1,19 @@
+import { Queue, QueueMessage } from '@opennextjs/aws/types/overrides.js';
+
+/**
+ * Azure Queue Storage implementation of the revalidation queue.
+ *
+ * Handles on-demand ISR revalidation triggered by:
+ * - revalidateTag('product')
+ * - revalidatePath('/products/123')
+ *
+ * The queue receives revalidation messages and triggers re-renders.
+ */
+declare class AzureQueueRevalidation implements Queue {
+    name: string;
+    private queueClient;
+    constructor();
+    send(message: QueueMessage): Promise<void>;
+}
+
+export { AzureQueueRevalidation as default };

package/dist/overrides/queue/azure-queue.js

@@ -0,0 +1,39 @@
+import { QueueServiceClient } from '@azure/storage-queue';
+import { getAzureConfig } from '../../config/index.js';
+
+class AzureQueueRevalidation {
+  name = "azure-queue";
+  queueClient;
+  constructor() {
+    const { storage } = getAzureConfig();
+    const connectionString = storage.connectionString;
+    const queueName = storage.queueName || "nextjsrevalidation";
+    if (connectionString) {
+      const queueServiceClient = QueueServiceClient.fromConnectionString(connectionString);
+      this.queueClient = queueServiceClient.getQueueClient(queueName);
+    }
+  }
+  async send(message) {
+    if (!this.queueClient) {
+      process.stderr.write("Azure Queue not configured. Skipping revalidation message.\n");
+      return;
+    }
+    try {
+      const messageContent = JSON.stringify({
+        host: message.MessageBody.host,
+        url: message.MessageBody.url,
+        lastModified: message.MessageBody.lastModified,
+        eTag: message.MessageBody.eTag,
+        deduplicationId: message.MessageDeduplicationId,
+        groupId: message.MessageGroupId
+      });
+      await this.queueClient.sendMessage(Buffer.from(messageContent).toString("base64"));
+    } catch (error) {
+      process.stderr.write(`Failed to send revalidation message: ${error}
+`);
+      throw error;
+    }
+  }
+}
+
+export { AzureQueueRevalidation as default };

package/dist/overrides/tagCache/azure-table.d.mts

@@ -0,0 +1,26 @@
+import { OriginalTagCache, OriginalTagCacheWriteInput } from '@opennextjs/aws/types/overrides.js';
+
+/**
+ * Azure Table Storage implementation of TagCache.
+ *
+ * Stores tag-to-path mappings for Next.js revalidateTag/revalidatePath.
+ * Uses the "original" mode which requires pre-population but offers fast reads.
+ *
+ * Schema:
+ * - PartitionKey: tag (e.g., "buildId/product")
+ * - RowKey: path (e.g., "buildId/products/123")
+ * - revalidatedAt: timestamp
+ */
+declare class AzureTableTagCache implements OriginalTagCache {
+    mode: "original";
+    name: string;
+    private tableClient;
+    constructor();
+    private buildKey;
+    getByTag(tag: string): Promise<string[]>;
+    getByPath(path: string): Promise<string[]>;
+    getLastModified(path: string, lastModified?: number): Promise<number>;
+    writeTags(tags: OriginalTagCacheWriteInput[]): Promise<void>;
+}
+
+export { AzureTableTagCache as default };

package/dist/overrides/tagCache/azure-table.d.ts

@@ -0,0 +1,26 @@
+import { OriginalTagCache, OriginalTagCacheWriteInput } from '@opennextjs/aws/types/overrides.js';
+
+/**
+ * Azure Table Storage implementation of TagCache.
+ *
+ * Stores tag-to-path mappings for Next.js revalidateTag/revalidatePath.
+ * Uses the "original" mode which requires pre-population but offers fast reads.
+ *
+ * Schema:
+ * - PartitionKey: tag (e.g., "buildId/product")
+ * - RowKey: path (e.g., "buildId/products/123")
+ * - revalidatedAt: timestamp
+ */
+declare class AzureTableTagCache implements OriginalTagCache {
+    mode: "original";
+    name: string;
+    private tableClient;
+    constructor();
+    private buildKey;
+    getByTag(tag: string): Promise<string[]>;
+    getByPath(path: string): Promise<string[]>;
+    getLastModified(path: string, lastModified?: number): Promise<number>;
+    writeTags(tags: OriginalTagCacheWriteInput[]): Promise<void>;
+}
+
+export { AzureTableTagCache as default };