@hraness/ghostget 0.17.2

package/src/plugins/twitch-web/plugin.ts

@@ -0,0 +1,54 @@
+import {
+  defineProviderPlugin,
+  lazyWebSessionRuntime,
+} from "../../provider-plugin";
+import {
+  browserSessionAuthKinds,
+  webImplementationSources,
+  webSessionContractOperations,
+} from "../../provider-plugin-builtins";
+import { webSessionContractDefinitions } from "../../web-session-contract-definitions";
+
+const twitchContracts = webSessionContractDefinitions.twitch;
+if (twitchContracts === undefined) {
+  throw new Error("Twitch web-session contracts are not installed");
+}
+
+export const twitchWebPlugin = defineProviderPlugin({
+  apiVersion: 1,
+  id: "twitch-web",
+  version: "1.1.0",
+  displayName: "Twitch Authenticated Web",
+  sourceKind: "built-in",
+  implementationSources: webImplementationSources(import.meta.url, [
+    ["providers/read-failure.ts", "../../providers/read-failure.ts"],
+    ["providers/twitch-web.ts", "../../providers/twitch-web.ts"],
+    ["providers/twitch-web-runtime.ts", "../../providers/twitch-web-runtime.ts"],
+  ]),
+  bindings: [{
+    transport: "web-session-api",
+    surfaceId: "twitch",
+    origin: "https://gql.twitch.tv",
+    manifestOrigins: ["https://www.twitch.tv"],
+    protectedHostnameFamilies: ["twitch.tv"],
+    authKinds: browserSessionAuthKinds,
+    operations: webSessionContractOperations(
+      Object.values(twitchContracts),
+      "f82840e92d2512dd43f83adb00a6b7e5bdfa7384ee9b7e298454dac5408f7811",
+    ),
+    subject: {
+      format: "twitch:<viewer-id>",
+      matches: (value) => /^twitch:[1-9][0-9]{0,31}$/u.test(value),
+    },
+    runtime: lazyWebSessionRuntime(async () => {
+      const runtime = await import("../../providers/twitch-web-runtime");
+      return {
+        probe: runtime.probeTwitchWebSubject,
+        execute: (_manifest, recipe, input, auth, options) =>
+          runtime.executeTwitchWebOperation(recipe, input, auth, options),
+      };
+    }),
+  }],
+});
+
+export default twitchWebPlugin;

package/src/plugins/whatsapp-linked-device/plugin.ts

@@ -0,0 +1,105 @@
+import {
+  defineProviderPlugin,
+  lazyWebSessionRuntime,
+} from "../../provider-plugin";
+import {
+  linkedDeviceAuthKinds,
+  webSessionContractOperations,
+  webImplementationSources,
+} from "../../provider-plugin-builtins";
+import { webSessionContractDefinitions } from "../../web-session-contract-definitions";
+import {
+  materializeWhatsAppMessagingList,
+  materializeWhatsAppMessagingRead,
+} from "../../providers/whatsapp-omni";
+import { whatsappMessagingDefinition } from "../../providers/whatsapp-messaging";
+
+const whatsappContracts = webSessionContractDefinitions.whatsapp;
+if (whatsappContracts === undefined) {
+  throw new Error("WhatsApp linked-device contracts are not installed");
+}
+
+export const whatsappLinkedDevicePlugin = defineProviderPlugin({
+  apiVersion: 1,
+  id: "whatsapp-linked-device",
+  version: "1.2.0",
+  displayName: "WhatsApp Linked Device",
+  sourceKind: "built-in",
+  implementationSources: webImplementationSources(import.meta.url, [
+    ["kernel/auth.ts", "../../auth.ts"],
+    ["kernel/state-helper.bunfig.toml", "../../state-helper.bunfig.toml"],
+    ["kernel/storage.ts", "../../storage.ts"],
+    ["providers/contact-projection.ts", "../../providers/contact-projection.ts"],
+    ["providers/whatsapp-contact-projection-helper.ts", "../../providers/whatsapp-contact-projection-helper.ts"],
+    ["providers/whatsapp-contact-projection-protocol.ts", "../../providers/whatsapp-contact-projection-protocol.ts"],
+    ["providers/whatsapp-interaction-projection-helper.ts", "../../providers/whatsapp-interaction-projection-helper.ts"],
+    ["providers/whatsapp-interaction-projection-protocol.ts", "../../providers/whatsapp-interaction-projection-protocol.ts"],
+    ["providers/whatsapp-message-export-projection-protocol.ts", "../../providers/whatsapp-message-export-projection-protocol.ts"],
+    ["providers/whatsapp-web.ts", "../../providers/whatsapp-web.ts"],
+    ["providers/whatsapp-web-runtime.ts", "../../providers/whatsapp-web-runtime.ts"],
+    ["providers/whatsapp-omni.ts", "../../providers/whatsapp-omni.ts"],
+    ["providers/whatsapp-messaging.ts", "../../providers/whatsapp-messaging.ts"],
+    ["scripts/install-whatsapp-protocol.sh", "../../scripts/install-whatsapp-protocol.sh"],
+    ["scripts/resolve-state-home.ts", "../../scripts/resolve-state-home.ts"],
+  ]),
+  bindings: [{
+    transport: "linked-device",
+    surfaceId: "whatsapp",
+    origin: "https://web.whatsapp.com",
+    protectedHostnameFamilies: ["whatsapp.com"],
+    authKinds: linkedDeviceAuthKinds,
+    operations: webSessionContractOperations(
+      Object.values(whatsappContracts),
+      "a5c32c0b7c210fd98aee086455b2fde1151c7cf1806fd2e0f6c3e269d10ac13f",
+      { "contacts.list": [1] },
+      {
+        "messaging.list": {
+          state: "supported",
+          schemaVersion: 1,
+          materializerId: "whatsapp-messaging-list",
+          materializerVersion: 1,
+          materialize: materializeWhatsAppMessagingList,
+        },
+        "messaging.read": {
+          state: "supported",
+          schemaVersion: 1,
+          materializerId: "whatsapp-messaging-read",
+          materializerVersion: 1,
+          materialize: materializeWhatsAppMessagingRead,
+        },
+      },
+    ),
+    subject: {
+      format: "whatsapp:pn:<phone> or whatsapp:lid:<linked-id>",
+      matches: (value) => /^whatsapp:(?:pn:[0-9]{5,20}|lid:[0-9]{5,32})$/u.test(value),
+    },
+    messaging: whatsappMessagingDefinition,
+    linkedDeviceLifecycle: {
+      inspect: true,
+      pair: true,
+      syncOnce: true,
+    },
+    runtime: lazyWebSessionRuntime(async () => {
+      const runtime = await import("../../providers/whatsapp-web-runtime");
+      return {
+        probe: runtime.probeWhatsAppWebSubject,
+        execute: (_manifest, recipe, input, auth, options) =>
+          runtime.executeWhatsAppWebOperation(recipe, input, auth, options),
+        linkedDeviceLifecycle: {
+          inspect: runtime.inspectWhatsAppProtocolRuntime,
+          pair: (auth, options) => runtime.pairWhatsAppAuth(auth, options),
+          syncOnce: async (auth, options) => {
+            const result = await runtime.syncWhatsAppAuthOnce(auth, options);
+            return {
+              itemsStored: result.messagesStored,
+              projection: "local-store",
+              emitsProtocolAcknowledgements: true,
+            };
+          },
+        },
+      };
+    }),
+  }],
+});
+
+export default whatsappLinkedDevicePlugin;

package/src/plugins/x-official/plugin.ts

@@ -0,0 +1,64 @@
+import { xProviderContractDefinitions } from "../../provider-contract-definitions-x";
+import { xProviderConditionalInputIssues } from "../../provider-contract-input-x";
+import {
+  defineProviderPlugin,
+  lazyProviderApiRuntime,
+} from "../../provider-plugin";
+import {
+  oauthTokenAuthKinds,
+  officialContractOperations,
+  officialImplementationSources,
+} from "../../provider-plugin-builtins";
+
+const runtime = lazyProviderApiRuntime(async () => {
+  const { executeXProvider } = await import("../../providers/x");
+  return { execute: executeXProvider };
+});
+
+export const xOfficialPlugin = defineProviderPlugin({
+  apiVersion: 1,
+  id: "x-official",
+  version: "1.0.0",
+  displayName: "X Official API",
+  sourceKind: "built-in",
+  implementationSources: Object.freeze([
+    ...officialImplementationSources(import.meta.url, "x"),
+    Object.freeze({
+      label: "contracts/x-versioned.ts",
+      url: new URL("../../provider-contract-definitions-x.ts", import.meta.url),
+    }),
+  ]),
+  bindings: [{
+    transport: "provider-api",
+    surfaceId: "x",
+    origin: "https://api.x.com",
+    manifestOrigins: ["https://x.com"],
+    protectedHostnameFamilies: ["twitter.com", "x.com"],
+    authKinds: oauthTokenAuthKinds,
+    operations: officialContractOperations(
+      xProviderContractDefinitions,
+      {
+        semanticIdentity: "29653ed33e72d7c7770340a2299f126a27242743a98a6fcef8a886c3f2e3ebc2",
+        validateInput: (contract, input) =>
+          xProviderConditionalInputIssues(contract.operation, input),
+        omni: {
+          "messaging.list": {
+            state: "unsupported",
+            reason: "X official messaging output retains raw or encrypted nested provider data without a strict plaintext materializer",
+          },
+          "messaging.read": {
+            state: "unsupported",
+            reason: "X official message reads retain raw provider data without a strict provider-owned output materializer",
+          },
+        },
+      },
+    ),
+    subject: {
+      format: "1–19 digit X account ID",
+      matches: (value) => /^[0-9]{1,19}$/u.test(value),
+    },
+    runtime,
+  }],
+});
+
+export default xOfficialPlugin;