@carchalabs/licensekit-quickstart 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bugra Omer Aydemir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @carchalabs/licensekit-quickstart
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Try [LicenseKit](https://licensekit.carchalabs.com) from a terminal.
+
+1. Get a trial key at [licensekit.carchalabs.com](https://licensekit.carchalabs.com/#try).
+2. Activate this computer:
+
+   ```
+   npx @carchalabs/licensekit-quickstart activate LK-XXXX-XXXX-XXXX-XXXX
+   ```
+
+3. Turn off the network and check the license. It is verified offline from the signed lease:
+
+   ```
+   npx @carchalabs/licensekit-quickstart status
+   ```
+
+4. Release the seat:
+
+   ```
+   npx @carchalabs/licensekit-quickstart deactivate
+   ```
+
+The quickstart sends the license key, a hash of this computer's machine ID, the device name "LicenseKit quickstart" and the platform. It saves the lease without encryption in the per-user application data folder, because a terminal has no system keychain. See the [privacy notice](https://licensekit.carchalabs.com/privacy/).
+
+Requires Node 22.13 or later. MIT License.

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+(0, cli_1.run)(process.argv.slice(2), { out: (line) => console.log(line) }).then((code) => {
+    process.exitCode = code;
+}, (error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";;;AACA,+BAA4B;AAE5B,IAAA,SAAG,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CACnE,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+export declare const PRODUCT = "licensekit-demo";
+export declare const DEFAULT_SERVER_URL = "https://licensekit.carchalabs.com";
+export declare const DEVICE_NAME = "LicenseKit quickstart";
+export interface RunOptions {
+    out: (line: string) => void;
+    storageDir?: string;
+    serverUrl?: string;
+    publicKeys?: string[];
+    fetchImpl?: typeof fetch;
+    machineId?: () => Promise<string>;
+}
+export declare function bundledPublicKeys(): string[];
+export declare function defaultStorageDir(os: string, env: Record<string, string | undefined>, home: string): string;
+export declare function run(args: string[], options: RunOptions): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVICE_NAME = exports.DEFAULT_SERVER_URL = exports.PRODUCT = void 0;
+exports.bundledPublicKeys = bundledPublicKeys;
+exports.defaultStorageDir = defaultStorageDir;
+exports.run = run;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const licensekit_electron_1 = require("@carchalabs/licensekit-electron");
+exports.PRODUCT = 'licensekit-demo';
+exports.DEFAULT_SERVER_URL = 'https://licensekit.carchalabs.com';
+exports.DEVICE_NAME = 'LicenseKit quickstart';
+const COMMAND = 'npx @carchalabs/licensekit-quickstart';
+const USAGE = [
+    `Usage: ${COMMAND} <command>`,
+    '',
+    'Commands:',
+    '  activate <license-key>  Activate this computer and save a signed lease',
+    '  status                  Check the license. Works offline from the saved lease',
+    "  deactivate              Release this computer's seat",
+    '',
+    'Get a trial key at https://licensekit.carchalabs.com/#try',
+];
+function bundledPublicKeys() {
+    return ['current.pem', 'next.pem'].map((file) => (0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'public-keys', file), 'utf8'));
+}
+function defaultStorageDir(os, env, home) {
+    if (os === 'darwin')
+        return (0, node_path_1.join)(home, 'Library', 'Application Support', 'licensekit-quickstart');
+    if (os === 'win32')
+        return (0, node_path_1.join)(env.APPDATA ?? (0, node_path_1.join)(home, 'AppData', 'Roaming'), 'licensekit-quickstart');
+    return (0, node_path_1.join)(env.XDG_CONFIG_HOME || (0, node_path_1.join)(home, '.config'), 'licensekit-quickstart');
+}
+const minute = (iso) => `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
+function report(state, out) {
+    out(`Status: ${state.status}`);
+    if (state.message)
+        out(state.message);
+    if (state.customer)
+        out(`Licensed to: ${state.customer}`);
+    if (state.status === 'valid' || state.status === 'grace') {
+        out(`Features: ${state.features.length ? state.features.join(', ') : 'none'}`);
+        out(`Expires: ${state.expiresAt ? minute(state.expiresAt) : 'never'}`);
+        if (state.revalidateBy)
+            out(`${state.status === 'valid' ? 'Check in by' : 'Works offline until'}: ${minute(state.revalidateBy)}`);
+    }
+}
+async function run(args, options) {
+    const { out } = options;
+    const [command, key] = args;
+    if (command === 'help' || command === '--help' || command === '-h') {
+        USAGE.forEach((line) => out(line));
+        return 0;
+    }
+    if (!['activate', 'status', 'deactivate'].includes(command ?? '') || (command === 'activate' && !key)) {
+        USAGE.forEach((line) => out(line));
+        return 2;
+    }
+    const kit = new licensekit_electron_1.LicenseKit({
+        serverUrl: options.serverUrl ?? exports.DEFAULT_SERVER_URL,
+        product: exports.PRODUCT,
+        publicKey: options.publicKeys ?? bundledPublicKeys(),
+        storageDir: options.storageDir ?? defaultStorageDir((0, node_os_1.platform)(), process.env, (0, node_os_1.homedir)()),
+        appVersion: '0.1.0',
+        fetchImpl: options.fetchImpl,
+        machineId: options.machineId,
+    });
+    if (command === 'activate') {
+        try {
+            const state = await kit.activate(key, exports.DEVICE_NAME);
+            report(state, out);
+            out('Saved lease: not encrypted. A terminal has no system keychain; an Electron app uses safeStorage.');
+            out(`Turn off the network and run "${COMMAND} status" to check it offline.`);
+            return 0;
+        }
+        catch (e) {
+            out(`Activation failed: ${e instanceof licensekit_electron_1.LicenseError ? e.message : String(e)}`);
+            return 1;
+        }
+    }
+    if (command === 'deactivate') {
+        try {
+            await kit.deactivate();
+            out("This computer's seat is released.");
+            return 0;
+        }
+        catch (e) {
+            out(`Deactivation failed: ${e instanceof licensekit_electron_1.LicenseError ? e.message : String(e)}`);
+            return 1;
+        }
+    }
+    const state = await kit.check();
+    if (state.status === 'unlicensed') {
+        out('Status: unlicensed');
+        out(`Run "${COMMAND} activate <license-key>" first.`);
+        return 1;
+    }
+    report(state, out);
+    out(`Checked: ${state.offline ? 'offline, from the signed lease saved on this computer' : 'online'}`);
+    return state.status === 'valid' || state.status === 'grace' ? 0 : 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,22 @@
 {
   "name": "@carchalabs/licensekit-quickstart",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Try LicenseKit from a terminal: activate a trial key, then check the license offline",
+  "homepage": "https://licensekit.carchalabs.com/docs/",
+  "repository": { "type": "git", "url": "git+https://github.com/carcha-labs/licensekit-sdk.git", "directory": "packages/quickstart" },
+  "bugs": { "url": "https://github.com/carcha-labs/licensekit-sdk/issues" },
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "bin": { "licensekit-quickstart": "dist/bin.js" },
+  "files": ["dist", "src", "public-keys"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@carchalabs/licensekit-electron": "0.1.0"
+  },
+  "engines": { "node": ">=22.13" },
+  "publishConfig": { "access": "public" },
+  "license": "MIT"
+}

package/public-keys/current.pem

@@ -0,0 +1,3 @@
+-----BEGIN PUBLIC KEY-----
+MCowBQYDK2VwAyEALiAdmTkGG9jtE74LHZzjfNugnNT9bIvVBRm0onTDGgQ=
+-----END PUBLIC KEY-----

package/public-keys/next.pem

@@ -0,0 +1,3 @@
+-----BEGIN PUBLIC KEY-----
+MCowBQYDK2VwAyEA71j+vfBUoOPZ2QfmhzjZQv/Aj600Wni1Vv7y5A/r/xg=
+-----END PUBLIC KEY-----

package/src/bin.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { run } from './cli';
+
+run(process.argv.slice(2), { out: (line) => console.log(line) }).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  },
+);

package/src/cli.ts

@@ -0,0 +1,105 @@
+import { readFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { LicenseError, LicenseKit, LicenseState } from '@carchalabs/licensekit-electron';
+
+export const PRODUCT = 'licensekit-demo';
+export const DEFAULT_SERVER_URL = 'https://licensekit.carchalabs.com';
+export const DEVICE_NAME = 'LicenseKit quickstart';
+const COMMAND = 'npx @carchalabs/licensekit-quickstart';
+
+export interface RunOptions {
+  out: (line: string) => void;
+  storageDir?: string;
+  serverUrl?: string;
+  publicKeys?: string[];
+  fetchImpl?: typeof fetch;
+  machineId?: () => Promise<string>;
+}
+
+const USAGE = [
+  `Usage: ${COMMAND} <command>`,
+  '',
+  'Commands:',
+  '  activate <license-key>  Activate this computer and save a signed lease',
+  '  status                  Check the license. Works offline from the saved lease',
+  "  deactivate              Release this computer's seat",
+  '',
+  'Get a trial key at https://licensekit.carchalabs.com/#try',
+];
+
+export function bundledPublicKeys(): string[] {
+  return ['current.pem', 'next.pem'].map((file) => readFileSync(join(__dirname, '..', 'public-keys', file), 'utf8'));
+}
+
+export function defaultStorageDir(os: string, env: Record<string, string | undefined>, home: string): string {
+  if (os === 'darwin') return join(home, 'Library', 'Application Support', 'licensekit-quickstart');
+  if (os === 'win32') return join(env.APPDATA ?? join(home, 'AppData', 'Roaming'), 'licensekit-quickstart');
+  return join(env.XDG_CONFIG_HOME || join(home, '.config'), 'licensekit-quickstart');
+}
+
+const minute = (iso: string) => `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
+
+function report(state: LicenseState, out: (line: string) => void) {
+  out(`Status: ${state.status}`);
+  if (state.message) out(state.message);
+  if (state.customer) out(`Licensed to: ${state.customer}`);
+  if (state.status === 'valid' || state.status === 'grace') {
+    out(`Features: ${state.features.length ? state.features.join(', ') : 'none'}`);
+    out(`Expires: ${state.expiresAt ? minute(state.expiresAt) : 'never'}`);
+    if (state.revalidateBy) out(`${state.status === 'valid' ? 'Check in by' : 'Works offline until'}: ${minute(state.revalidateBy)}`);
+  }
+}
+
+export async function run(args: string[], options: RunOptions): Promise<number> {
+  const { out } = options;
+  const [command, key] = args;
+  if (command === 'help' || command === '--help' || command === '-h') {
+    USAGE.forEach((line) => out(line));
+    return 0;
+  }
+  if (!['activate', 'status', 'deactivate'].includes(command ?? '') || (command === 'activate' && !key)) {
+    USAGE.forEach((line) => out(line));
+    return 2;
+  }
+  const kit = new LicenseKit({
+    serverUrl: options.serverUrl ?? DEFAULT_SERVER_URL,
+    product: PRODUCT,
+    publicKey: options.publicKeys ?? bundledPublicKeys(),
+    storageDir: options.storageDir ?? defaultStorageDir(platform(), process.env, homedir()),
+    appVersion: '0.1.0',
+    fetchImpl: options.fetchImpl,
+    machineId: options.machineId,
+  });
+  if (command === 'activate') {
+    try {
+      const state = await kit.activate(key, DEVICE_NAME);
+      report(state, out);
+      out('Saved lease: not encrypted. A terminal has no system keychain; an Electron app uses safeStorage.');
+      out(`Turn off the network and run "${COMMAND} status" to check it offline.`);
+      return 0;
+    } catch (e) {
+      out(`Activation failed: ${e instanceof LicenseError ? e.message : String(e)}`);
+      return 1;
+    }
+  }
+  if (command === 'deactivate') {
+    try {
+      await kit.deactivate();
+      out("This computer's seat is released.");
+      return 0;
+    } catch (e) {
+      out(`Deactivation failed: ${e instanceof LicenseError ? e.message : String(e)}`);
+      return 1;
+    }
+  }
+  const state = await kit.check();
+  if (state.status === 'unlicensed') {
+    out('Status: unlicensed');
+    out(`Run "${COMMAND} activate <license-key>" first.`);
+    return 1;
+  }
+  report(state, out);
+  out(`Checked: ${state.offline ? 'offline, from the signed lease saved on this computer' : 'online'}`);
+  return state.status === 'valid' || state.status === 'grace' ? 0 : 1;
+}