@undefineds.co/xpod 0.1.0-local.202602081751 → 0.1.2

package/README.md

@@ -38,6 +38,16 @@ yarn build
   yarn publish:local:dry
   ```
 
+- Publish stable release (`latest` tag by default):
+  ```bash
+  yarn publish:release
+  ```
+
+- Dry-run stable release publish:
+  ```bash
+  yarn publish:release:dry
+  ```
+
 ## Quick Start
 
 | Mode | Command | Description |
@@ -56,6 +66,24 @@ Visit [http://localhost:3000/](http://localhost:3000/) after startup.
 
 See [docs/deployment-modes.md](docs/deployment-modes.md) for detailed profile comparison and cloud-edge coordination.
 
+## Single-File Packaging
+
+Build a self-extracting single-file launcher:
+
+```bash
+yarn build:single:standalone
+```
+
+Output file: `dist/xpod-single.cjs`
+
+Run it directly (requires Node.js):
+
+```bash
+node dist/xpod-single.cjs --mode local
+```
+
+On first start, it extracts runtime files to cache (default `~/.xpod/single-file-cache/`; override with `XPOD_SINGLE_CACHE_DIR`) and reuses that cache on subsequent launches.
+
 ## Deployment Strategies
 
 Xpod supports two primary deployment models, functioning like a Personal OS or a Multi-User Mainframe:

package/bin/xpod.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli/index.js');

package/config/cli.json

@@ -8,12 +8,6 @@
       "comment": "Extend the CLI with additional parameters. All use CSS_ env prefix via Yargs.",
       "@id": "urn:solid-server-app-setup:default:CliExtractor",
       "@type": "YargsCliExtractor",
-      "options": {
-        "usage": "node ./bin/server.js [args]",
-        "envVarPrefix": "CSS",
-        "loadFromEnv": true,
-        "strictMode": false
-      },
       "parameters": [
         {
           "comment": "=== Visible CLI parameters ===",
@@ -52,209 +46,327 @@
           "comment": "=== Hidden: Data Layer ===",
           "@type": "YargsParameter",
           "name": "identityDbUrl",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
+        },
+        {
+          "@type": "YargsParameter",
+          "name": "identityTablePrefix",
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "usageDbUrl",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "minioAccessKey",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "minioSecretKey",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "minioEndpoint",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "minioBucketName",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "cachePath",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "cacheMaxSize",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "redisClient",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "redisUsername",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "redisPassword",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "emailConfigHost",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "emailConfigPort",
-          "options": { "type": "number", "hidden": true }
+          "options": {
+            "type": "number",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "emailConfigAuthUser",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "emailConfigAuthPass",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "comment": "=== Hidden: Business Features ===",
           "@type": "YargsParameter",
           "name": "signalEndpoint",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "clusterIngressDomain",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "clusterIngressIp",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "dnsRootDomain",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "dnsRecordTtl",
-          "options": { "type": "number", "hidden": true }
+          "options": {
+            "type": "number",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "tencentDnsTokenId",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "tencentDnsToken",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "tencentDnsBaseUrl",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "tencentDnsDefaultLineId",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "tunnelEntrypoints",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "edgeHealthProbesEnabled",
-          "options": { "type": "boolean", "hidden": true }
+          "options": {
+            "type": "boolean",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "edgeHealthProbeTimeout",
-          "options": { "type": "number", "hidden": true }
+          "options": {
+            "type": "number",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "frpServerHost",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "frpServerPort",
-          "options": { "type": "number", "hidden": true }
+          "options": {
+            "type": "number",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "frpToken",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "frpProtocol",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "nodeId",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "nodeToken",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "nodePublicAddress",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "nodeHeartbeatInterval",
-          "options": { "type": "number", "hidden": true }
+          "options": {
+            "type": "number",
+            "hidden": true
+          }
         },
         {
           "comment": "=== Hidden: Multi-Node Center Deployment ===",
           "@type": "YargsParameter",
           "name": "podRoutingEnabled",
-          "options": { "type": "boolean", "hidden": true }
+          "options": {
+            "type": "boolean",
+            "hidden": true
+          }
         },
         {
           "comment": "=== Hidden: IdP/SP Separation ===",
           "@type": "YargsParameter",
           "name": "baseDomain",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "idpUrl",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         },
         {
           "@type": "YargsParameter",
           "name": "allowedHosts",
-          "options": { "type": "string", "hidden": true }
+          "options": {
+            "type": "string",
+            "hidden": true
+          }
         }
       ]
-    },
-    {
-      "comment": "Combines a CliExtractor and ShorthandResolver to be used by the AppRunner.",
-      "@id": "urn:solid-server-app-setup:default:CliResolver",
-      "@type": "CliResolver",
-      "cliExtractor": { "@id": "urn:solid-server-app-setup:default:CliExtractor" },
-      "shorthandResolver": { "@id": "urn:solid-server-app-setup:default:ShorthandResolver" }
     }
   ]
 }

package/config/cloud.json

@@ -11,17 +11,22 @@
   "@graph": [
     {
       "comment": "Redis-based locker with expiration wrapper for clustered deployments",
-      "@id": "urn:solid-server:default:ResourceLocker",
-      "@type": "WrappedExpiringReadWriteLocker",
-      "locker": {
-        "@type": "RedisLocker",
-        "redisClient": {
-          "@id": "urn:solid-server:default:variable:redisClient",
-          "@type": "Variable"
-        },
-        "attemptSettings_retryCount": 10
+      "@type": "Override",
+      "overrideInstance": {
+        "@id": "urn:solid-server:default:ResourceLocker"
       },
-      "expiration": 6000
+      "overrideParameters": {
+        "@type": "WrappedExpiringReadWriteLocker",
+        "locker": {
+          "@type": "RedisLocker",
+          "redisClient": {
+            "@id": "urn:solid-server:default:variable:redisClient",
+            "@type": "Variable"
+          },
+          "attemptSettings_retryCount": 10
+        },
+        "expiration": 6000
+      }
     },
     {
       "comment": "Identifier strategy that allows cluster root host and node subdomains.",
@@ -51,14 +56,30 @@
       "@id": "urn:solid-server:default:PrimarySequenceInitializer",
       "@type": "SequenceHandler",
       "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/SequenceHandler.jsonld#SequenceHandler_handlers": [
-        { "@id": "urn:solid-server:default:CleanupInitializer" },
-        { "@id": "urn:solid-server:default:MigrationInitializer" },
-        { "@id": "urn:solid-server:default:BaseUrlVerifier" },
-        { "@id": "urn:solid-server:default:PrimaryParallelInitializer" },
-        { "@id": "urn:solid-server:default:ModuleVersionVerifier" },
-        { "@id": "urn:solid-server:default:WorkerManager" },
-        { "@id": "urn:solid-server:default:SeededAccountInitializer" },
-        { "@id": "urn:undefineds:xpod:CenterNodeRegistrationService" }
+        {
+          "@id": "urn:solid-server:default:CleanupInitializer"
+        },
+        {
+          "@id": "urn:solid-server:default:MigrationInitializer"
+        },
+        {
+          "@id": "urn:solid-server:default:BaseUrlVerifier"
+        },
+        {
+          "@id": "urn:solid-server:default:PrimaryParallelInitializer"
+        },
+        {
+          "@id": "urn:solid-server:default:ModuleVersionVerifier"
+        },
+        {
+          "@id": "urn:solid-server:default:WorkerManager"
+        },
+        {
+          "@id": "urn:solid-server:default:SeededAccountInitializer"
+        },
+        {
+          "@id": "urn:undefineds:xpod:CenterNodeRegistrationService"
+        }
       ]
     },
     {
@@ -138,17 +159,27 @@
       "comment": "Vector HTTP Handler",
       "@id": "urn:undefineds:xpod:VectorHttpHandler",
       "@type": "VectorHttpHandler",
-      "vectorStore": { "@id": "urn:undefineds:xpod:VectorStore" },
-      "credentialsExtractor": { "@id": "urn:solid-server:default:CredentialsExtractor" },
-      "permissionReader": { "@id": "urn:solid-server:default:PermissionReader" },
-      "authorizer": { "@id": "urn:solid-server:default:Authorizer" }
+      "vectorStore": {
+        "@id": "urn:undefineds:xpod:VectorStore"
+      },
+      "credentialsExtractor": {
+        "@id": "urn:solid-server:default:CredentialsExtractor"
+      },
+      "permissionReader": {
+        "@id": "urn:solid-server:default:PermissionReader"
+      },
+      "authorizer": {
+        "@id": "urn:solid-server:default:Authorizer"
+      }
     },
     {
       "comment": "Terminal Sidecar HTTP Handler - manages PTY sessions for trusted AI agents",
       "@id": "urn:undefineds:xpod:TerminalHttpHandler",
       "@type": "TerminalHttpHandler",
       "sidecarPath": "/-/terminal",
-      "credentialsExtractor": { "@id": "urn:solid-server:default:CredentialsExtractor" },
+      "credentialsExtractor": {
+        "@id": "urn:solid-server:default:CredentialsExtractor"
+      },
       "maxSessionsPerUser": 5,
       "maxTotalSessions": 100,
       "defaultTimeout": 3600,
@@ -325,10 +356,18 @@
         "@type": "UsageTrackingStore",
         "UsageTrackingStore:_source": {
           "@type": "SparqlUpdateResourceStore",
-          "identifierStrategy": { "@id": "urn:solid-server:default:IdentifierStrategy" },
-          "auxiliaryStrategy": { "@id": "urn:solid-server:default:AuxiliaryStrategy" },
-          "metadataStrategy": { "@id": "urn:solid-server:default:MetadataStrategy" },
-          "accessor": { "@id": "urn:undefineds:xpod:MixDataAccessor" }
+          "identifierStrategy": {
+            "@id": "urn:solid-server:default:IdentifierStrategy"
+          },
+          "auxiliaryStrategy": {
+            "@id": "urn:solid-server:default:AuxiliaryStrategy"
+          },
+          "metadataStrategy": {
+            "@id": "urn:solid-server:default:MetadataStrategy"
+          },
+          "accessor": {
+            "@id": "urn:undefineds:xpod:MixDataAccessor"
+          }
         },
         "options_identityDbUrl": {
           "@id": "urn:solid-server:default:variable:identityDbUrl",
@@ -348,10 +387,18 @@
       },
       "overrideParameters": {
         "@type": "RepresentationPartialConvertingStore",
-        "source": { "@id": "urn:solid-server:default:ResourceStore_Backend" },
-        "metadataStrategy": { "@id": "urn:solid-server:default:MetadataStrategy" },
-        "options_inConverter": { "@id": "urn:solid-server:default:RepresentationConverter" },
-        "options_outConverter": { "@id": "urn:solid-server:default:RepresentationConverter" },
+        "source": {
+          "@id": "urn:solid-server:default:ResourceStore_Backend"
+        },
+        "metadataStrategy": {
+          "@id": "urn:solid-server:default:MetadataStrategy"
+        },
+        "options_inConverter": {
+          "@id": "urn:solid-server:default:RepresentationConverter"
+        },
+        "options_outConverter": {
+          "@id": "urn:solid-server:default:RepresentationConverter"
+        },
         "options_inPreferences_type": {
           "RepresentationPartialConvertingStore:_options_inPreferences_type_key": "internal/quads",
           "RepresentationPartialConvertingStore:_options_inPreferences_type_value": 1