opennextjs-azure 0.1.1

package/dist/overrides/tagCache/azure-table.js

@@ -0,0 +1,104 @@
+import { TableClient, AzureNamedKeyCredential } from '@azure/data-tables';
+import { getAzureConfig } from '../../config/index.js';
+
+class AzureTableTagCache {
+  mode = "original";
+  name = "azure-table";
+  tableClient;
+  constructor() {
+    const { storage } = getAzureConfig();
+    const connectionString = storage.connectionString;
+    const accountName = storage.accountName;
+    const accountKey = storage.accountKey;
+    const tableName = storage.tableName || "nextjstags";
+    if (connectionString) {
+      this.tableClient = TableClient.fromConnectionString(connectionString, tableName);
+    } else if (accountName && accountKey) {
+      const credential = new AzureNamedKeyCredential(accountName, accountKey);
+      this.tableClient = new TableClient(`https://${accountName}.table.core.windows.net`, tableName, credential);
+    }
+  }
+  buildKey(key) {
+    const { NEXT_BUILD_ID } = process.env;
+    return `${NEXT_BUILD_ID}/${key}`;
+  }
+  async getByTag(tag) {
+    try {
+      const queryKey = this.buildKey(tag);
+      const entities = this.tableClient.listEntities({
+        queryOptions: { filter: `PartitionKey eq '${queryKey}'` }
+      });
+      const paths = [];
+      for await (const entity of entities) {
+        if (entity.rowKey) {
+          const { NEXT_BUILD_ID } = process.env;
+          const path = entity.rowKey.toString().replace(`${NEXT_BUILD_ID}/`, "");
+          paths.push(path);
+        }
+      }
+      return paths;
+    } catch (error) {
+      process.stderr.write(`Failed to get by tag from Azure Table: ${error}
+`);
+      return [];
+    }
+  }
+  async getByPath(path) {
+    try {
+      const queryKey = this.buildKey(path);
+      const entities = this.tableClient.listEntities({
+        queryOptions: { filter: `RowKey eq '${queryKey}'` }
+      });
+      const tags = [];
+      for await (const entity of entities) {
+        if (entity.partitionKey) {
+          const { NEXT_BUILD_ID: buildId } = process.env;
+          const tag = entity.partitionKey.toString().replace(`${buildId}/`, "");
+          tags.push(tag);
+        }
+      }
+      return tags;
+    } catch (error) {
+      process.stderr.write(`Failed to get by path from Azure Table: ${error}
+`);
+      return [];
+    }
+  }
+  async getLastModified(path, lastModified) {
+    try {
+      const queryKey = this.buildKey(path);
+      const entities = this.tableClient.listEntities({
+        queryOptions: {
+          filter: `RowKey eq '${queryKey}' and RevalidatedAt gt ${lastModified ?? 0}L`
+        }
+      });
+      for await (const entity of entities) {
+        if (entity.revalidatedAt) {
+          return -1;
+        }
+      }
+      return lastModified ?? Date.now();
+    } catch (error) {
+      process.stderr.write(`Failed to get last modified from Azure Table: ${error}
+`);
+      return lastModified ?? Date.now();
+    }
+  }
+  async writeTags(tags) {
+    try {
+      for (const { tag, path, revalidatedAt } of tags) {
+        const entity = {
+          partitionKey: this.buildKey(tag),
+          rowKey: this.buildKey(path),
+          revalidatedAt: revalidatedAt ?? Date.now()
+        };
+        await this.tableClient.upsertEntity(entity, "Merge");
+      }
+    } catch (error) {
+      process.stderr.write(`Failed to write tags to Azure Table: ${error}
+`);
+    }
+  }
+}
+
+export { AzureTableTagCache as default };

package/dist/shared/opennextjs-azure.d619537c.d.mts

@@ -0,0 +1,61 @@
+import { RoutePreloadingBehavior, OpenNextConfig } from '@opennextjs/aws/types/open-next.js';
+import { IncrementalCache, TagCache, Queue } from '@opennextjs/aws/types/overrides.js';
+
+type AzureDeploymentTarget = "functions" | "static-web-apps" | "container-apps";
+interface AzureDeploymentConfig {
+    target?: AzureDeploymentTarget;
+    region?: string;
+    resourceGroup?: string;
+}
+interface AzureStorageConfig {
+    connectionString?: string;
+    accountName?: string;
+    accountKey?: string;
+    containerName?: string;
+    tableName?: string;
+    queueName?: string;
+}
+interface AzureConfig {
+    incrementalCache?: "azure-blob" | IncrementalCache;
+    tagCache?: "azure-table" | TagCache;
+    queue?: "azure-queue" | Queue;
+    routePreloadingBehavior?: RoutePreloadingBehavior;
+    middleware?: OpenNextConfig["middleware"];
+    dangerous?: OpenNextConfig["dangerous"];
+    buildCommand?: string;
+    buildOutputPath?: string;
+    appPath?: string;
+    packageJsonPath?: string;
+    deployment?: AzureDeploymentConfig;
+    storage?: AzureStorageConfig;
+    applicationInsights?: boolean;
+}
+
+/**
+ * Defines the OpenNext configuration for Azure deployment.
+ *
+ * This extends the base OpenNext config with Azure-specific settings,
+ * using Azure Blob Storage, Table Storage, and Queue Storage by default.
+ */
+declare function defineAzureConfig(config?: AzureConfig): OpenNextConfig;
+/**
+ * Gets Azure configuration from environment variables.
+ * Used at runtime by the storage adapters.
+ */
+declare function getAzureConfig(): {
+    deployment: {
+        target: any;
+        region: string;
+    };
+    storage: {
+        connectionString: string | undefined;
+        accountName: string | undefined;
+        accountKey: string | undefined;
+        containerName: string;
+        tableName: string;
+        queueName: string;
+    };
+};
+
+export { defineAzureConfig as d, getAzureConfig as g };
+export type { AzureConfig as A, AzureDeploymentTarget as a };

package/dist/shared/opennextjs-azure.d619537c.d.ts

@@ -0,0 +1,61 @@
+import { RoutePreloadingBehavior, OpenNextConfig } from '@opennextjs/aws/types/open-next.js';
+import { IncrementalCache, TagCache, Queue } from '@opennextjs/aws/types/overrides.js';
+
+type AzureDeploymentTarget = "functions" | "static-web-apps" | "container-apps";
+interface AzureDeploymentConfig {
+    target?: AzureDeploymentTarget;
+    region?: string;
+    resourceGroup?: string;
+}
+interface AzureStorageConfig {
+    connectionString?: string;
+    accountName?: string;
+    accountKey?: string;
+    containerName?: string;
+    tableName?: string;
+    queueName?: string;
+}
+interface AzureConfig {
+    incrementalCache?: "azure-blob" | IncrementalCache;
+    tagCache?: "azure-table" | TagCache;
+    queue?: "azure-queue" | Queue;
+    routePreloadingBehavior?: RoutePreloadingBehavior;
+    middleware?: OpenNextConfig["middleware"];
+    dangerous?: OpenNextConfig["dangerous"];
+    buildCommand?: string;
+    buildOutputPath?: string;
+    appPath?: string;
+    packageJsonPath?: string;
+    deployment?: AzureDeploymentConfig;
+    storage?: AzureStorageConfig;
+    applicationInsights?: boolean;
+}
+
+/**
+ * Defines the OpenNext configuration for Azure deployment.
+ *
+ * This extends the base OpenNext config with Azure-specific settings,
+ * using Azure Blob Storage, Table Storage, and Queue Storage by default.
+ */
+declare function defineAzureConfig(config?: AzureConfig): OpenNextConfig;
+/**
+ * Gets Azure configuration from environment variables.
+ * Used at runtime by the storage adapters.
+ */
+declare function getAzureConfig(): {
+    deployment: {
+        target: any;
+        region: string;
+    };
+    storage: {
+        connectionString: string | undefined;
+        accountName: string | undefined;
+        accountKey: string | undefined;
+        containerName: string;
+        tableName: string;
+        queueName: string;
+    };
+};
+
+export { defineAzureConfig as d, getAzureConfig as g };
+export type { AzureConfig as A, AzureDeploymentTarget as a };

package/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/package.json

@@ -0,0 +1,99 @@
+{
+    "name": "opennextjs-azure",
+    "version": "0.1.1",
+    "description": "Azure adapter for Next.js applications using OpenNext",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "opennextjs-azure": "dist/cli/index.js"
+    },
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json",
+        "./config/index.js": {
+            "import": "./dist/config/index.js",
+            "types": "./dist/config/index.d.ts"
+        },
+        "./adapters/wrappers/azure-functions.js": {
+            "import": "./dist/adapters/wrappers/azure-functions.js",
+            "types": "./dist/adapters/wrappers/azure-functions.d.ts"
+        },
+        "./adapters/converters/azure-http.js": {
+            "import": "./dist/adapters/converters/azure-http.js",
+            "types": "./dist/adapters/converters/azure-http.d.ts"
+        },
+        "./overrides/incrementalCache/azure-blob.js": {
+            "import": "./dist/overrides/incrementalCache/azure-blob.js",
+            "types": "./dist/overrides/incrementalCache/azure-blob.d.ts"
+        },
+        "./overrides/tagCache/azure-table.js": {
+            "import": "./dist/overrides/tagCache/azure-table.js",
+            "types": "./dist/overrides/tagCache/azure-table.d.ts"
+        },
+        "./overrides/queue/azure-queue.js": {
+            "import": "./dist/overrides/queue/azure-queue.js",
+            "types": "./dist/overrides/queue/azure-queue.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "infrastructure"
+    ],
+    "scripts": {
+        "build": "unbuild",
+        "dev": "unbuild --stub",
+        "clean": "rimraf dist",
+        "lint": "eslint src --ext .ts",
+        "test": "vitest",
+        "typecheck": "tsc --noEmit",
+        "format": "prettier --write ."
+    },
+    "keywords": [
+        "nextjs",
+        "azure",
+        "serverless",
+        "azure-functions",
+        "opennext"
+    ],
+    "author": "",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/zpg6/opennextjs-azure.git"
+    },
+    "bugs": {
+        "url": "https://github.com/zpg6/opennextjs-azure/issues"
+    },
+    "homepage": "https://opennext.js.org/azure",
+    "dependencies": {
+        "@opennextjs/aws": "^3.8.5",
+        "@azure/functions": "^4.5.1",
+        "@azure/storage-blob": "^12.20.0",
+        "@azure/data-tables": "^13.2.2",
+        "@azure/storage-queue": "^12.18.0",
+        "commander": "^11.1.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "@typescript-eslint/eslint-plugin": "^6.20.0",
+        "@typescript-eslint/parser": "^6.20.0",
+        "eslint": "^8.56.0",
+        "rimraf": "^5.0.5",
+        "prettier": "^3.5.3",
+        "prettier-plugin-tailwindcss": "^0.5.0",
+        "typescript": "^5.3.3",
+        "unbuild": "^2.0.0",
+        "vitest": "^1.2.0"
+    },
+    "peerDependencies": {
+        "next": ">=13.4.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}