@volter/world-core 3.0.155 → 3.0.157

package/dist/src/xml.d.ts

@@ -0,0 +1,30 @@
+export type XmlElement = {
+    kind: 'element';
+    name: string;
+    attributes: Record<string, string>;
+    content: XmlContent[];
+};
+export type XmlText = {
+    kind: 'text' | 'cdata' | 'comment';
+    value: string;
+};
+export type XmlInstruction = {
+    kind: 'processing-instruction';
+    target: string;
+    value: string;
+};
+export type XmlContent = XmlElement | XmlText | XmlInstruction;
+export type XmlDocument = {
+    root: XmlElement;
+    prologue: Array<XmlText | XmlInstruction>;
+    epilogue: Array<XmlText | XmlInstruction>;
+};
+export declare class XmlDocumentError extends Error {
+    readonly code: 'parser-unavailable' | 'unsupported-declaration' | 'malformed-document' | 'parsing-limit';
+    constructor(code: 'parser-unavailable' | 'unsupported-declaration' | 'malformed-document' | 'parsing-limit');
+}
+/** No I/O, globals, vendor names, defaults or recovery. Importing this module does not load the grammar.
+ * The XML declaration is a processing instruction in the prologue. A leading BOM is refused.
+ * Raw DOCTYPE/ENTITY markers refuse even inside comments or CDATA: this conservative preflight is linear.
+ */
+export declare function parseDocument(source: string): Promise<XmlDocument>;

package/dist/src/xml.js

@@ -0,0 +1,74 @@
+export class XmlDocumentError extends Error {
+    code;
+    constructor(code) {
+        super(code === 'parser-unavailable' ? 'Strict XML parser @xmldom/xmldom 0.9.12 is unavailable'
+            : code === 'unsupported-declaration' ? 'DTD and entity declarations are unsupported'
+                : code === 'parsing-limit' ? 'XML document exceeds the supported parsing limits'
+                    : 'XML document is not well formed');
+        this.code = code;
+        this.name = 'XmlDocumentError';
+    }
+}
+let grammar;
+function loadGrammar() {
+    return grammar ??= import('@xmldom/xmldom').catch(() => { grammar = undefined; throw new XmlDocumentError('parser-unavailable'); });
+}
+/** No I/O, globals, vendor names, defaults or recovery. Importing this module does not load the grammar.
+ * The XML declaration is a processing instruction in the prologue. A leading BOM is refused.
+ * Raw DOCTYPE/ENTITY markers refuse even inside comments or CDATA: this conservative preflight is linear.
+ */
+export async function parseDocument(source) {
+    if (typeof source !== 'string' || source.charCodeAt(0) === 0xfeff)
+        throw new XmlDocumentError('malformed-document');
+    if (source.indexOf('<!DOCTYPE') !== -1 || source.indexOf('<!ENTITY') !== -1)
+        throw new XmlDocumentError('unsupported-declaration');
+    const { DOMParser } = await loadGrammar();
+    try {
+        const document = new DOMParser({ onError: () => { throw new XmlDocumentError('malformed-document'); } }).parseFromString(source, 'application/xml');
+        const convert = (node) => {
+            if (node.nodeType === 1) {
+                const element = node;
+                const attributes = Object.create(null);
+                for (const attr of Array.from(element.attributes))
+                    attributes[attr.name] = attr.value;
+                return { kind: 'element', name: element.tagName, attributes, content: [] };
+            }
+            if (node.nodeType === 3 || node.nodeType === 4 || node.nodeType === 8)
+                return { kind: node.nodeType === 3 ? 'text' : node.nodeType === 4 ? 'cdata' : 'comment', value: node.nodeValue ?? '' };
+            if (node.nodeType === 7)
+                return { kind: 'processing-instruction', target: node.nodeName, value: node.nodeValue ?? '' };
+            throw new XmlDocumentError(node.nodeType === 10 ? 'unsupported-declaration' : 'malformed-document');
+        };
+        const pending = [];
+        const one = (source) => {
+            const target = convert(source);
+            if (target.kind === 'element')
+                pending.push({ source, target });
+            return target;
+        };
+        const nodes = Array.from(document.childNodes).map(one);
+        while (pending.length) {
+            const { source, target } = pending.pop();
+            for (const child of Array.from(source.childNodes))
+                target.content.push(one(child));
+        }
+        const roots = nodes.filter((node) => node.kind === 'element');
+        if (roots.length !== 1)
+            throw new XmlDocumentError('malformed-document');
+        const root = roots[0], index = nodes.indexOf(root);
+        const outside = (list) => list.map(node => {
+            if (node.kind === 'element' || node.kind === 'cdata' || (node.kind === 'text' && node.value.trim()))
+                throw new XmlDocumentError('malformed-document');
+            return node;
+        });
+        return { root, prologue: outside(nodes.slice(0, index)), epilogue: outside(nodes.slice(index + 1)) };
+    }
+    catch (error) {
+        if (error instanceof XmlDocumentError)
+            throw error;
+        if (error instanceof RangeError)
+            throw new XmlDocumentError('parsing-limit');
+        // The grammar's diagnostics can contain source bytes. Expose a fixed error, keeping credentials out of reports.
+        throw new XmlDocumentError('malformed-document');
+    }
+}

package/generated/pack-facts.json

@@ -221,6 +221,50 @@
       },
       "serveExport": "createAxiomTwinServer"
     },
+    "bitly": {
+      "adoption": {
+        "sdks": [],
+        "envStems": [
+          "BITLY",
+          "BUFFER_BITLY"
+        ]
+      },
+      "hosts": [
+        {
+          "host": "api-ssl.bitly.com"
+        },
+        {
+          "host": "bitly.com",
+          "pathPattern": "^/oauth/authorize/?$"
+        }
+      ],
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "rest",
+      "resources": [
+        "group",
+        "bitlink"
+      ],
+      "endpointEnvNone": "Dub uses literal vendor URLs and native fetch; the World routes them by host.",
+      "credentialDoor": {
+        "path": "/_twin/signup",
+        "body": {
+          "email": "publisher@example.test",
+          "password": "throwaway-bitly-password",
+          "login": "publisher"
+        },
+        "fill": {
+          "BITLY_CLIENT_ID": "client_id",
+          "BITLY_CLIENT_SECRET": "client_secret",
+          "BUFFER_BITLY_API_KEY": "access_token"
+        }
+      },
+      "serveExport": "createBitlyTwinServer"
+    },
     "cerebras": {
       "adoption": {
         "sdks": [
@@ -331,6 +375,65 @@
       },
       "serveExport": "createClerkTwinServer"
     },
+    "clickhouse": {
+      "adoption": {
+        "sdks": [
+          "@clickhouse/client",
+          "@clickhouse/client-web"
+        ],
+        "pypi": [
+          "clickhouse-driver",
+          "clickhouse-connect",
+          "infi-clickhouse-orm"
+        ],
+        "envStems": [
+          "CLICKHOUSE"
+        ]
+      },
+      "hostsNone": "Self-hosted database: its own declared host and allocated listener are supplied by managed infrastructure.",
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "rest",
+      "resources": [
+        "database",
+        "table",
+        "row"
+      ],
+      "endpointEnv": {
+        "name": "CLICKHOUSE_URL",
+        "note": "HTTP base URL read by the documented JavaScript client."
+      },
+      "managedService": {
+        "kind": "clickhouse",
+        "scheme": "http",
+        "configurationArg": "--configuration",
+        "originalInputs": {
+          "version": 1,
+          "manifestArg": "--original-inputs",
+          "rootArg": "--original-root",
+          "digestArg": "--original-inputs-sha256",
+          "paths": [
+            "/etc/clickhouse-server",
+            "/docker-entrypoint-initdb.d",
+            "/entrypoint.sh"
+          ]
+        },
+        "note": "One HTTP8123/native9000 process and store; declared operator configuration is installed before listeners."
+      },
+      "sidePorts": [
+        {
+          "name": "native",
+          "option": "nativePort",
+          "flag": "--native-port",
+          "note": "ClickHouse native TCP protocol, normally9000, beside HTTP8123."
+        }
+      ],
+      "serveExport": "createClickhouseTwinServer"
+    },
     "cloudflare": {
       "adoption": {
         "pypi": [
@@ -538,7 +641,7 @@
       },
       "transport": "rest",
       "resources": [],
-      "endpointEnvNone": "Postiz calls https://api.deepgram.com/v1/listen; the World claims the host",
+      "endpointEnvNone": "No scanned application calls Deepgram; the World claims api.deepgram.com",
       "serveExport": "createDeepgramTwinServer"
     },
     "discord": {
@@ -786,7 +889,7 @@
       },
       "transport": "rest",
       "resources": [],
-      "endpointEnvNone": "Postiz calls https://fal.run/fal-ai/<model>; the World claims the hosts",
+      "endpointEnvNone": "the customer life calls https://fal.run/fal-ai/<model>; the World claims the hosts",
       "credentialDoor": {
         "path": "/_twin/app-credentials",
         "body": {},
@@ -956,7 +1059,7 @@
         },
         {
           "host": "github.com",
-          "pathPattern": "^/login|^/session|^/settings/|^/organizations/|^/apps/|^/[^/]+/[^/]+/(?:info/refs|git-upload-pack|git-receive-pack)$|^/[^/]+/[^/]+\\.git/"
+          "pathPattern": "^/login|^/session|^/settings/|^/organizations/|^/apps/|^/[^/]+/[^/]+/(?:info/refs|git-upload-pack|git-receive-pack)$|^/[^/]+/[^/]+\\.git/|^/[^/]+/[^/]+/?$|^/[^/]+/[^/]+/(?:issues|pulls?|blob|raw|tree|commits?|compare)(?:/|$)"
         }
       ],
       "archetype": "crud",
@@ -1014,6 +1117,55 @@
       "endpointEnvNone": "Google generated clients take rootUrl in code; the World routes the declared Calendar API paths.",
       "serveExport": "createGooglecalendarTwinServer"
     },
+    "googlefonts": {
+      "adoption": {
+        "sdks": [],
+        "envStems": [
+          "GOOGLE_FONTS"
+        ]
+      },
+      "hosts": [
+        {
+          "host": "www.googleapis.com",
+          "pathPattern": "^/webfonts/v1/webfonts$"
+        },
+        {
+          "host": "webfonts.googleapis.com",
+          "pathPattern": "^/v1/webfonts$"
+        },
+        {
+          "host": "fonts.googleapis.com",
+          "pathPattern": "^/css2?$"
+        },
+        {
+          "host": "fonts.gstatic.com",
+          "pathPattern": "^/(s/|l/font$)"
+        }
+      ],
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "rest",
+      "resources": [
+        "webfont",
+        "_api_key",
+        "_font_catalog",
+        "_stylesheet",
+        "_font_file"
+      ],
+      "endpointEnvNone": "Pinned helper hardcodes the vendor API and CSS hosts, then downloads their returned gstatic URLs. Scoped host routing preserves these URLs.",
+      "credentialDoor": {
+        "path": "/_twin/app-credentials",
+        "body": {},
+        "fill": {
+          "GOOGLE_FONTS_API_KEY": "api_key"
+        }
+      },
+      "serveExport": "createGooglefontsTwinServer"
+    },
     "googleoauth": {
       "adoption": {
         "sdks": [
@@ -1516,6 +1668,38 @@
       },
       "serveExport": "createMistralTwinServer"
     },
+    "mongodb": {
+      "adoption": {
+        "sdks": [
+          "mongodb",
+          "mongoose"
+        ],
+        "envStems": [
+          "MONGODB",
+          "MONGO"
+        ]
+      },
+      "hosts": [],
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "raw-tcp",
+      "resources": [
+        "collection",
+        "index",
+        "document"
+      ],
+      "endpointEnvNone": "Managed infrastructure injects the connection address from the declared mongodb service; it is a TCP endpoint, with no HTTP API host.",
+      "managedService": {
+        "kind": "mongodb",
+        "scheme": "mongodb",
+        "note": "MongoDB 7.0 wire: standalone, or a declared single-member handshake without sessions; state in the World tree"
+      },
+      "serveExport": "createMongodbTwinServer"
+    },
     "npm-registry": {
       "adoption": {
         "envStems": [
@@ -1910,6 +2094,10 @@
           "host": "reddit.com",
           "demandPathPattern": "^/api/"
         },
+        {
+          "host": "old.reddit.com",
+          "demandPathPattern": "^/api/"
+        },
         {
           "host": "reddit-uploaded-media.s3-accelerate.amazonaws.com"
         },
@@ -2566,7 +2754,7 @@
         "publish",
         "video"
       ],
-      "endpointEnvNone": "Postiz calls open.tiktokapis.com and sends people to www.tiktok.com; the World claims the hosts",
+      "endpointEnvNone": "an app calls open.tiktokapis.com and sends people to www.tiktok.com; the World claims the hosts",
       "credentialDoor": {
         "path": "/_twin/app-credentials",
         "body": {},
@@ -3149,6 +3337,18 @@
         "_code_challenge",
         "upload"
       ],
+      "credentialDoor": {
+        "path": "/_twin/app-credentials",
+        "body": {},
+        "fill": {
+          "TWITTER_API_KEY": "consumer_key",
+          "TWITTER_API_SECRET": "consumer_secret",
+          "TWITTER_ACCESS_TOKEN": "access_token",
+          "TWITTER_ACCESS_SECRET": "access_token_secret",
+          "TWITTER_CLIENT_ID": "client_id",
+          "TWITTER_CLIENT_SECRET": "client_secret"
+        }
+      },
       "serveExport": "createXTwinServer"
     },
     "xai": {