backend-manager 5.9.4 → 5.9.6

package/test/_legacy/test.md

@@ -1,89 +0,0 @@
-// trial-in-trial
-const expected = {
-  processor: 'paypal',
-  type: 'subscription',
-  status: 'active',
-  frequency: 'annually',
-  resource: { id: 'I-HG5K7XD0BVPJ' },
-  payment: { completed: true },
-  start: { timestamp: '2023-04-28T02:16:58.000Z', timestampUNIX: 1682648218 },
-  expires: { timestamp: '2024-06-10T10:00:00.000Z', timestampUNIX: 1718013600 },
-  cancelled: { timestamp: '1970-01-01T00:00:00.000Z', timestampUNIX: 0 },
-  lastPayment: {
-    amount: 0,
-    date: { timestamp: '1970-01-01T00:00:00.000Z', timestampUNIX: 0 }
-  },
-  trial: { active: true, daysLeft: 13 }
-}
-
-// trial-to-active
-const expected = {
-  processor: 'paypal',
-  type: 'subscription',
-  status: 'active',
-  frequency: 'monthly',
-  resource: { id: 'I-VTXGPKDTMMK2' },
-  payment: { completed: true },
-  start: { timestamp: '2023-04-11T17:37:58.000Z', timestampUNIX: 1681234678 },
-  expires: { timestamp: '2024-05-25T10:28:22.000Z', timestampUNIX: 1716632902 },
-  cancelled: { timestamp: '1970-01-01T00:00:00.000Z', timestampUNIX: 0 },
-  lastPayment: {
-    amount: 19.95,
-    date: { timestamp: '2023-04-25T10:28:22.000Z', timestampUNIX: 1682418502 }
-  },
-  trial: { active: false, daysLeft: 0 }
-}
-
-// trial-to-cancelled
-const expected = {
-  processor: 'paypal',
-  type: 'subscription',
-  status: 'cancelled',
-  frequency: 'monthly',
-  resource: { id: 'I-79C4RSSVKN95' },
-  payment: { completed: true },
-  start: { timestamp: '2023-03-31T08:41:35.000Z', timestampUNIX: 1680252095 },
-  expires: { timestamp: '1970-01-01T00:00:00.000Z', timestampUNIX: 0 },
-  cancelled: { timestamp: '2023-04-02T23:38:44.000Z', timestampUNIX: 1680478724 },
-  lastPayment: {
-    amount: 0,
-    date: { timestamp: '1970-01-01T00:00:00.000Z', timestampUNIX: 0 }
-  },
-  trial: { active: false, daysLeft: 0 }
-}
-
-// trial-to-active-to-cancelled
-const expected = {
-  processor: 'paypal',
-  type: 'subscription',
-  status: 'cancelled',
-  frequency: 'monthly',
-  resource: { id: 'I-MH92AV4A3EA6' },
-  payment: { completed: true },
-  start: { timestamp: '2023-03-31T14:48:51.000Z', timestampUNIX: 1680274131 },
-  expires: { timestamp: '2023-05-14T10:56:15.000Z', timestampUNIX: 1684061775 },
-  cancelled: { timestamp: '2023-04-18T10:14:56.000Z', timestampUNIX: 1681812896 },
-  lastPayment: {
-    amount: 19.95,
-    date: { timestamp: '2023-04-14T10:56:15.000Z', timestampUNIX: 1681469775 }
-  },
-  trial: { active: false, daysLeft: 0 }
-}
-
-// payment regular
-const expected = {
-  processor: 'paypal',
-  type: 'order',
-  status: 'cancelled',
-  frequency: 'single',
-  resource: { id: '5CA68427PY850452F' },
-  payment: { completed: true },
-  start: { timestamp: '2023-04-27T03:39:50.000Z', timestampUNIX: 1682566790 },
-  expires: { timestamp: '2023-04-27T03:39:50.000Z', timestampUNIX: 1682566790 },
-  cancelled: { timestamp: '2023-04-27T03:39:50.000Z', timestampUNIX: 1682566790 },
-  lastPayment: {
-    amount: 1,
-    date: { timestamp: '2023-04-27T03:40:38.000Z', timestampUNIX: 1682566838 }
-  },
-  trial: { active: false, daysLeft: 0 }
-}

package/test/_legacy/usage.js

@@ -1,175 +0,0 @@
-const package = require('../package.json');
-const assert = require('assert');
-
-beforeEach(() => {
-});
-
-before(() => {
-});
-
-after(() => {
-});
-
-/*
- * ============
- *  Test Cases
- * ============
- */
-describe(`${package.name}`, () => {
-  const Manager = (new (require('../src/manager/index.js'))).init(exports, {
-    setupFunctionsIdentity: false,
-    log: true,
-    serviceAccountPath: '../ultimate-jekyll-firebase/functions/service-account.json',
-    backendManagerConfigPath: '../ultimate-jekyll-firebase/functions/backend-manager-config.json',
-  });
-  const options = {
-    refetch: true,
-    // log: true,
-    today: '2024-01-01T01:00:00.000Z',
-  }
-
-  async function instance(instanceOptions) {
-    instanceOptions = instanceOptions || {};
-
-    const ops = JSON.parse(JSON.stringify(options));
-    const lib = Manager.Usage();
-
-    ops.clear = instanceOptions.clear;
-
-    await lib.init(Manager.Assistant(), ops);
-    return lib;
-  }
-
-  describe('.usage()', () => {
-    describe('unauthenticated', () => {
-      it('should clear correctly', async () => {
-        const lib = await instance({clear: true});
-
-        return assert.equal(true, true);
-      });
-
-      it('should initialize correctly', async () => {
-        const lib = await instance();
-
-        return assert.deepStrictEqual({
-          requests: {
-            total: 0,
-            monthly: 0,
-            daily: 0,
-            last: {
-              id: '',
-              timestamp: '1970-01-01T00:00:00.000Z',
-              timestampUNIX: 0,
-            },
-          },
-        }, lib.user.usage);
-      });
-
-      it('should increment correctly', async () => {
-        const lib = await instance();
-
-        lib.increment('requests', 1, {id: 'increment'});
-
-        return assert.deepStrictEqual({
-          requests: {
-            total: 1,
-            monthly: 1,
-            daily: 1,
-            last: {
-              id: 'increment',
-              timestamp: '2024-01-01T01:00:00.000Z',
-              timestampUNIX: 1704070800,
-            },
-          },
-        }, lib.user.usage);
-      });
-
-      it('should decrement correctly', async () => {
-        const lib = await instance();
-
-        lib.increment('requests', -1, {id: 'decrement'});
-
-        return assert.deepStrictEqual({
-          requests: {
-            total: -1,
-            monthly: -1,
-            daily: -1,
-            last: {
-              id: 'decrement',
-              timestamp: '2024-01-01T01:00:00.000Z',
-              timestampUNIX: 1704070800,
-            },
-          },
-        }, lib.user.usage);
-      });
-
-      it('should validate correctly (under)', async () => {
-        const lib = await instance();
-
-        lib.increment('requests', 1, {id: 'decrement'});
-
-        const result = await lib.validate('requests').catch(e => e);
-
-        return assert.equal(true, result);
-      });
-
-      it('should validate correctly (over)', async () => {
-        const lib = await instance();
-
-        lib.increment('requests', 9999999, {id: 'decrement'});
-
-        const result = await lib.validate('requests').catch(e => e);
-
-        // Should be an errors
-        return assert.equal(true, result instanceof Error);
-
-      });
-
-      it('should update correctly', async () => {
-        const lib = await instance();
-
-        lib.increment('requests', 1, {id: 'update'});
-
-        await lib.update();
-
-        return assert.deepStrictEqual({
-          requests: {
-            total: 1,
-            monthly: 1,
-            daily: 1,
-            last: {
-              id: 'update',
-              timestamp: '2024-01-01T01:00:00.000Z',
-              timestampUNIX: 1704070800,
-            },
-          },
-        }, lib.storage.get('users.127_0_0_1.usage').value());
-      });
-
-
-      // Local
-      it('should update local correctly', async () => {
-        const lib = await instance({key: '123.123.123.123'});
-
-        lib.increment('signups', 1, {id: 'singups'});
-
-        console.log('---lib.user.usage', lib.user.usage);
-
-        return assert.deepStrictEqual({
-          signups: {
-            total: 1,
-            monthly: 1,
-            daily: 1,
-            last: {
-              id: 'singups',
-              timestamp: '2024-01-01T01:00:00.000Z',
-              timestampUNIX: 1704070800,
-            },
-          },
-        }, lib.user.usage);
-      });
-    });
-
-  });
-
-})

package/test/_legacy/user.js

@@ -1,31 +0,0 @@
-const package = require('../package.json');
-const assert = require('assert');
-
-beforeEach(() => {
-});
-
-before(() => {
-});
-
-after(() => {
-});
-
-/*
- * ============
- *  Test Cases
- * ============
- */
-describe(`${package.name}`, () => {
-  const Manager = (new (require('../src/manager/index.js')));
-
-  function log() {
-    // console.log(...arguments);
-  }
-
-  describe('.user()', () => {
-    it('should resolve correctly', () => {
-      const user = Manager.User().properties;
-      return assert.deepStrictEqual(true, true);
-    });
-  });
-})

package/test/ai/tools-live.js

@@ -1,170 +0,0 @@
-/**
- * Test: live cross-provider tool loops (libraries/ai)
- *
- * EXTENDED MODE ONLY — drives a real 2-step tool loop (tool call → tool result
- * → final answer) against the live Anthropic and OpenAI APIs to prove the
- * normalized tools interface end-to-end. Costs real API credits; uses the
- * cheapest models.
- *
- * Requires BACKEND_MANAGER_ANTHROPIC_API_KEY / BACKEND_MANAGER_OPENAI_API_KEY
- * in the runner environment.
- */
-const Anthropic = require('../../src/manager/libraries/ai/providers/anthropic.js');
-const OpenAI = require('../../src/manager/libraries/ai/providers/openai.js');
-
-const WEATHER_TOOL = {
-  name: 'get_weather',
-  description: 'Get the current weather for a city. ALWAYS use this tool when asked about weather.',
-  parameters: {
-    type: 'object',
-    properties: {
-      city: { type: 'string', description: 'City name' },
-    },
-    required: ['city'],
-  },
-};
-
-const SYSTEM = 'You are a weather assistant. Use the get_weather tool to answer weather questions, then summarize the result in one sentence.';
-const QUESTION = 'What is the weather in Paris right now?';
-const TOOL_RESULT = '{"temperature":"21C","conditions":"sunny"}';
-
-// Minimal assistant context for direct provider construction — live tests
-// bypass Manager.AI() to pin provider behavior precisely
-function directAssistant() {
-  return {
-    log: () => {},
-    error: () => {},
-    errorify: (message) => new Error(message),
-    getUser: () => ({ auth: { uid: 'bem-ai-live-test' } }),
-    request: { geolocation: { ip: '127.0.0.1' } },
-  };
-}
-
-function skipReason(keys) {
-  if (!process.env.TEST_EXTENDED_MODE) {
-    return 'TEST_EXTENDED_MODE not set (live AI tool-loop test)';
-  }
-
-  if (!keys.some((key) => process.env[key])) {
-    return `${keys[0]} not set in the runner environment`;
-  }
-
-  return false;
-}
-
-module.exports = {
-  description: 'Live AI tool loops (anthropic + openai)',
-  type: 'group',
-  tests: [
-    {
-      name: 'anthropic-two-step-tool-loop',
-      timeout: 120000,
-      skip: skipReason(['BACKEND_MANAGER_ANTHROPIC_API_KEY', 'ANTHROPIC_API_KEY']),
-
-      async run({ assert }) {
-        const provider = new Anthropic(directAssistant());
-
-        const base = [
-          { role: 'system', content: SYSTEM },
-          { role: 'user', content: QUESTION },
-        ];
-
-        // Step 1 — the model must call the tool
-        const first = await provider.request({
-          model: 'claude-haiku-4-5',
-          maxTokens: 1024,
-          messages: base,
-          tools: { list: [WEATHER_TOOL], choice: 'required' },
-        });
-
-        assert.equal(first.stopReason, 'tool_use', 'first turn stops for tool use');
-        assert.equal(first.toolCalls.length >= 1, true, 'at least one tool call');
-        assert.equal(first.toolCalls[0].name, 'get_weather', 'called the weather tool');
-        assert.equal(
-          String(first.toolCalls[0].arguments.city || '').toLowerCase().includes('paris'),
-          true,
-          'extracted the city',
-        );
-
-        // Step 2 — replay the raw assistant blocks + tool result, get the answer
-        const second = await provider.request({
-          model: 'claude-haiku-4-5',
-          maxTokens: 1024,
-          messages: [
-            ...base,
-            { role: 'assistant', content: first.raw.content },
-            { role: 'tool', toolCallId: first.toolCalls[0].id, content: TOOL_RESULT },
-          ],
-          tools: { list: [WEATHER_TOOL] },
-        });
-
-        assert.equal(second.stopReason, 'end', 'second turn is final');
-        assert.equal(second.toolCalls.length, 0, 'no further tool calls');
-
-        const answer = String(second.content).toLowerCase();
-        assert.equal(
-          answer.includes('21') || answer.includes('sunny'),
-          true,
-          `final answer uses the tool result (got: ${String(second.content).slice(0, 200)})`,
-        );
-        assert.equal(second.tokens.total.count > 0, true, 'tokens accounted');
-      },
-    },
-
-    {
-      name: 'openai-two-step-tool-loop',
-      timeout: 120000,
-      skip: skipReason(['BACKEND_MANAGER_OPENAI_API_KEY', 'OPENAI_API_KEY']),
-
-      async run({ assert }) {
-        const provider = new OpenAI(directAssistant());
-
-        const base = [
-          { role: 'system', content: SYSTEM },
-          { role: 'user', content: QUESTION },
-        ];
-
-        // Step 1 — the model must call the tool
-        const first = await provider.request({
-          model: 'gpt-5-nano',
-          maxTokens: 2048,
-          moderate: false,
-          messages: base,
-          tools: { list: [WEATHER_TOOL], choice: 'required' },
-        });
-
-        assert.equal(first.stopReason, 'tool_use', 'first turn stops for tool use');
-        assert.equal(first.toolCalls.length >= 1, true, 'at least one tool call');
-        assert.equal(first.toolCalls[0].name, 'get_weather', 'called the weather tool');
-        assert.equal(
-          String(first.toolCalls[0].arguments.city || '').toLowerCase().includes('paris'),
-          true,
-          'extracted the city',
-        );
-
-        // Step 2 — replay normalized toolCalls + tool result, get the answer
-        const second = await provider.request({
-          model: 'gpt-5-nano',
-          maxTokens: 2048,
-          moderate: false,
-          messages: [
-            ...base,
-            { role: 'assistant', toolCalls: first.toolCalls },
-            { role: 'tool', toolCallId: first.toolCalls[0].id, content: TOOL_RESULT },
-          ],
-          tools: { list: [WEATHER_TOOL] },
-        });
-
-        assert.equal(second.stopReason, 'end', 'second turn is final');
-        assert.equal(second.toolCalls.length, 0, 'no further tool calls');
-
-        const answer = String(second.content).toLowerCase();
-        assert.equal(
-          answer.includes('21') || answer.includes('sunny'),
-          true,
-          `final answer uses the tool result (got: ${String(second.content).slice(0, 200)})`,
-        );
-      },
-    },
-  ],
-};

package/test/boot/emulator-boots.js

@@ -1,37 +0,0 @@
-/**
- * Boot smoke — BEM's framework self-test layer.
- *
- * Runs ONLY when `npx mgr test` is invoked from the backend-manager repo (the
- * runner points BEM_TEST_BOOT_PROJECT at src/test/fixtures/firebase-project and
- * sets isFrameworkSelfTest). It proves the whole self-test path works end to end:
- * the fixture's functions/index.js boots `Manager.init()` inside the emulator, the
- * `bm_api` function is wired, and the hosting rewrite routes to it.
- *
- * This is BEM's equivalent of BXM's `boot/extension-loads` and UJM's site-boot
- * smoke. It is EXCLUDED from real-consumer runs (see runner.js discoverTests).
- */
-module.exports = {
-  description: 'Boot smoke — fixture emulator + bm_api reachable',
-  type: 'group',
-  timeout: 30000,
-
-  tests: [
-    {
-      name: 'bm_api-health-responds-over-hosting-rewrite',
-      async run({ http, assert }) {
-        const response = await http.get('backend-manager/test/health');
-        assert.isSuccess(response, 'bm_api /test/health should respond through the emulator hosting rewrite');
-      },
-    },
-    {
-      name: 'manager-booted-in-functions-runtime',
-      async run({ http, assert }) {
-        // /test/health is served by the bm_api function, which only exists if
-        // Manager.init() ran in the fixture's functions runtime. A success here
-        // means the local backend-manager (symlinked into the fixture) booted.
-        const response = await http.get('backend-manager/test/health');
-        assert.isSuccess(response, 'Manager.init() should have wired bm_api in the fixture functions runtime');
-      },
-    },
-  ],
-};

package/test/content/blog-generate.js

@@ -1,160 +0,0 @@
-/**
- * Blog article generation test.
- *
- * Two modes:
- *
- * 1. DEFAULT MODE (no env required)
- *    Verifies the blog auto-publisher config is readable and source resolution
- *    works correctly. No AI calls, no publishing. Fast, free, deterministic.
- *
- * 2. AI PIPELINE MODE (set TEST_EXTENDED_MODE=1)
- *    Runs the full blog auto-publisher pipeline: resolves a source, calls
- *    Ghostii to write an article, and publishes it to the website repo via
- *    admin/post. Same code path the daily cron uses. Costs money (AI tokens).
- *
- * Run from any consumer project's functions/ directory:
- *   npx mgr test mgr:content/blog-generate                   # config check (fast, free)
- *   TEST_EXTENDED_MODE=1  npx mgr test mgr:content/blog-generate  # full AI pipeline
- *
- * --- Env vars (AI mode only, require TEST_EXTENDED_MODE=1) ---
- *   BLOG_SOURCE=<type>        Override the source type for this run.
- *                              Values: '$brand', '$parent', '$feed:<url>', a URL, or text.
- *                              Default: picks randomly from the first content entry's sources[].
- *   BLOG_NO_PUBLISH=1         Generate the article but do NOT publish to the website repo.
- *                              Useful for iterating on prompt quality without committing posts.
- *   BLOG_OPEN=1               Auto-open the generated article in the default browser (macOS only).
- *
- * AI mode requires:
- *   BACKEND_MANAGER_KEY   — authenticates with Ghostii + parent server
- *   OPENAI_API_KEY        — Ghostii uses OpenAI internally (or BACKEND_MANAGER_OPENAI_API_KEY)
- *   PARENT_API_URL        — or set `parent` in backend-manager-config.json (for $parent sources)
- *
- * Default mode requires: nothing.
- */
-const path = require('path');
-const { execSync } = require('child_process');
-const jetpack = require('fs-jetpack');
-const powertools = require('node-powertools');
-
-module.exports = {
-  description: 'Generate a blog article (config check by default, full AI pipeline with TEST_EXTENDED_MODE)',
-  auth: 'none',
-  timeout: 300000,
-  async run({ assert, config, Manager, assistant, skip }) {
-    const env = process.env;
-    const blogConfig = Manager.config.blog;
-
-    // --- Default mode: config validation ---
-    if (!env.TEST_EXTENDED_MODE) {
-      assert.ok(blogConfig, 'blog config exists');
-      assert.ok(blogConfig.platform, 'blog.platform is set');
-      assert.equal(typeof blogConfig.enabled, 'boolean', 'blog.enabled is a boolean');
-
-      const contentArray = powertools.arrayify(blogConfig.content);
-      assert.ok(contentArray.length > 0, 'blog.content has at least one entry');
-
-      const entry = contentArray[0];
-      assert.ok(Array.isArray(entry.sources), 'first entry has sources array');
-      assert.ok(entry.sources.length > 0, 'first entry has at least one source');
-
-      // Verify source types are valid
-      for (const source of entry.sources) {
-        const validTypes = source === '$brand'
-          || source === '$parent'
-          || source.startsWith('$feed:')
-          || source.startsWith('http')
-          || typeof source === 'string';
-        assert.ok(validTypes, `source "${source}" is a valid type`);
-      }
-
-      // Verify provider exists
-      const providerPath = path.join(__dirname, '..', '..', 'src', 'manager', 'libraries', 'content', `${blogConfig.platform}.js`);
-      assert.ok(jetpack.exists(providerPath), `provider "${blogConfig.platform}" exists at ${providerPath}`);
-
-      console.log(`\n[blog-generate] Config OK:`);
-      console.log(`  platform: ${blogConfig.platform}`);
-      console.log(`  enabled: ${blogConfig.enabled}`);
-      console.log(`  entries: ${contentArray.length}`);
-      console.log(`  sources: ${entry.sources.join(', ')}`);
-      console.log(`  categories: ${(entry.categories || []).join(', ') || '(none)'}`);
-      console.log(`  tone: ${entry.tone || '(default)'}`);
-      console.log(`  (Set TEST_EXTENDED_MODE=1 to run the full AI pipeline.)`);
-      return;
-    }
-
-    // --- Extended mode: full AI pipeline ---
-    if (!blogConfig?.enabled) {
-      return skip('blog.enabled is false in config');
-    }
-
-    const publisherPath = path.join(__dirname, '..', '..', 'src', 'manager', 'events', 'cron', 'daily', 'blog-auto-publisher.js');
-    const publisher = require(publisherPath);
-
-    // Get content entries
-    const contentArray = powertools.arrayify(blogConfig.content);
-    assert.ok(contentArray.length > 0, 'blog.content has at least one entry');
-
-    // Clone and override for test
-    const content = JSON.parse(JSON.stringify(contentArray));
-    content[0].chance = 1.0;
-    content[0].quantity = 1;
-
-    // Override source if env specified
-    if (env.BLOG_SOURCE) {
-      content[0].sources = [env.BLOG_SOURCE];
-    }
-
-    Manager.config.blog.content = content;
-
-    // Output dir
-    const stamp = new Date().toISOString().replace(/[:.]/g, '-').replace(/-(\d{3})Z$/, '');
-    const outDir = path.join(process.cwd(), '..', '.temp', 'blog', `run-${stamp}`);
-    jetpack.dir(outDir);
-
-    console.log(`\n[blog-generate] Extended mode — full AI pipeline`);
-    console.log(`  platform: ${blogConfig.platform}`);
-    console.log(`  sources: ${content[0].sources.join(', ')}`);
-    console.log(`  publish: ${env.BLOG_NO_PUBLISH ? 'NO (BLOG_NO_PUBLISH=1)' : 'YES'}`);
-    console.log(`  output: ${outDir}`);
-
-    // Intercept publishArticle if BLOG_NO_PUBLISH is set
-    if (env.BLOG_NO_PUBLISH) {
-      const provider = require(path.join(__dirname, '..', '..', 'src', 'manager', 'libraries', 'content', `${blogConfig.platform}.js`));
-      const originalPublish = provider.publishArticle;
-      provider.publishArticle = async (ast, args) => {
-        console.log(`[blog-generate] SKIPPED publishArticle (BLOG_NO_PUBLISH=1)`);
-        console.log(`  title: ${args.article?.title || '(unknown)'}`);
-        return { post: null, url: null, slug: 'dry-run', path: null };
-      };
-
-      // Restore after test
-      process.on('exit', () => { provider.publishArticle = originalPublish; });
-    }
-
-    // Run the publisher
-    await publisher({
-      Manager,
-      assistant,
-      context: {},
-      libraries: Manager.libraries,
-    });
-
-    // Write metadata
-    jetpack.write(path.join(outDir, 'metadata.json'), JSON.stringify({
-      mode: 'extended',
-      platform: blogConfig.platform,
-      sources: content[0].sources,
-      published: !env.BLOG_NO_PUBLISH,
-      timestamp: new Date().toISOString(),
-    }, null, 2));
-
-    console.log(`\n[blog-generate] Done. Output: ${outDir}`);
-
-    // Auto-open (macOS)
-    if (env.BLOG_OPEN === '1' && process.platform === 'darwin') {
-      try { execSync(`open "${outDir}"`); } catch (e) { /* no-op */ }
-    }
-
-    assert.ok(true, 'Blog auto-publisher completed');
-  },
-};