@latchway/react-native 0.0.0-bootstrap.0 → 1.1.0

package/lib/coordinator.js

@@ -0,0 +1,167 @@
+import { LatchwayError } from "@latchway/client";
+import { fromNativeError, nativeUnavailable } from "./errors.js";
+import { assertNoCredentialFields } from "./native-output.js";
+import { nativeModule } from "./native/bridge.js";
+import { CONTRACT_VERSION, PROTOCOL_VERSION, SDK_VERSION } from "./version.js";
+const entries = new Map();
+const componentEntries = new Map();
+const moduleIDs = new WeakMap();
+let nextModuleID = 1;
+let nextClientID = 1;
+export async function acquire(config) {
+    let module;
+    try {
+        module = await nativeModule();
+    }
+    catch (cause) {
+        throw nativeUnavailable(cause);
+    }
+    const moduleID = identityFor(module);
+    const key = `${moduleID}|${config.scope}`;
+    const existing = entries.get(key);
+    if (existing !== undefined) {
+        if (existing.fingerprint !== config.fingerprint) {
+            throw new LatchwayError("client_configuration_invalid", "Conflicting Latchway native configuration is active for this application scope.");
+        }
+        existing.references += 1;
+        return lease(entries, key, existing);
+    }
+    const clientID = `latchway-rn-${nextClientID++}`;
+    const entry = {
+        clientID,
+        fingerprint: config.fingerprint,
+        module,
+        references: 1,
+        ready: Promise.resolve({
+            platform: "react_native_ios",
+            nativeSDKVersion: "",
+            contractVersion: "",
+            protocolVersion: 0,
+        }),
+    };
+    entry.ready = module.configure(clientID, config.nativeJSON)
+        .then(parseCompatibility)
+        .catch(async (cause) => {
+        if (entries.get(key) === entry)
+            entries.delete(key);
+        // configure may have created native state before compatibility parsing
+        // failed. Disposal is idempotent on both bridges and its failure must not
+        // hide the original configuration error.
+        try {
+            await module.dispose(clientID);
+        }
+        catch { /* preserve the original failure */ }
+        throw fromNativeError(cause);
+    });
+    entries.set(key, entry);
+    return lease(entries, key, entry);
+}
+export async function acquireComponent(config) {
+    let module;
+    try {
+        module = await nativeModule();
+    }
+    catch (cause) {
+        throw nativeUnavailable(cause);
+    }
+    const moduleID = identityFor(module);
+    const key = `${moduleID}|component|${config.scope}`;
+    const existing = componentEntries.get(key);
+    if (existing !== undefined) {
+        if (existing.fingerprint !== config.fingerprint) {
+            throw new LatchwayError("client_configuration_invalid", "Conflicting Latchway component configuration is active for this extension scope.");
+        }
+        existing.references += 1;
+        return lease(componentEntries, key, existing);
+    }
+    const clientID = `latchway-rn-component-${nextClientID++}`;
+    const entry = {
+        clientID,
+        fingerprint: config.fingerprint,
+        module,
+        references: 1,
+        ready: emptyCompatibility(),
+    };
+    entry.ready = module.configureComponent(clientID, config.nativeJSON, config.componentJSON)
+        .then(parseCompatibility)
+        .catch(async (cause) => {
+        if (componentEntries.get(key) === entry)
+            componentEntries.delete(key);
+        try {
+            await module.dispose(clientID);
+        }
+        catch { /* preserve the original failure */ }
+        throw fromNativeError(cause);
+    });
+    componentEntries.set(key, entry);
+    return lease(componentEntries, key, entry);
+}
+function lease(owner, key, entry) {
+    let released = false;
+    return {
+        clientID: entry.clientID,
+        module: entry.module,
+        ready: entry.ready,
+        async release() {
+            if (released)
+                return;
+            released = true;
+            entry.references -= 1;
+            if (entry.references !== 0 || owner.get(key) !== entry)
+                return;
+            owner.delete(key);
+            try {
+                await entry.ready;
+                await entry.module.dispose(entry.clientID);
+            }
+            catch (cause) {
+                throw fromNativeError(cause);
+            }
+        },
+    };
+}
+function emptyCompatibility() {
+    return Promise.resolve({
+        platform: "react_native_ios",
+        nativeSDKVersion: "",
+        contractVersion: "",
+        protocolVersion: 0,
+    });
+}
+function parseCompatibility(encoded) {
+    const value = parseRecord(encoded, "native compatibility");
+    assertNoCredentialFields(value);
+    if (!hasOnlyKeys(value, ["platform", "nativeSDKVersion", "contractVersion", "protocolVersion"]) ||
+        (value.platform !== "react_native_ios" && value.platform !== "react_native_android") ||
+        typeof value.nativeSDKVersion !== "string" || value.nativeSDKVersion.length === 0 ||
+        value.nativeSDKVersion.length > 128 || /\p{Cc}/u.test(value.nativeSDKVersion) ||
+        value.contractVersion !== CONTRACT_VERSION || value.protocolVersion !== PROTOCOL_VERSION) {
+        throw new LatchwayError("protocol_response_invalid", `The native Latchway SDK is incompatible with JavaScript SDK ${SDK_VERSION}.`);
+    }
+    return value;
+}
+function hasOnlyKeys(value, names) {
+    const expected = new Set(names);
+    return Object.keys(value).every((name) => expected.has(name));
+}
+function parseRecord(encoded, label) {
+    try {
+        const value = JSON.parse(encoded);
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            return value;
+        }
+    }
+    catch {
+        // Report only a stable protocol error; native output may contain sensitive detail.
+    }
+    throw new LatchwayError("protocol_response_invalid", `Latchway returned invalid ${label}.`);
+}
+function identityFor(module) {
+    const existing = moduleIDs.get(module);
+    if (existing !== undefined)
+        return existing;
+    const value = nextModuleID++;
+    moduleIDs.set(module, value);
+    return value;
+}
+//# sourceMappingURL=coordinator.js.map

package/lib/coordinator.js.map

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

package/lib/errors.d.ts

@@ -0,0 +1,5 @@
+import { LatchwayError } from "@latchway/client";
+export declare function fromNativeError(value: unknown): Error;
+export declare function nativeUnavailable(cause: unknown): LatchwayError;
+export declare function abortError(): Error;
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA4FjD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAiErD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAM/D;AAED,wBAAgB,UAAU,IAAI,KAAK,CAKlC"}

package/lib/errors.js

@@ -0,0 +1,201 @@
+import { LatchwayError } from "@latchway/client";
+import { isCanonicalRequestID } from "./request-id.js";
+import { assertNoCredentialFields } from "./native-output.js";
+const knownCodeMap = {
+    request_invalid: true,
+    identity_token_missing: true,
+    identity_token_invalid: true,
+    identity_token_expired: true,
+    identity_reauthentication_required: true,
+    attestation_required: true,
+    attestation_unsupported: true,
+    attestation_invalid: true,
+    attestation_stale: true,
+    attestation_step_up_required: true,
+    dpop_missing: true,
+    dpop_invalid: true,
+    dpop_replayed: true,
+    dpop_nonce_required: true,
+    session_expired: true,
+    session_revoked: true,
+    refresh_token_reused: true,
+    installation_revoked: true,
+    installation_family_revoked: true,
+    installation_family_not_found: true,
+    component_definition_not_found: true,
+    component_not_configured: true,
+    component_not_provisioned: true,
+    component_revoked: true,
+    component_key_invalid: true,
+    component_key_replaced: true,
+    component_delegation_expired: true,
+    component_feature_not_granted: true,
+    component_parent_trust_expired: true,
+    component_direct_attestation_required: true,
+    containing_app_setup_required: true,
+    framework_integration_unsupported: true,
+    framework_version_unsupported: true,
+    transport_destination_not_allowed: true,
+    transport_request_not_replayable: true,
+    feature_not_found: true,
+    feature_not_allowed: true,
+    model_not_allowed: true,
+    quota_exceeded: true,
+    concurrency_exceeded: true,
+    output_limit_exceeded: true,
+    pricing_unavailable: true,
+    route_not_found: true,
+    upstream_unavailable: true,
+    upstream_timeout: true,
+    upstream_protocol_error: true,
+    configuration_invalid: true,
+    server_not_ready: true,
+    protocol_version_unsupported: true,
+    authentication_required: true,
+    permission_denied: true,
+    resource_not_found: true,
+    conflict: true,
+    etag_required: true,
+    etag_mismatch: true,
+    bootstrap_disabled: true,
+    rate_limited: true,
+    operation_indeterminate: true,
+    internal_error: true,
+    client_configuration_invalid: true,
+    storage_unavailable: true,
+    crypto_unavailable: true,
+    attestation_provider_missing: true,
+    protocol_response_invalid: true,
+    request_not_replayable: true,
+    network_error: true,
+};
+const knownCodes = new Set(Object.keys(knownCodeMap));
+const localCodeMap = {
+    cancelled: "network_error",
+    invalid_configuration: "client_configuration_invalid",
+    invalid_request: "request_invalid",
+    key_unavailable: "crypto_unavailable",
+    secure_enclave_unavailable: "crypto_unavailable",
+    secure_state_unavailable: "storage_unavailable",
+    key_storage_failure: "storage_unavailable",
+    response_invalid: "protocol_response_invalid",
+    invalid_server_response: "protocol_response_invalid",
+    network_unavailable: "network_error",
+    transport_failure: "network_error",
+    session_unavailable: "session_expired",
+    attestation_unavailable: "attestation_unsupported",
+};
+export function fromNativeError(value) {
+    try {
+        assertNoCredentialFields(value);
+    }
+    catch (cause) {
+        return cause instanceof LatchwayError
+            ? cause
+            : new LatchwayError("protocol_response_invalid", "Latchway returned unsafe native error metadata.");
+    }
+    if (isAbortError(value))
+        return abortError();
+    const record = isRecord(value) ? value : {};
+    const userInfo = isRecord(record.userInfo) ? record.userInfo : {};
+    const rawCode = firstString(record.code, userInfo.code);
+    const mapped = rawCode === undefined
+        ? "internal_error"
+        : localCodeMap[rawCode] ?? (knownCodes.has(rawCode)
+            ? rawCode
+            : "internal_error");
+    const codeValues = presentValues(record, userInfo, ["code"]);
+    const requestIDValues = presentValues(record, userInfo, ["requestID", "request_id"]);
+    const requestIDCandidate = firstString(record.requestID, record.request_id, userInfo.requestID, userInfo.request_id);
+    const requestID = isCanonicalRequestID(requestIDCandidate) ? requestIDCandidate : undefined;
+    const statusValues = presentValues(record, userInfo, ["status"]);
+    const status = safeStatus(record.status ?? userInfo.status);
+    const retryableValues = presentValues(record, userInfo, ["retryable"]);
+    const retryable = record.retryable === true || userInfo.retryable === true;
+    const documentationURLValues = presentValues(record, userInfo, ["documentationURL", "documentation_url"]);
+    const canonicalNativeDocumentationURL = rawCode !== undefined && isNativeErrorCode(rawCode)
+        ? `https://docs.latchway.dev/errors/${rawCode.replaceAll("_", "-")}`
+        : undefined;
+    const documentationURLIsValid = documentationURLValues.length > 0 &&
+        canonicalNativeDocumentationURL !== undefined &&
+        documentationURLValues.every((candidate) => candidate === canonicalNativeDocumentationURL);
+    const operationValues = presentValues(record, userInfo, ["operationID", "operation_id"]);
+    const operationID = operationValues.length > 0 &&
+        operationValues.every((candidate) => candidate === operationValues[0]) &&
+        isCanonicalOperationID(operationValues[0])
+        ? operationValues[0]
+        : undefined;
+    const validIndeterminateMetadata = operationID !== undefined && requestID !== undefined &&
+        status === 503 && retryable && codeValues.length > 0 &&
+        codeValues.every((candidate) => candidate === "operation_indeterminate") &&
+        requestIDValues.length > 0 && requestIDValues.every((candidate) => candidate === requestID) &&
+        statusValues.length > 0 && statusValues.every((candidate) => candidate === 503) &&
+        retryableValues.length > 0 && retryableValues.every((candidate) => candidate === true);
+    const hasServerMetadata = requestIDValues.length > 0 || statusValues.length > 0;
+    if ((documentationURLValues.length > 0 && !documentationURLIsValid) ||
+        (hasServerMetadata && !documentationURLIsValid) ||
+        (mapped === "operation_indeterminate" && !validIndeterminateMetadata) ||
+        (mapped !== "operation_indeterminate" && operationValues.length > 0)) {
+        return new LatchwayError("protocol_response_invalid", "Latchway returned invalid native error metadata.", { requestID, status });
+    }
+    return new LatchwayError(mapped, safeMessage(firstString(record.message, userInfo.message)), {
+        requestID,
+        status,
+        retryable,
+        operationID,
+    });
+}
+export function nativeUnavailable(cause) {
+    return new LatchwayError("client_configuration_invalid", "The Latchway native module is unavailable. Rebuild the application after installing the SDK.", { cause });
+}
+export function abortError() {
+    if (typeof DOMException === "function")
+        return new DOMException("The operation was aborted.", "AbortError");
+    const error = new Error("The operation was aborted.");
+    error.name = "AbortError";
+    return error;
+}
+function isAbortError(value) {
+    if (!isRecord(value))
+        return false;
+    const code = firstString(value.code, value.name);
+    return code === "cancelled" || code === "E_ABORTED" || code === "AbortError";
+}
+function safeMessage(value) {
+    if (value === undefined || value.length === 0)
+        return "The Latchway native operation failed.";
+    const bounded = value.replace(/\p{Cc}/gu, " ").slice(0, 512);
+    if (/eyJ|lwa_|lws_|refresh.?token|identity.?token|integrity.?token|[A-Za-z0-9_-]{64,}/iu.test(bounded)) {
+        return "Sensitive native error detail was redacted.";
+    }
+    return bounded;
+}
+function safeStatus(value) {
+    return Number.isInteger(value) && value >= 100 && value <= 599
+        ? value
+        : undefined;
+}
+function firstString(...values) {
+    return values.find((value) => typeof value === "string");
+}
+function presentValues(record, userInfo, keys) {
+    const values = [];
+    for (const source of [record, userInfo]) {
+        for (const key of keys) {
+            const candidate = source[key];
+            if (Object.hasOwn(source, key) && candidate !== undefined && candidate !== null)
+                values.push(candidate);
+        }
+    }
+    return values;
+}
+function isCanonicalOperationID(value) {
+    return typeof value === "string" && /^arq_[0-7][0-9A-HJKMNPQRSTVWXYZ]{25}$/u.test(value);
+}
+function isNativeErrorCode(value) {
+    return /^[a-z][a-z0-9_]{0,62}$/u.test(value);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+import type { LatchwayClient, LatchwayComponentClient, LatchwayComponentOptions, LatchwayOptions } from "./types.js";
+export { errorFromResponse, LatchwayError } from "@latchway/client";
+export { CONTRACT_VERSION, PROTOCOL_VERSION, SDK_KIND, SDK_VERSION, SUPPORTED_PROTOCOL_VERSIONS, } from "./version.js";
+export type { AndroidKeyPolicy, AndroidSecurityOptions, AppleSecurityOptions, AppleSoftwareKeyFallbackPolicy, FetchImplementation, GetIdentityToken, IdentityTokenProvider, LatchwayClient, LatchwayComponentClient, LatchwayComponentOptions, LatchwayFetchInit, LatchwayFetch, LatchwayOptions, QuotaLimit, QuotaSnapshot, ReactNativeComponentDiagnostics, ReactNativeComponentAppleOptions, ReactNativeComponentTrustSource, ReactNativeDiagnostics, ReactNativeIOSComponent, ReactNativeIOSComponentKind, ReactNativeDirectAttestationComponent, ReactNativeDirectAttestationComponentKind, ReactNativePlatform, } from "./types.js";
+export declare function createLatchwayClient(options: LatchwayOptions): LatchwayClient;
+/** Creates a client only for JavaScript executing inside the signed iOS extension bundle. */
+export declare function createLatchwayComponentClient(options: LatchwayComponentOptions): LatchwayComponentClient;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,8BAA8B,EAC9B,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,+BAA+B,EAC/B,gCAAgC,EAChC,+BAA+B,EAC/B,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,qCAAqC,EACrC,yCAAyC,EACzC,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAE7E;AAED,6FAA6F;AAC7F,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAExG"}

package/lib/index.js

@@ -0,0 +1,13 @@
+import { DefaultLatchwayClient } from "./client.js";
+import { DefaultLatchwayComponentClient } from "./component-client.js";
+import { configure, configureComponent } from "./config.js";
+export { errorFromResponse, LatchwayError } from "@latchway/client";
+export { CONTRACT_VERSION, PROTOCOL_VERSION, SDK_KIND, SDK_VERSION, SUPPORTED_PROTOCOL_VERSIONS, } from "./version.js";
+export function createLatchwayClient(options) {
+    return new DefaultLatchwayClient(configure(options));
+}
+/** Creates a client only for JavaScript executing inside the signed iOS extension bundle. */
+export function createLatchwayComponentClient(options) {
+    return new DefaultLatchwayComponentClient(configureComponent(options));
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQ5D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AA4BtB,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,OAAO,IAAI,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,6BAA6B,CAAC,OAAiC;IAC7E,OAAO,IAAI,8BAA8B,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/lib/native/NativeLatchway.d.ts

@@ -0,0 +1,25 @@
+import type { TurboModule } from "react-native";
+export interface Spec extends TurboModule {
+    configure(clientID: string, configurationJSON: string): Promise<string>;
+    configureComponent(clientID: string, configurationJSON: string, componentJSON: string): Promise<string>;
+    startRequest(clientID: string, operationID: string, identityToken: string, requestJSON: string): Promise<string>;
+    readResponseChunk(clientID: string, operationID: string, responseID: string, maximumBytes: number): Promise<string>;
+    closeResponse(clientID: string, responseID: string): Promise<void>;
+    refresh(clientID: string, operationID: string, identityToken: string): Promise<void>;
+    quota(clientID: string, operationID: string, identityToken: string, feature: string): Promise<string>;
+    diagnostics(clientID: string, operationID: string, identityToken: string): Promise<string>;
+    establishDirectAttestation(clientID: string, operationID: string): Promise<void>;
+    componentDiagnostics(clientID: string, operationID: string): Promise<string>;
+    prepareComponents(clientID: string, operationID: string, identityToken: string, componentsJSON: string): Promise<string>;
+    replaceComponent(clientID: string, operationID: string, identityToken: string, componentJSON: string): Promise<string>;
+    rootComponentDiagnostics(clientID: string, operationID: string, componentJSON: string): Promise<string>;
+    revokeComponent(clientID: string, operationID: string, identityToken: string, componentJSON: string): Promise<void>;
+    revoke(clientID: string, operationID: string, identityToken: string): Promise<void>;
+    revokeFamily(clientID: string, operationID: string, identityToken: string): Promise<void>;
+    revokeFamilyWithComponents(clientID: string, operationID: string, identityToken: string, componentsJSON: string): Promise<void>;
+    cancel(clientID: string, operationID: string): void;
+    dispose(clientID: string): Promise<void>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeLatchway.d.ts.map

package/lib/native/NativeLatchway.d.ts.map

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

package/lib/native/NativeLatchway.js

@@ -0,0 +1,3 @@
+import { TurboModuleRegistry } from "react-native";
+export default TurboModuleRegistry.getEnforcing("NativeLatchway");
+//# sourceMappingURL=NativeLatchway.js.map

package/lib/native/NativeLatchway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeLatchway.js","sourceRoot":"","sources":["../../src/native/NativeLatchway.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAyEnD,eAAe,mBAAmB,CAAC,YAAY,CAAO,gBAAgB,CAAC,CAAC"}

package/lib/native/bridge.d.ts

@@ -0,0 +1,5 @@
+import type { Spec } from "./NativeLatchway.js";
+export type NativeLatchwayModule = Spec;
+export declare function nativeModule(): Promise<NativeLatchwayModule>;
+export declare function setTestingNativeModule(module: NativeLatchwayModule | undefined): void;
+//# sourceMappingURL=bridge.d.ts.map

package/lib/native/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/native/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAIxC,wBAAsB,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAYlE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,CAErF"}

package/lib/native/bridge.js

@@ -0,0 +1,17 @@
+let testingModule;
+export async function nativeModule() {
+    if (testingModule !== undefined)
+        return testingModule;
+    try {
+        return (await import("./NativeLatchway.js")).default;
+    }
+    catch (cause) {
+        const error = new Error("The Latchway TurboModule is unavailable. Rebuild the native application after installing @latchway/react-native.", { cause });
+        error.name = "LatchwayNativeModuleUnavailable";
+        throw error;
+    }
+}
+export function setTestingNativeModule(module) {
+    testingModule = module;
+}
+//# sourceMappingURL=bridge.js.map

package/lib/native/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/native/bridge.ts"],"names":[],"mappings":"AAIA,IAAI,aAA+C,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IACtD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,kHAAkH,EAClH,EAAE,KAAK,EAAE,CACV,CAAC;QACF,KAAK,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAwC;IAC7E,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC"}

package/lib/native-output.d.ts

@@ -0,0 +1,3 @@
+/** Fails closed when a native return or rejection envelope names credential material. */
+export declare function assertNoCredentialFields(value: unknown): void;
+//# sourceMappingURL=native-output.d.ts.map

package/lib/native-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-output.d.ts","sourceRoot":"","sources":["../src/native-output.ts"],"names":[],"mappings":"AAqBA,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAI7D"}

package/lib/native-output.js

@@ -0,0 +1,43 @@
+import { LatchwayError } from "@latchway/client";
+const forbiddenCredentialKeyFragments = [
+    "authorization",
+    "dpop",
+    "accesstoken",
+    "refreshtoken",
+    "privatekey",
+    "sessiontoken",
+    "identitytoken",
+    "integritytoken",
+    "attestationevidence",
+    "clientdatahash",
+    "requesthash",
+    "credential",
+    "secret",
+    "jwk",
+];
+const forbiddenExactCredentialKeys = new Set(["key", "proof", "token"]);
+/** Fails closed when a native return or rejection envelope names credential material. */
+export function assertNoCredentialFields(value) {
+    if (containsCredentialField(value)) {
+        throw new LatchwayError("protocol_response_invalid", "Latchway native output crossed the credential boundary.");
+    }
+}
+function containsCredentialField(value) {
+    if (Array.isArray(value))
+        return value.some(containsCredentialField);
+    if (!isRecord(value))
+        return false;
+    for (const [key, item] of Object.entries(value)) {
+        const compact = key.replace(/[^A-Za-z0-9]/gu, "").toLowerCase();
+        if (forbiddenExactCredentialKeys.has(compact) ||
+            forbiddenCredentialKeyFragments.some((fragment) => compact.includes(fragment)))
+            return true;
+        if (containsCredentialField(item))
+            return true;
+    }
+    return false;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=native-output.js.map

package/lib/native-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-output.js","sourceRoot":"","sources":["../src/native-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,+BAA+B,GAAG;IACtC,eAAe;IACf,MAAM;IACN,aAAa;IACb,cAAc;IACd,YAAY;IACZ,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,qBAAqB;IACrB,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,KAAK;CACG,CAAC;AAEX,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAExE,yFAAyF;AACzF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,aAAa,CAAC,2BAA2B,EAAE,yDAAyD,CAAC,CAAC;IAClH,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAChE,IAAI,4BAA4B,CAAC,GAAG,CAAC,OAAO,CAAC;YACzC,+BAA+B,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAChG,IAAI,uBAAuB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/lib/polyfills.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Explicit, opt-in React Native compatibility bootstrap. Import this before
+ * LangChain or any SDK/stream dependency. The ordinary SDK entry has no global
+ * initialization side effects. Native keys and attestation are never polyfilled.
+ */
+import "./runtime-symbols.js";
+import "react-native-get-random-values";
+//# sourceMappingURL=polyfills.d.ts.map

package/lib/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,sBAAsB,CAAC;AAC9B,OAAO,gCAAgC,CAAC"}

package/lib/polyfills.js

@@ -0,0 +1,56 @@
+/**
+ * Explicit, opt-in React Native compatibility bootstrap. Import this before
+ * LangChain or any SDK/stream dependency. The ordinary SDK entry has no global
+ * initialization side effects. Native keys and attestation are never polyfilled.
+ */
+import "./runtime-symbols.js";
+import "react-native-get-random-values";
+import { URL as CompatibleURL, URLSearchParams as CompatibleURLSearchParams } from "react-native-url-polyfill";
+import { ReadableStream, TransformStream, WritableStream } from "web-streams-polyfill";
+import { TextDecoder, TextEncoder } from "text-encoding";
+// React Native's built-in URL is present but incomplete. Replace it only when
+// this small capability check fails, retaining complete application polyfills.
+function hasWorkingURL() {
+    try {
+        const url = new globalThis.URL("child?q=hello%20world", "https://example.invalid/root/");
+        return url.href === "https://example.invalid/root/child?q=hello%20world" &&
+            url.searchParams.get("q") === "hello world" &&
+            new globalThis.URLSearchParams({ q: "hello world" }).get("q") === "hello world";
+    }
+    catch {
+        return false;
+    }
+}
+if (!hasWorkingURL())
+    Object.assign(globalThis, { URL: CompatibleURL, URLSearchParams: CompatibleURLSearchParams });
+if (typeof globalThis.TextEncoder === "undefined")
+    Object.assign(globalThis, { TextEncoder });
+if (typeof globalThis.TextDecoder === "undefined")
+    Object.assign(globalThis, { TextDecoder });
+if (typeof globalThis.ReadableStream === "undefined")
+    Object.assign(globalThis, { ReadableStream });
+if (typeof globalThis.TransformStream === "undefined")
+    Object.assign(globalThis, { TransformStream });
+if (typeof globalThis.WritableStream === "undefined")
+    Object.assign(globalThis, { WritableStream });
+if (typeof AbortSignal.prototype.throwIfAborted === "undefined") {
+    Object.defineProperty(AbortSignal.prototype, "throwIfAborted", {
+        configurable: true,
+        writable: true,
+        value() {
+            if (!this.aborted)
+                return;
+            if (this.reason !== undefined)
+                throw this.reason;
+            const error = new Error("The operation was aborted.");
+            error.name = "AbortError";
+            throw error;
+        },
+    });
+}
+// LangChain expects a string when navigator exists. This is runtime detection,
+// not caller-supplied trust or framework attribution in the native protocol.
+if (typeof navigator !== "undefined" && typeof navigator.userAgent !== "string") {
+    Object.defineProperty(navigator, "userAgent", { value: "ReactNative/0.82", configurable: true });
+}
+//# sourceMappingURL=polyfills.js.map