Offline mode and grace

"""Full SDK configuration and guarded features. Python3.9+, SDK1.0.0.
Run: python python.py activate|check|validate|deactivate; credentials in KDP_*.
Output: valid/source/code/pdf_export/seat_limit; never credentials or customer data.
"""
import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path
from license_sdk import LicenseClient

try:
    key_path = os.getenv('KDP_PUBLIC_KEY_FILE')
    client = LicenseClient(
        product=os.environ['KDP_APP_ID'], environment=os.getenv('KDP_ENVIRONMENT', 'SANDBOX'),
        base_url=os.getenv('KDP_BASE_URL', 'https://licensing.kdpika.com'),
        application_name='KDPika configuration example', application_version='1.0.0',
        verification_key=json.loads(Path(key_path).read_text()) if key_path else None,
        storage_dir=Path(os.environ['KDP_STATE_DIR']), timeout=15.0,
        prefer_keyring=os.getenv('KDP_PREFER_KEYRING', 'true') == 'true',
        transport=None, clock=lambda: datetime.now(timezone.utc))
    action = sys.argv[1] if len(sys.argv) == 2 else 'check'
    if action == 'activate':
        result = client.activate(os.environ['KDP_LICENSE_KEY'], os.getenv('KDP_CUSTOMER_EMAIL'))
    elif action == 'validate': result = client.validate()
    elif action == 'deactivate': result = client.deactivate()
    elif action == 'check': result = client.check(force_online=False)
    else: raise ValueError('Unknown action')
    # A feature helper by itself is not an access check.
    enabled = result.valid and result.feature_value('pdf_export', False) is True
    raw_limit = result.feature_value('seat_count', 0) if result.valid else 0
    limit = raw_limit if type(raw_limit) is int and raw_limit >= 0 else 0
    print(json.dumps({'valid':result.valid,'source':result.source,'code':result.error_code,
                      'pdf_export':bool(enabled),'seat_limit':limit}))
    sys.exit(0 if result.valid else 1)
except Exception:
    print('Configuration or verification failed. Check local settings.', file=sys.stderr)
    sys.exit(1)

// Full SDK configuration and guarded features. Node22+, SDK1.0.0 local package.
// Run: node javascript.mjs activate|check|validate|deactivate; KDP_* env values.
// Output safe result fields, never tokens. No automatic safeStorage integration.
import fs from 'node:fs';
import { LicenseClient } from '@kdpika/license-sdk';
try {
  const client = new LicenseClient({
    product:process.env.KDP_APP_ID, environment:process.env.KDP_ENVIRONMENT || 'SANDBOX',
    baseUrl:process.env.KDP_BASE_URL || 'https://licensing.kdpika.com',
    applicationName:'KDPika configuration example', applicationVersion:'1.0.0',
    verificationKey:process.env.KDP_PUBLIC_KEY_FILE ? JSON.parse(fs.readFileSync(process.env.KDP_PUBLIC_KEY_FILE,'utf8')) : null,
    storageDir:process.env.KDP_STATE_DIR, timeoutMs:15000, fetchImpl:globalThis.fetch,
    clock:() => new Date()
  });
  const action = process.argv[2] || 'check'; let result;
  if (action === 'activate') result = await client.activate(process.env.KDP_LICENSE_KEY,process.env.KDP_CUSTOMER_EMAIL || null);
  else if (action === 'validate') result = await client.validate();
  else if (action === 'deactivate') result = await client.deactivate();
  else if (action === 'check') result = await client.check(false);
  else throw Error('Unknown action');
  const enabled = result.valid && result.featureValue('pdf_export',false) === true;
  const rawLimit = result.valid ? result.featureValue('seat_count',0) : 0;
  const limit = Number.isSafeInteger(rawLimit) && rawLimit >= 0 ? rawLimit : 0;
  console.log(JSON.stringify({valid:result.valid,source:result.source,code:result.errorCode,pdf_export:Boolean(enabled),seat_limit:limit}));
  process.exitCode = result.valid ? 0 : 1;
} catch { console.error('Configuration or verification failed. Check local settings.'); process.exitCode = 1; }

<?php
// Full configuration/guarded features. PHP8.2+, cURL/Sodium, SDK1.0.0 direct source.
// Run: php php.php activate|check|validate|deactivate. KDP_SDK_DIR points to SDK.
// Output safe result fields only. Credentials use KDP_* environment variables.
declare(strict_types=1);
try {
    $sdk = rtrim((string)getenv('KDP_SDK_DIR'), '/');
    require $sdk . '/src/LicenseResult.php'; require $sdk . '/src/LicenseClient.php';
    $keyFile = getenv('KDP_PUBLIC_KEY_FILE');
    $client = new KDPika\LicenseSdk\LicenseClient(
        product:(string)getenv('KDP_APP_ID'), environment:getenv('KDP_ENVIRONMENT') ?: 'SANDBOX',
        baseUrl:getenv('KDP_BASE_URL') ?: 'https://licensing.kdpika.com',
        applicationName:'KDPika configuration example', applicationVersion:'1.0.0',
        verificationKey:$keyFile ? json_decode((string)file_get_contents($keyFile),true,64,JSON_THROW_ON_ERROR) : null,
        storageDir:(string)getenv('KDP_STATE_DIR'), timeout:15.0, transport:null,
        clock:static fn(): DateTimeImmutable => new DateTimeImmutable('now',new DateTimeZone('UTC')));
    $action = $argv[1] ?? 'check';
    $result = match($action) {
        'activate' => $client->activate((string)getenv('KDP_LICENSE_KEY'),getenv('KDP_CUSTOMER_EMAIL') ?: null),
        'check' => $client->check(false), 'validate' => $client->validate(), 'deactivate' => $client->deactivate(),
        default => throw new RuntimeException('Unknown action')
    };
    $enabled = $result->valid && $result->featureValue('pdf_export',false) === true;
    $rawLimit = $result->valid ? $result->featureValue('seat_count',0) : 0;
    $limit = is_int($rawLimit) && $rawLimit >= 0 ? $rawLimit : 0;
    echo json_encode(['valid'=>$result->valid,'source'=>$result->source,'code'=>$result->errorCode,'pdf_export'=>(bool)$enabled,'seat_limit'=>$limit],JSON_THROW_ON_ERROR) . PHP_EOL;
    exit($result->valid ? 0 : 1);
} catch (Throwable) { fwrite(STDERR,"Configuration or verification failed. Check local settings.\n"); exit(1); }

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <ProjectReference Include="$(KDPikaSdkProject)" />
  </ItemGroup>
</Project>

// Full SDK configuration/guarded features. .NET7+, SDK1.0.0 project reference.
// Run built Configuration.dll activate|check|validate|deactivate. KDP_* env values.
// Output safe result fields only. Native DPAPI is not built into this SDK.
using System.Text.Json;
using KDPika.LicenseSdk;
try {
    string Required(string name) => Environment.GetEnvironmentVariable(name) ?? throw new ArgumentException(name);
    string Optional(string name,string fallback) => Environment.GetEnvironmentVariable(name) ?? fallback;
    var keyPath = Environment.GetEnvironmentVariable("KDP_PUBLIC_KEY_FILE");
    using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(15) };
    var client = new LicenseClient(
        product:Required("KDP_APP_ID"), environment:Optional("KDP_ENVIRONMENT","SANDBOX"),
        baseUrl:Optional("KDP_BASE_URL","https://licensing.kdpika.com"),
        applicationName:"KDPika configuration example", applicationVersion:"1.0.0",
        verificationKey:keyPath is null ? null : JsonSerializer.Deserialize<Dictionary<string,string>>(File.ReadAllText(keyPath)),
        storageDir:Required("KDP_STATE_DIR"), httpClient:http, clock:() => DateTimeOffset.UtcNow);
    var result = (args.FirstOrDefault() ?? "check") switch {
        "activate" => await client.ActivateAsync(Required("KDP_LICENSE_KEY"),Environment.GetEnvironmentVariable("KDP_CUSTOMER_EMAIL")),
        "check" => await client.CheckAsync(false), "validate" => await client.ValidateAsync(),
        "deactivate" => await client.DeactivateAsync(), _ => throw new ArgumentException("Unknown action")
    };
    var enabled = result.Valid && result.Feature("pdf_export",false);
    var rawLimit = result.Valid ? result.FeatureValue("seat_count") : null;
    var limit = rawLimit is JsonElement value && value.ValueKind == JsonValueKind.Number && value.TryGetInt32(out var number) && number >= 0 ? number : 0;
    Console.WriteLine(JsonSerializer.Serialize(new {valid=result.Valid,source=result.Source,code=result.ErrorCode,pdf_export=enabled,seat_limit=limit}));
    return result.Valid ? 0 : 1;
} catch { Console.Error.WriteLine("Configuration or verification failed. Check local settings."); return 1; }