gemstack-cli 0.1.0

data/templates/resource/model/app/models/%file_name%.rb.tt

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class <%= class_name %> < GemStack::Model
+<% fields.each do |field| -%>
+  <%= model_field(field) %>
+<% end -%>
+<% fields.select(&:unique).each do |field| -%>
+
+  validates :<%= field.column %>, uniqueness: true
+<% end -%>
+<% spec.references.each do |field| -%>
+
+  belongs_to :<%= field.name %>
+<% end -%>
+end

data/templates/resource/model/test/models/%file_name%_test.rb.tt

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+class <%= class_name %>Test < GemStack::TestCase
+  def sample = GemStack::DB::Testing.sample_attributes(<%= class_name %>)
+
+  def test_valid_with_sample_attributes
+    <%= spec.variable %> = <%= class_name %>.new(sample)
+
+    assert_predicate <%= spec.variable %>, :valid?, <%= spec.variable %>.errors.to_h.inspect
+  end
+
+  def test_create
+    <%= spec.variable %> = <%= class_name %>.create(sample)
+
+    assert <%= spec.variable %>.id
+    assert <%= spec.variable %>.created_at
+  end
+<% fields.select(&:required?).each do |field| -%>
+
+  def test_requires_<%= field.column %>
+    <%= spec.variable %> = <%= class_name %>.new(sample.except(:<%= field.column %>))
+
+    refute_predicate <%= spec.variable %>, :valid?
+    assert_includes <%= spec.variable %>.errors[:<%= field.column %>], "is required"
+  end
+<% end -%>
+end

data/templates/resource/serializer/app/serializers/%file_name%_serializer.rb.tt

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# What the API returns for a <%= class_name %>. Only listed attributes are exposed;
+# their types (from <%= class_name %>'s fields) drive the generated TypeScript types.
+class <%= class_name %>Serializer < GemStack::Serializer
+  attributes :id, <%= fields.map { |f| ":#{f.column}" }.join(", ") %>, :created_at, :updated_at
+end

data/templates/storage/app/controllers/uploads_controller.rb.tt

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# POST /api/uploads — step 1 of a direct upload (frontend/lib/upload.ts):
+# validates the file's type and size and returns a short-lived URL the
+# browser PUTs the file to. Save the returned signed_id on your record:
+#
+#   product.update(image_key: GemStack::Storage.key_for_signed_id(input[:image]))
+#   GemStack::Storage.url(product.image_key)   # signed download URL
+#
+# Allowed types and the size limit: config.storage (docs/storage.md).
+class UploadsController < ApplicationController
+<% if auth? -%>
+  before :require_login
+<% else -%>
+  # Anyone can upload until you add authentication (gemstack add auth), then:
+  # before :require_login
+<% end -%>
+  rate_limit to: 60, within: 3600, only: :create if respond_to?(:rate_limit)
+
+  accepts :create do
+    required :filename, :string, max_length: 255
+    required :content_type, :string, max_length: 100
+    required :byte_size, :integer, gt: 0
+  end
+  returns :create, UploadSerializer
+
+  def create
+    upload = GemStack::Storage.direct_upload(**input.slice(:filename, :content_type, :byte_size))
+    result = UploadSerializer::Result.new(signed_id: upload[:signed_id], url: upload[:url],
+                                          http_method: upload[:method], headers: upload[:headers])
+    render result, status: :created, serializer: UploadSerializer
+  end
+end

data/templates/storage/app/serializers/upload_serializer.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Where and how the browser sends the file (see UploadsController).
+class UploadSerializer < GemStack::Serializer
+  Result = Data.define(:signed_id, :url, :http_method, :headers)
+
+  attribute :signed_id, :string
+  attribute :url, :string
+  attribute(:method, :string) { |upload| upload.http_method }
+  attribute :headers, :json
+end

data/templates/storage/frontend/lib/upload.ts

@@ -0,0 +1,52 @@
+"use client";
+
+// Direct uploads (generated by `gemstack add storage`): the file goes from the
+// browser straight to storage (S3, or the Ruby disk endpoint in development).
+//
+//   const { signedId } = await uploadFile(file, { onProgress: (p) => setProgress(p) });
+//   await products.update(id, { image: signedId });
+import { useMutation } from "@tanstack/react-query";
+import { uploads } from "@/lib/api/generated";
+
+export interface UploadResult {
+  /** Send this to the API to attach the file to a record. */
+  signedId: string;
+}
+
+export interface UploadOptions {
+  /** 0–1 while uploading. */
+  onProgress?: (fraction: number) => void;
+  signal?: AbortSignal;
+}
+
+export async function uploadFile(file: File, options: UploadOptions = {}): Promise<UploadResult> {
+  const upload = await uploads.create({
+    filename: file.name,
+    content_type: file.type || "application/octet-stream",
+    byte_size: file.size,
+  });
+  await send(upload.url, upload.method, upload.headers as Record<string, string>, file, options);
+  return { signedId: upload.signed_id };
+}
+
+// XMLHttpRequest rather than fetch: it reports upload progress.
+function send(url: string, method: string, headers: Record<string, string>, file: File, options: UploadOptions) {
+  return new Promise<void>((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open(method, url);
+    for (const [name, value] of Object.entries(headers)) xhr.setRequestHeader(name, value);
+    xhr.upload.onprogress = (event) => {
+      if (event.lengthComputable) options.onProgress?.(event.loaded / event.total);
+    };
+    xhr.onload = () => (xhr.status < 300 ? resolve() : reject(new Error(`Upload failed (HTTP ${xhr.status})`)));
+    xhr.onerror = () => reject(new Error("Upload failed: network error"));
+    xhr.onabort = () => reject(new DOMException("Upload aborted", "AbortError"));
+    options.signal?.addEventListener("abort", () => xhr.abort());
+    xhr.send(file);
+  });
+}
+
+/** uploadFile as a TanStack Query mutation: const upload = useUpload(); upload.mutateAsync(file). */
+export function useUpload(options: Omit<UploadOptions, "signal"> = {}) {
+  return useMutation({ mutationFn: (file: File) => uploadFile(file, options) });
+}

data/templates/storage/test/controllers/uploads_test.rb.tt

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+class UploadsTest < GemStack::TestCase
+<% if auth? -%>
+  def setup
+    sign_in_as(User.create(email: "uploader@example.com", password: "correct horse battery staple"))
+  end
+
+<% end -%>
+  def test_direct_upload
+    post_json "/api/uploads", { filename: "cat.png", content_type: "image/png", byte_size: 4 }
+
+    assert_status 201
+    signed_id = json_body["signed_id"]
+    put json_body["url"], "\x89PNG", "CONTENT_TYPE" => "image/png"
+
+    assert_status 201
+    key = GemStack::Storage.key_for_signed_id(signed_id)
+    assert_equal "\x89PNG".b, GemStack::Storage.download(key).b
+  end
+
+  def test_refuses_other_types
+    post_json "/api/uploads", { filename: "page.html", content_type: "text/html", byte_size: 10 }
+
+    assert_error 422, "validation_failed"
+    assert json_body["errors"]["content_type"]
+  end
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: gemstack-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Shoaib Malik
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gemstack-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: gemstack-dev
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+email:
+- gemstack26@gmail.com
+executables:
+- gemstack
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/gemstack
+- lib/gemstack/cli.rb
+- lib/gemstack/cli/add_generator.rb
+- lib/gemstack/cli/app_generator.rb
+- lib/gemstack/cli/commands/db.rb
+- lib/gemstack/cli/commands/jobs.rb
+- lib/gemstack/cli/controller_generator.rb
+- lib/gemstack/cli/deploy_generator.rb
+- lib/gemstack/cli/doctor.rb
+- lib/gemstack/cli/generator.rb
+- lib/gemstack/cli/job_generator.rb
+- lib/gemstack/cli/migration_generator.rb
+- lib/gemstack/cli/policy_generator.rb
+- lib/gemstack/cli/project.rb
+- lib/gemstack/cli/resource_generator.rb
+- lib/gemstack/cli/resource_spec.rb
+- templates/app/Gemfile.tt
+- templates/app/README.md.tt
+- templates/app/app/controllers/application_controller.rb
+- templates/app/bin/gemstack
+- templates/app/config.ru
+- templates/app/config/app.rb.tt
+- templates/app/config/environments/development.rb
+- templates/app/config/environments/production.rb
+- templates/app/config/environments/test.rb
+- templates/app/config/puma.rb
+- templates/app/config/routes.rb
+- templates/app/db/migrations/dot_keep
+- templates/app/db/seeds.rb
+- templates/app/dot_env.example
+- templates/app/dot_gitignore
+- templates/app/dot_ruby-version.tt
+- templates/app/dot_tool-versions.tt
+- templates/app/test/health_test.rb
+- templates/app/test/test_helper.rb.tt
+- templates/auth/app/controllers/api_tokens_controller.rb
+- templates/auth/app/controllers/email_verifications_controller.rb
+- templates/auth/app/controllers/password_resets_controller.rb
+- templates/auth/app/controllers/registrations_controller.rb
+- templates/auth/app/controllers/sessions_controller.rb
+- templates/auth/app/mailers/auth_mailer.rb
+- templates/auth/app/mailers/templates/auth_mailer/email_verification.html.erb
+- templates/auth/app/mailers/templates/auth_mailer/email_verification.text.erb
+- templates/auth/app/mailers/templates/auth_mailer/password_reset.html.erb
+- templates/auth/app/mailers/templates/auth_mailer/password_reset.text.erb
+- templates/auth/app/models/auth_token.rb
+- templates/auth/app/models/user.rb
+- templates/auth/app/policies/application_policy.rb
+- templates/auth/app/serializers/api_token_serializer.rb
+- templates/auth/app/serializers/new_api_token_serializer.rb
+- templates/auth/app/serializers/user_serializer.rb
+- templates/auth/db/migrations/%timestamp%_create_auth_tables.rb
+- templates/auth/frontend/app/account/page.tsx
+- templates/auth/frontend/app/forgot-password/page.tsx
+- templates/auth/frontend/app/login/page.tsx
+- templates/auth/frontend/app/reset-password/page.tsx
+- templates/auth/frontend/app/signup/page.tsx
+- templates/auth/frontend/app/verify-email/page.tsx
+- templates/auth/frontend/components/auth/CredentialsForm.tsx
+- templates/auth/frontend/components/auth/ResetPasswordForm.tsx
+- templates/auth/frontend/components/auth/VerifyEmail.tsx
+- templates/auth/frontend/lib/auth.ts
+- templates/auth/test/controllers/auth_test.rb
+- templates/controller/app/controllers/%file_name%_controller.rb.tt
+- templates/controller/test/controllers/%file_name%_controller_test.rb.tt
+- templates/deploy/Caddyfile.tt
+- templates/deploy/Dockerfile.tt
+- templates/deploy/Procfile.tt
+- templates/deploy/compose.yaml.tt
+- templates/deploy/dot_dockerignore
+- templates/frontend/app/globals.css
+- templates/frontend/app/layout.tsx.tt
+- templates/frontend/app/page.tsx.tt
+- templates/frontend/app/providers.tsx
+- templates/frontend/lib/gemstack/client.ts
+- templates/frontend/next-env.d.ts
+- templates/frontend/next.config.ts
+- templates/frontend/package.json.tt
+- templates/frontend/tsconfig.json
+- templates/job/app/jobs/%file_name%.rb.tt
+- templates/job/test/jobs/%file_name%_test.rb.tt
+- templates/migration/db/migrations/%timestamp%_%file_name%.rb.tt
+- templates/policy/app/policies/%file_name%_policy.rb.tt
+- templates/policy/test/policies/%file_name%_policy_test.rb.tt
+- templates/realtime/config/channels.rb
+- templates/realtime/frontend/lib/gemstack/realtime.ts
+- templates/resource/controller/app/controllers/%plural%_controller.rb.tt
+- templates/resource/controller/test/controllers/%plural%_controller_test.rb.tt
+- templates/resource/frontend/frontend/app/%url_segment%/[id]/edit/page.tsx.tt
+- templates/resource/frontend/frontend/app/%url_segment%/[id]/page.tsx.tt
+- templates/resource/frontend/frontend/app/%url_segment%/new/page.tsx.tt
+- templates/resource/frontend/frontend/app/%url_segment%/page.tsx.tt
+- templates/resource/frontend/frontend/components/%url_segment%/%class_name%Card.tsx.tt
+- templates/resource/frontend/frontend/components/%url_segment%/%class_name%Form.tsx.tt
+- templates/resource/frontend/frontend/components/%url_segment%/%class_name%Table.tsx.tt
+- templates/resource/frontend/frontend/lib/format.ts
+- templates/resource/frontend/frontend/lib/queries/%url_segment%.ts.tt
+- templates/resource/migration/db/migrations/%timestamp%_create_%table%.rb.tt
+- templates/resource/model/app/models/%file_name%.rb.tt
+- templates/resource/model/test/models/%file_name%_test.rb.tt
+- templates/resource/serializer/app/serializers/%file_name%_serializer.rb.tt
+- templates/storage/app/controllers/uploads_controller.rb.tt
+- templates/storage/app/serializers/upload_serializer.rb
+- templates/storage/frontend/lib/upload.ts
+- templates/storage/test/controllers/uploads_test.rb.tt
+homepage: https://github.com/gemstack-rb/gemstack
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/gemstack-rb/gemstack/tree/main/gems/gemstack-cli
+  changelog_uri: https://github.com/gemstack-rb/gemstack/blob/main/gems/gemstack-cli/CHANGELOG.md
+  bug_tracker_uri: https://github.com/gemstack-rb/gemstack/issues
+  documentation_uri: https://github.com/gemstack-rb/gemstack/tree/main/docs
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: GemStack command-line interface and generators
+test_files: []