@stoker-platform/cli 0.5.12

package/LICENSE.md

@@ -0,0 +1,102 @@
+# Source-Available Development License
+
+Copyright © 2026 Shopfront International Pty Ltd.
+
+This is a source‑available license and not an OSI‑approved open‑source license.
+
+## 1. License Grant
+
+Subject to the terms of this License, you are granted a **non-exclusive, non-transferable, revocable** license to:
+
+- Access the Software.
+- Use the Software **in development environments only**. Development environments include local development, testing, staging, and QA environments that are not accessible to end users.
+
+This use is **free of charge**.
+
+No other rights are granted except as expressly stated in this License.
+
+## 2. Commercial or Production Use
+
+**Commercial use or production deployment is strictly prohibited** under this License. This includes, but is not limited to:
+
+- Deploying the Software in production environments
+- Using the Software in any revenue-generating product, service, or project
+- Selling, sublicensing, or monetising the Software
+
+You may not use the Software, directly or indirectly, to develop, distribute, operate, or enable any product or service that:
+
+- #### Competes with the Software
+
+    By functioning as a headless CMS, application framework, developer platform, or substantially similar system.
+
+- #### Replicates Core Functionality
+
+    Copies or substantially mirrors the Software’s architecture, workflows, abstractions, or core features.
+
+- #### Offers the Software as a Service
+
+    Provides the Software itself or its functionality to third parties as a managed service, hosted platform, API, or marketplace.
+
+- #### Rebrands or White-Labels the Software
+
+    Offers the Software itself under a different name, branding, or identity.
+
+- #### Creates Derived Frameworks or Tooling
+
+    Distributes frameworks, starter kits, templates, scaffolding, or developer toolkits substantially derived from the Software.
+
+- #### Competitive Analysis and Cloning
+
+    Uses the Software mainly to analyse, benchmark, reverse engineer, or replicate it for a competing product or service.
+
+- #### Artificial Intelligence and Machine Learning
+    Uses the Software itself to train, fine-tune, or improve artificial intelligence or machine learning models.
+
+To use the Software commercially or in production, you must obtain a Commercial License from the Licensor. Contact info@getoutpost.com for licensing information.
+
+## 3. Contributions
+
+You may fork or modify the Software for contribution purposes.
+
+You may submit issues, bug reports, feature requests, and pull requests through public channels (such as GitHub) as a means of contributing to the Software. Modifications may not be otherwise shared or distributed except through such official contribution channels.
+
+By submitting contributions, suggestions, or modifications to the Licensor in connection with the Software, you grant the Licensor a perpetual, worldwide, royalty-free, non-exclusive, fully transferable, and sublicensable license to use, modify, distribute, and otherwise exploit such contributions as part of the Software. You retain ownership of your contributions but grant these rights to enable the Licensor to incorporate and distribute your contributions as part of the Software.
+
+## 4. Ownership
+
+The Software is **licensed, not sold**. All rights not expressly granted herein are retained by the Licensor.
+
+All trademarks, service marks, and logos associated with the Software are the property of the Licensor and may not be used without permission.
+
+## 5. Alpha Mode
+
+- The Software may be provided in alpha or pre-release form. Features, functionality, and data handling may change without notice.
+- By using the Software in alpha, you acknowledge it may contain bugs, errors, or incomplete functionality.
+- The Licensor makes no commitment to maintain backward compatibility or preserve data formats during the alpha period.
+- Alpha releases may be discontinued or replaced without prior notice.
+- You are responsible for backing up your data and testing compatibility before upgrading.
+
+## 6. Limited Warranty / Liability
+
+- To the extent permitted by law, the Software is provided **"AS IS"**, without warranties of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, or non-infringement.
+- Licensor is not liable for any damages arising from use or inability to use the Software, to the maximum extent permitted by law.
+- Nothing in this License excludes rights or remedies that cannot be waived under applicable law.
+
+## 7. Termination
+
+This License automatically terminates if you fail to comply with any term or condition. In this case, you must immediately stop using the Software.
+
+**The licensor may terminate this license at any time**, for any reason, when 60 days notice is given on the Licensor's website at https://stoker-website.web.app. In this case, you will need to purchase a commerical license to continue using the Software.
+
+The Licensor reserves the right to pursue legal remedies for any violation, including injunctive relief.
+
+## 8. Governing Law
+
+This License is governed by and shall be construed under the laws of Victoria, Australia, without regard to conflict-of-law principles.
+
+Any disputes arising under this License shall be resolved exclusively in the courts of Victoria, Australia.
+
+## 9. Commercial License
+
+For commercial use or production deployment, a Commercial License Agreement must be obtained.
+Please contact info@getoutpost.com for details.

package/init-files/.##gitignore##

@@ -0,0 +1,102 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+firebase-debug.log*
+firebase-debug.*.log*
+
+# Firebase cache
+.firebase/
+
+# Firebase config
+
+# Uncomment this if you'd like others to create their own Firebase project.
+# For a team working on the same Firebase project(s), it is recommended to leave
+# it commented so all members can deploy to the same project(s) in .firebaserc.
+# .firebaserc
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+
+# Optional npm cache directory
+.npm
+
+# npm config file
+.npmrc
+
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# Turborepo configuration
+.turbo
+
+# Build directories
+lib
+dist
+dist-ssr
+*.local
+
+# Dotenv variables
+.env
+.env.*
+
+# Firebase GenKit directory
+.genkit
+
+# Firebase emulator data
+firebase-emulator-data/*
+
+# Web app directory
+web-app

package/init-files/.devcontainer/devcontainer.json

@@ -0,0 +1,14 @@
+{
+    "image": "mcr.microsoft.com/devcontainers/universal:2",
+    "features": {
+        "ghcr.io/dhoeric/features/google-cloud-cli:1": {
+            "version": "latest"
+        },
+        "ghcr.io/devcontainers-contrib/features/firebase-cli:2": {
+            "version": "latest"
+        },
+        "ghcr.io/devcontainers-contrib/features/typescript:2": {
+            "version": "latest"
+        }
+    }
+}

package/init-files/.env/.env

@@ -0,0 +1,70 @@
+ADMIN_EMAIL=""
+ADMIN_SMS=""
+
+GCP_BILLING_ACCOUNT=""
+
+GCP_ORGANIZATION=""
+GCP_FOLDER=""
+
+FB_GOOGLE_ANALYTICS_ACCOUNT_ID=""
+
+FB_FIRESTORE_REGION="australia-southeast2"
+FB_FIRESTORE_ENABLE_PITR=true
+FB_FIRESTORE_BACKUP_RECURRENCE="daily"
+FB_FIRESTORE_BACKUP_RETENTION="7d"
+
+FB_DATABASE_REGION="asia-southeast1"
+
+FB_STORAGE_REGION="australia-southeast2"
+FB_STORAGE_ENABLE_VERSIONING=true
+FB_STORAGE_SOFT_DELETE_DURATION="30d"
+
+FB_AUTH_PASSWORD_POLICY='{
+    "containsLowercaseCharacter": false,
+    "containsUppercaseCharacter": false,
+    "containsNumericCharacter": false,
+    "containsNonAlphanumericCharacter": false,
+    "minPasswordLength": 12,
+    "maxPasswordLength": 128
+}'
+FB_AUTH_PASSWORD_POLICY_UPGRADE=false
+
+FB_FUNCTIONS_REGION="australia-southeast2"
+FB_FUNCTIONS_V1_REGION="australia-southeast1"
+FB_FUNCTIONS_MEMORY="1GiB"
+FB_FUNCTIONS_TIMEOUT=540
+FB_FUNCTIONS_MAX_INSTANCES=100
+FB_FUNCTIONS_MIN_INSTANCES=0
+FB_FUNCTIONS_CPU=1
+FB_FUNCTIONS_CONCURRENCY=80
+FB_FUNCTIONS_CONSUME_APP_CHECK_TOKEN=false
+
+FB_HOSTING_ENABLE_CLOUD_LOGGING=true
+FB_HOSTING_MAX_VERSIONS=3
+
+FB_ENABLE_APP_CHECK=true
+FB_APP_CHECK_TOKEN_TTL="3600s"
+
+FB_AI_REGION="us-west1"
+
+MAIL_REGION="asia-northeast1"
+MAIL_SENDER=""
+MAIL_SMTP_CONNECTION_URI=""
+MAIL_SMTP_PASSWORD=""
+
+TWILIO_ACCOUNT_SID=""
+TWILIO_AUTH_TOKEN=""
+TWILIO_PHONE_NUMBER=""
+
+ALGOLIA_ID=""
+ALGOLIA_ADMIN_KEY=""
+
+SENTRY_DSN=""
+
+FULLCALENDAR_KEY=""
+
+EXTERNAL_SECRETS='{}'
+
+URL_FIRESTORE_INDEXES="https://australia-southeast2-stoker-backend-prod-v1.cloudfunctions.net/stoker-getfirestoreindexes"
+URL_FIRESTORE_RULES="https://australia-southeast2-stoker-backend-prod-v1.cloudfunctions.net/stoker-getfirestorerules"
+URL_STORAGE_RULES="https://australia-southeast2-stoker-backend-prod-v1.cloudfunctions.net/stoker-getstoragerules"

package/init-files/.eslintrc.cjs

@@ -0,0 +1,35 @@
+module.exports = {
+    env: {
+        es6: true,
+        node: true,
+    },
+    extends: [
+        "eslint:recommended",
+        "plugin:import/errors",
+        "plugin:import/warnings",
+        "plugin:import/typescript",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:security/recommended-legacy",
+        "prettier",
+    ],
+    parser: "@typescript-eslint/parser",
+    parserOptions: {
+        project: ["tsconfig.json"],
+        sourceType: "module",
+    },
+    ignorePatterns: [
+        "/lib/**/*",
+        "/dist/**/*",
+        "bin/**/*",
+        "test/**/*",
+        "vitest.config.ts",
+        "/functions",
+        "/web-app",
+        "ops.js",
+    ],
+    plugins: ["@typescript-eslint", "import"],
+    rules: {
+        "import/no-unresolved": 0,
+        "prefer-rest-params": 0,
+    },
+}

package/init-files/.firebaserc

@@ -0,0 +1,6 @@
+{
+    "projects": {},
+    "targets": {},
+    "etags": {},
+    "dataconnectEmulatorConfig": {}
+}

package/init-files/.prettierignore

@@ -0,0 +1,86 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+firebase-debug.log*
+firebase-debug.*.log*
+
+# Firebase cache
+.firebase/
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# Turborepo configuration
+.turbo
+
+# Build directories
+lib
+dist
+dist-ssr
+*.local
+
+# Firebase GenKit directory
+.genkit
+
+# Firebase directories
+
+firebase-rules/
+functions/src/
+functions/.eslintrc.cjs
+
+package-lock.json

package/init-files/.prettierrc

@@ -0,0 +1,5 @@
+{
+    "printWidth": 120,
+    "tabWidth": 4,
+    "semi": false
+}

package/init-files/bin/build.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env -S node --no-warnings
+
+import { fileURLToPath } from "url"
+import { dirname, join } from "path"
+import { readFile, writeFile, readdir, mkdir, copyFile } from "fs/promises"
+import { existsSync, cpSync, rmSync } from "fs"
+import dotenv from "dotenv"
+import { runChildProcess } from "@stoker-platform/node-client"
+
+const envDir = join(process.cwd(), ".env")
+const projectEnvFile = join(envDir, `.env.project.${process.env.GCP_PROJECT}`)
+// eslint-disable-next-line security/detect-non-literal-fs-filename
+if (existsSync(projectEnvFile)) {
+    dotenv.config({ path: projectEnvFile, quiet: true })
+} else {
+    dotenv.config({ path: join(process.cwd(), ".env", ".env"), quiet: true })
+}
+
+try {
+    const __filename = fileURLToPath(import.meta.url)
+    const __dirname = dirname(__filename)
+
+    // Remove CSS imports from all JS files in lib directory
+
+    async function processFile(filePath) {
+        try {
+            const content = await readFile(filePath, "utf8")
+            const lines = content.split("\n")
+            const filteredLines = lines.filter((line) => {
+                const trimmed = line.trim()
+                // Match: import "./something.css" or import './something.css'
+                if (/^import\s+["']\.\/.*\.css["'];?\s*$/.test(trimmed)) {
+                    return false
+                }
+                // Match: import "something.css" or import 'something.css' (absolute imports)
+                if (/^import\s+["'].*\.css["'];?\s*$/.test(trimmed)) {
+                    return false
+                }
+                return true
+            })
+
+            const newContent = filteredLines.join("\n")
+            if (newContent !== content) {
+                await writeFile(filePath, newContent, "utf8")
+                console.log(`Removed CSS imports from: ${filePath}`)
+            }
+        } catch (error) {
+            console.error(`Error processing ${filePath}:`, error.message)
+        }
+    }
+
+    async function walkDirectory(dir) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true })
+
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name)
+
+                if (entry.isDirectory()) {
+                    await walkDirectory(fullPath)
+                } else if (entry.isFile() && entry.name.endsWith(".js")) {
+                    await processFile(fullPath)
+                }
+            }
+        } catch (error) {
+            if (error.code !== "ENOENT") {
+                console.error(`Error walking directory ${dir}:`, error.message)
+            }
+        }
+    }
+
+    async function removeCSSImports() {
+        const libDir = join(__dirname, "..", "lib")
+        await walkDirectory(libDir)
+    }
+
+    await removeCSSImports().catch((error) => {
+        console.error("Error:", error)
+        process.exit(1)
+    })
+
+    // Set up Firebase Extension files
+
+    let envFile
+    if (existsSync(projectEnvFile)) {
+        envFile = await readFile(projectEnvFile, "utf8")
+    } else {
+        envFile = await readFile(join(__dirname, "..", ".env", ".env"), "utf8")
+    }
+    const envFileLines = envFile.split("\n")
+    const databaseRegion = envFileLines.find((line) => line.startsWith("FB_FIRESTORE_REGION="))
+
+    const mailRegion = envFileLines.find((line) => line.startsWith("MAIL_REGION="))
+    const mailSender = envFileLines.find((line) => line.startsWith("MAIL_SENDER="))
+    const mailSmtpConnectionUri = envFileLines.find((line) => line.startsWith("MAIL_SMTP_CONNECTION_URI="))
+
+    const extensionEnvFile = await readFile(join(__dirname, "..", "extensions", "firestore-send-email.env"), "utf8")
+    const extensionEnvFileLines = extensionEnvFile.split("\n")
+    const linesToRemove = [
+        "EVENTARC_CHANNEL=",
+        "DEFAULT_FROM=",
+        "DEFAULT_REPLY_TO=",
+        "SMTP_CONNECTION_URI=",
+        "firebaseextensions.v1beta.function/location=",
+        "DATABASE_REGION=",
+    ]
+    const filteredLines = extensionEnvFileLines.filter(
+        (line) => !linesToRemove.some((removeStr) => line.startsWith(removeStr)),
+    )
+    filteredLines.push(
+        `EVENTARC_CHANNEL=projects/\${param:PROJECT_ID}/locations/${mailRegion.split("=")[1].replace(/^"|"$/g, "")}/channels/firebase`,
+    )
+    filteredLines.push(`firebaseextensions.v1beta.function/location=${process.env.FB_FUNCTIONS_REGION}`)
+    filteredLines.push(`DEFAULT_FROM=${mailSender.split("=")[1].replace(/^"|"$/g, "")}`)
+    filteredLines.push(`DEFAULT_REPLY_TO=${mailSender.split("=")[1].replace(/^"|"$/g, "")}`)
+    filteredLines.push(`SMTP_CONNECTION_URI=${mailSmtpConnectionUri.split("=")[1].replace(/^"|"$/g, "")}`)
+    filteredLines.push(`DATABASE_REGION=${databaseRegion.split("=")[1].replace(/^"|"$/g, "")}`)
+    await writeFile(join(__dirname, "..", "extensions", "firestore-send-email.env"), filteredLines.join("\n"))
+
+    // Update dependencies according to external.package.json
+
+    const updateDependencies = async (packageJsonPath, externalDeps) => {
+        const packageJsonRaw = await readFile(packageJsonPath, "utf8")
+        const packageJson = JSON.parse(packageJsonRaw)
+
+        const dependencies = packageJson.dependencies || {}
+        const previouslyManaged = packageJson.stokerExternalPackages || {}
+
+        let changed = false
+
+        for (const managedName of Object.keys(previouslyManaged)) {
+            if (!Object.prototype.hasOwnProperty.call(externalDeps, managedName)) {
+                if (Object.prototype.hasOwnProperty.call(dependencies, managedName)) {
+                    delete dependencies[managedName]
+                    changed = true
+                }
+            }
+        }
+
+        for (const [depName, depVersion] of Object.entries(externalDeps)) {
+            if (dependencies[depName] !== depVersion) {
+                dependencies[depName] = depVersion
+                changed = true
+            }
+        }
+
+        packageJson.dependencies = dependencies
+        packageJson.stokerExternalPackages = externalDeps
+
+        if (changed || JSON.stringify(previouslyManaged) !== JSON.stringify(externalDeps)) {
+            await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 4) + "\n")
+        }
+
+        return changed
+    }
+
+    const externalPackagesPath = join(process.cwd(), "external.package.json")
+    if (existsSync(externalPackagesPath)) {
+        const externalRaw = await readFile(externalPackagesPath, "utf8")
+        const external = JSON.parse(externalRaw)
+        const serverDeps = external.server || {}
+        const webDeps = external.web || {}
+
+        const appDir = join(process.cwd())
+        const functionsDir = join(process.cwd(), "functions")
+
+        const appPackageJson = join(appDir, "package.json")
+        const functionsPackageJson = join(functionsDir, "package.json")
+
+        const appChanged = await updateDependencies(appPackageJson, { ...serverDeps, ...webDeps })
+        const functionsChanged = await updateDependencies(functionsPackageJson, serverDeps)
+
+        if (appChanged) {
+            await runChildProcess("npm", ["install", "--no-audit", "--no-fund"], appDir)
+        }
+        if (functionsChanged) {
+            await runChildProcess("npm", ["install", "--no-audit", "--no-fund"], functionsDir)
+        }
+    }
+
+    // Create functions .env file with filtered environment variables
+
+    const functionsEnvPath = join(process.cwd(), "functions", ".env")
+    const defaultEnvFile = join(envDir, ".env")
+    const projectSpecificEnvFile = join(envDir, `.env.${process.env.GCP_PROJECT}`)
+
+    let envContent = ""
+    const envPattern = /^(FB_FUNCTIONS_|FB_AI_REGION|STOKER_|ADMIN_)/
+
+    if (existsSync(projectEnvFile)) {
+        const projectEnvContent = await readFile(projectEnvFile, "utf8")
+        const projectSpecificContent = existsSync(projectSpecificEnvFile)
+            ? await readFile(projectSpecificEnvFile, "utf8")
+            : ""
+
+        const allLines = [...projectEnvContent.split("\n"), ...projectSpecificContent.split("\n")]
+        const filteredLines = allLines.filter((line) => envPattern.test(line.trim()))
+        envContent = filteredLines.join("\n")
+    } else {
+        const defaultContent = existsSync(defaultEnvFile) ? await readFile(defaultEnvFile, "utf8") : ""
+        const projectSpecificContent = existsSync(projectSpecificEnvFile)
+            ? await readFile(projectSpecificEnvFile, "utf8")
+            : ""
+
+        const allLines = [...defaultContent.split("\n"), ...projectSpecificContent.split("\n")]
+        const filteredLines = allLines.filter((line) => envPattern.test(line.trim()))
+        envContent = filteredLines.join("\n")
+    }
+
+    await writeFile(functionsEnvPath, envContent, "utf8")
+
+    // Copy source files to functions directory
+
+    const systemCustom = join(process.cwd(), "functions", "src", "system-custom")
+    if (existsSync(systemCustom)) {
+        rmSync(systemCustom, { recursive: true })
+    }
+    cpSync(join(process.cwd(), "src"), systemCustom, { recursive: true })
+} catch (error) {
+    throw new Error(error)
+}