Build for Light Kali Packages • APIs • Manifest • Commands • Lifecycle Current package bridge reference

(() => {
  'use strict';

  const COMMANDS = Object.freeze({
    test: {
      description: 'Run a package self-test.',
      usage: 'test [TEXT...]',
      aliases: [],
      kind: 'plain',
      run: ({ args = [], api } = {}) => {
        const text = args.length ? args.join(' ') : 'test: ok';
        return [api.line(text, 'success')];
      }
    }
  });

  const manifest = Object.freeze({
    name: 'test',
    version: '1.0.0',
    description: 'Minimal Light Kali test package.',
    author: 'Your Name',
    help: 'test help',
    official: false,
    default: false,
    securityLevel: 'low',
    permissions: Object.freeze({
      storage: 'none',
      cookies: 'none',
      network: 'none',
      filesystem: 'none'
    }),
    commands: Object.freeze(Object.keys(COMMANDS)),
    dependencies: Object.freeze([]),
    entry: 'install'
  });

  const install = async api => {
    for (const [name, definition] of Object.entries(COMMANDS)) {
      if (!manifest.commands.includes(name)) {
        throw new Error(`COMMAND_NOT_DECLARED:${name}`);
      }
      const registered = api.registerCommand(name, definition);
      if (registered === false) {
        throw new Error(`PACKAGE_COMMAND_REGISTRATION_FAILED:${name}`);
      }
    }
    return [];
  };

  const uninstall = async api => {
    for (const name of manifest.commands) {
      api.unregisterCommand(name);
    }
    return [];
  };

  window.__kali_pkg_test = Object.freeze({
    manifest,
    install,
    uninstall
  });
})();

const manifest = Object.freeze({
  name: 'example',
  version: '1.0.0',
  description: 'Example Light Kali package.',
  author: 'Your Name',
  help: 'example help',
  permissions: Object.freeze({
    storage: 'none',
    cookies: 'none',
    network: 'none',
    filesystem: 'none'
  }),
  commands: Object.freeze(['example']),
  dependencies: Object.freeze([]),
  entry: 'install',
  default: false,
  official: false,
  securityLevel: 'medium'
});

api.registerCommand('test', {
  description: 'Run the test command.',
  usage: 'test [TEXT...]',
  aliases: ['t'],
  kind: 'plain',
  run: ({ raw, tokens, args, api, ctx } = {}) => [
    api.line(`raw: ${raw}`, 'muted'),
    api.line(`tokens: ${tokens.join(', ')}`, 'dim'),
    api.line(args.length ? args.join(' ') : 'test: ok', 'success')
  ]
});

api.registerCommand('login-demo', {
  description: 'Run a package-managed flow example.',
  usage: 'login-demo',
  aliases: [],
  kind: 'flow',
  begin: async ({ raw, tokens, args, api, ctx } = {}) => {
    return api.confirm(
      'Continue?',
      'Answer Y or N to continue.'
    );
  },
  next: async ({ input, api } = {}) => [
    api.line(`Input: ${String(input ?? '')}`, 'muted')
  ],
  cancel: () => [
    api.line('Cancelled.', 'muted')
  ],
  resume: () => [
    api.line('Flow is waiting for input.', 'muted')
  ]
});

apt install https://example.com/path/to/test.js

return [
  api.line('Ready.', 'success'),
  api.line('Warning: example warning.', 'danger'),
  api.line('Current path: /home/kali', 'dim'),
  api.spacer(),
  api.line('More information', 'accent')
];

help
help <command>

function getFreeUserProxy() {
  return window.__FreeUserProxy
    ?? globalThis.__FreeUserProxy
    ?? null;
}

function isFreeUserProxyAvailable() {
  const fup = getFreeUserProxy();
  return Boolean(
    fup &&
    typeof fup.getWorkingProxies === 'function'
  );
}