t44 0.4.0-rc.10

package/structs/providers/bunny.net/StorageZoneListFact.ts

@@ -0,0 +1,55 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the storage zone list fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the storage zone list fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#t44/caps/OpenApiSchema': {
+                as: 'schemaOpenApi',
+                options: {
+                    '#': {
+                        url: 'https://core-api-public-docs.b-cdn.net/docs/v3/public.json',
+                        def: '#/components/schemas/StorageZoneModel'
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/bunny.net/StorageZoneListFact'

package/structs/providers/bunny.net/WorkspaceConnectionConfig.ts

@@ -0,0 +1,43 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                apiKey: {
+                                    type: 'string',
+                                    title: 'Bunny.net API Key',
+                                    description: 'Your Bunny.net API key from https://dash.bunny.net/account/settings',
+                                    minLength: 30,
+                                    pattern: '^[a-f0-9-]+$'
+                                }
+                            },
+                            required: ['apiKey']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceConnection',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/bunny.net/WorkspaceConnectionConfig'

package/structs/providers/dynadot.com/DomainFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the domain fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the domain fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/dynadot.com/DomainFact'

package/structs/providers/dynadot.com/WorkspaceConnectionConfig.ts

@@ -0,0 +1,54 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                apiKey: {
+                                    type: 'string',
+                                    title: 'Dynadot API Key',
+                                    description: 'Your Dynadot API key. Generate at https://www.dynadot.com/account/domain/setting/api.html',
+                                    minLength: 10
+                                },
+                                apiSecret: {
+                                    type: 'string',
+                                    title: 'Dynadot API Secret',
+                                    description: 'Your Dynadot API secret for REST API HMAC-SHA256 signing.',
+                                    minLength: 10
+                                },
+                                apiKeyTransactionSecret: {
+                                    type: 'string',
+                                    title: 'Dynadot API Key Transaction Secret',
+                                    description: 'Your Dynadot API key transaction secret (optional, for transactional endpoints).',
+                                    minLength: 10
+                                }
+                            },
+                            required: ['apiKey', 'apiSecret']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceConnection',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/dynadot.com/WorkspaceConnectionConfig'

package/structs/providers/git-scm.com/ProjectPublishingFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/git-scm.com/ProjectPublishingFact'

package/structs/providers/github.com/ProjectPublishingFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/github.com/ProjectPublishingFact'

package/structs/providers/github.com/WorkspaceConnectionConfig.ts

@@ -0,0 +1,43 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                apiToken: {
+                                    type: 'string',
+                                    title: 'GitHub Personal Access Token',
+                                    description: 'Your GitHub personal access token from https://github.com/settings/tokens (needs repo scope)',
+                                    minLength: 10,
+                                    pattern: '^(ghp_[A-Za-z0-9]+|github_pat_[A-Za-z0-9_]+)$'
+                                }
+                            },
+                            required: ['apiToken']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceConnection',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/github.com/WorkspaceConnectionConfig'

package/structs/providers/npmjs.com/ProjectPublishingFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/npmjs.com/ProjectPublishingFact'

package/structs/providers/vercel.com/ProjectDeploymentFact.ts

@@ -0,0 +1,55 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project deployment fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project deployment fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#t44/caps/OpenApiSchema': {
+                as: 'schemaOpenApi',
+                options: {
+                    '#': {
+                        url: 'https://openapi.vercel.sh/',
+                        def: '#/paths/~1v9~1projects~1{idOrName}/get/responses/200/content/application~1json/schema'
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/vercel.com/ProjectDeploymentFact'

package/structs/providers/vercel.com/WorkspaceConnectionConfig.ts

@@ -0,0 +1,49 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                apiToken: {
+                                    type: 'string',
+                                    title: 'Vercel API Token',
+                                    description: 'Your Vercel API token from https://vercel.com/account/tokens',
+                                    minLength: 20,
+                                    pattern: '^[A-Za-z0-9_-]+$'
+                                },
+                                team: {
+                                    type: 'string',
+                                    title: 'Default Team',
+                                    description: 'Your default Vercel team slug',
+                                    minLength: 1
+                                }
+                            },
+                            required: ['apiToken']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceConnection',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/vercel.com/WorkspaceConnectionConfig'

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+    "extends": "../../../tsconfig.paths.json",
+    "compilerOptions": {
+        "target": "es2021",
+        "module": "esnext",
+        "lib": [
+            "ES2021",
+            "DOM"
+        ],
+        "types": [
+            "bun",
+            "node"
+        ],
+        "moduleResolution": "bundler",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "allowSyntheticDefaultImports": true
+    },
+    "include": [
+        "**/*.ts"
+    ],
+    "exclude": [
+        "node_modules"
+    ]
+}

package/workspace-rt.ts

@@ -0,0 +1,134 @@
+#!/usr/bin/env bun
+/// <reference types="bun" />
+/// <reference types="node" />
+
+const startTime = Date.now()
+
+import { join, resolve } from 'path'
+import { access } from 'fs/promises'
+import chalk from 'chalk'
+import { CapsuleSpineFactory } from "@stream44.studio/encapsulate/spine-factories/CapsuleSpineFactory.v0"
+import { CapsuleSpineContract } from "@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0/Membrane.v0"
+import { TimingObserver } from "@stream44.studio/encapsulate/spine-factories/TimingObserver"
+
+async function findWorkspaceRoot(): Promise<string> {
+    let currentDir = resolve(process.cwd())
+
+    while (true) {
+        const workspaceConfigPath = join(currentDir, '.workspace', 'workspace.yaml')
+        try {
+            await access(workspaceConfigPath)
+            return currentDir
+        } catch {
+            // File doesn't exist, continue traversing
+        }
+
+        const parentDir = resolve(currentDir, '..')
+        if (parentDir === currentDir) {
+            throw new Error(
+                `Could not find workspace root. Please run this command from within a workspace directory ` +
+                `(a directory containing .workspace/workspace.yaml).`
+            )
+        }
+        currentDir = parentDir
+    }
+}
+
+export async function run(encapsulateHandler: any, runHandler: any, options?: { importMeta?: { dir: string } }) {
+
+    const timing = process.argv.includes('--trace') ? TimingObserver({ startTime }) : undefined
+
+    timing?.recordMajor('INIT SPINE')
+
+    const eventsByKey = new Map<string, any>()
+
+    const workspaceRootDir = await findWorkspaceRoot()
+
+    const { encapsulate, freeze, CapsulePropertyTypes, makeImportStack, hoistSnapshot } = await CapsuleSpineFactory({
+        spineFilesystemRoot: workspaceRootDir,
+        capsuleModuleProjectionRoot: (import.meta as any).dir,
+        enableCallerStackInference: true,
+        spineContracts: {
+            ['#' + CapsuleSpineContract['#']]: CapsuleSpineContract
+        },
+        timing,
+        onMembraneEvent: timing ? (event: any) => {
+            const instanceId = event.target?.spineContractCapsuleInstanceId
+            const eventIndex = event.eventIndex
+
+            // Store event by composite key (instance ID + event index)
+            const key = `${eventIndex}`
+            eventsByKey.set(key, event)
+
+            let capsuleRef = event.target?.capsuleSourceLineRef
+            let prop = event.target?.prop
+            let callerLocation = event.caller ? `${event.caller.filepath}:${event.caller.line}` : 'unknown'
+            const eventType = event.event
+
+            // For call-result events, look up the original call event to get all info
+            if (eventType === 'call-result') {
+                const callKey = `${event.callEventIndex}`
+                const callEvent = eventsByKey.get(callKey)
+                if (callEvent) {
+                    capsuleRef = callEvent.target?.capsuleSourceLineRef || capsuleRef
+                    prop = callEvent.target?.prop || prop
+                    if (callEvent.caller) {
+                        callerLocation = `${callEvent.caller.filepath}:${callEvent.caller.line}`
+                    }
+                }
+            }
+
+            console.error(
+                chalk.gray(`[${eventIndex}]`),
+                chalk.cyan(eventType.padEnd(12)),
+                chalk.yellow(capsuleRef),
+                chalk.magenta(`.${prop}`),
+                chalk.dim(`from ${callerLocation}`)
+            )
+        } : undefined
+    })
+
+    timing?.recordMajor('ENCAPSULATE')
+
+    const exportedApi = await encapsulateHandler({
+        encapsulate,
+        CapsulePropertyTypes,
+        makeImportStack
+    })
+
+    timing?.recordMajor('FREEZE')
+
+    const snapshot = await freeze()
+
+    timing?.recordMajor('HOIST SNAPSHOT')
+
+    const { run } = await hoistSnapshot({
+        snapshot
+    })
+
+    timing?.recordMajor('RUN')
+
+    const result = await run({
+        overrides: {
+            ['t44/caps/WorkspaceConfig']: {
+                '#': {
+                    workspaceRootDir
+                }
+            },
+            ['t44/caps/WorkspaceTest']: {
+                '#': {
+                    testRootDir: options?.importMeta?.dir
+                }
+            }
+        }
+    }, async (opts) => {
+        return runHandler({
+            ...opts,
+            ...(exportedApi || {})
+        })
+    })
+
+    timing?.recordMajor('DONE')
+
+    return result
+}

package/workspace.yaml

@@ -0,0 +1,3 @@
+$schema: ../../../../../../.~o/workspace.foundation/@t44.sh~t44~caps~JsonSchemas/@t44.sh~t44~structs~WorkspaceConfigFile.json
+extends:
+  - ./caps/WorkspaceConfig.yaml